@skrr-ai/cli 0.1.92 → 0.1.94

package/dist/commands/agents/roles/preview.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base-command';
+export default class RolesPreview extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        bindings: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: 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/roles/preview.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const node_fs_1 = require("node:fs");
+const base_command_1 = require("../../../base-command");
+const roles_1 = require("../../../lib/roles");
+class RolesPreview extends base_command_1.BaseCommand {
+    static description = 'Validate a portable role spec and preview its Compass, responsibilities, scope, budgets and requirements';
+    static args = {
+        id: core_1.Args.string({ required: true, description: 'Agent ID', ignoreStdin: true }),
+    };
+    static flags = {
+        file: core_1.Flags.string({ required: true, description: 'Role operating spec JSON file' }),
+        bindings: core_1.Flags.string({ description: 'JSON context slot → accessible target ID map' }),
+        output: core_1.Flags.string({ description: 'Save the server preview for review and installation' }),
+        json: core_1.Flags.boolean({ description: 'Output the complete preview as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(RolesPreview);
+        try {
+            const result = await roles_1.roleApi.preview(args.id, (0, roles_1.readRoleJson)(flags.file), flags.bindings ? (0, roles_1.readRoleJson)(flags.bindings) : {});
+            if (flags.output)
+                (0, node_fs_1.writeFileSync)(flags.output, `${JSON.stringify(result, null, 2)}\n`, { mode: 0o600 });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`${result.spec.title} — revision ${result.spec.revision}`);
+            this.log(`Compass ${result.compass.id}: archived; expected version ${result.expectedCompassVersion}`);
+            for (const change of result.changes)
+                this.log(`  ${change.title}: ${change.change}`);
+            for (const removed of result.removedResponsibilities)
+                this.log(`  ${removed.key}: pause removed responsibility`);
+            for (const ctx of result.contexts)
+                this.log(`  context ${ctx.label}: ${ctx.status}${ctx.title ? ` (${ctx.title})` : ''}`);
+            for (const requirement of result.pending.skills)
+                this.log(`  skill requirement: ${requirement.id}@${requirement.version}`);
+            for (const warning of result.warnings)
+                this.log(warning);
+            if (flags.output)
+                this.log(`Reviewed preview saved to ${flags.output}. Install with agents roles install ${args.id} --preview ${flags.output}.`);
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = RolesPreview;

package/dist/commands/agents/roles/withdraw.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class RolesWithdraw extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        key: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'expected-version': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/roles/withdraw.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const roles_1 = require("../../../lib/roles");
+class RolesWithdraw extends base_command_1.BaseCommand {
+    static description = 'Pause installed responsibilities and archive their Compass, preserving work and history';
+    static args = {
+        id: core_1.Args.string({ required: true, description: 'Agent ID', ignoreStdin: true }),
+        key: core_1.Args.string({ required: true, description: 'Role key', ignoreStdin: true }),
+    };
+    static flags = {
+        'expected-version': core_1.Flags.integer({
+            required: true,
+            description: 'Compass version from agents roles list',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(RolesWithdraw);
+        try {
+            const receipt = await roles_1.roleApi.withdraw(args.id, args.key, flags['expected-version']);
+            this.log(flags.json
+                ? JSON.stringify(receipt, null, 2)
+                : receipt.complete
+                    ? 'Role paused; Compass archived. Existing work and memory retained.'
+                    : 'Role partially paused. Refresh and retry to reconcile remaining responsibilities.');
+            if (!receipt.complete)
+                this.failWithCliError({
+                    code: 'ROLE_WITHDRAW_INCOMPLETE',
+                    message: 'Withdrawal is incomplete; inspect and retry.',
+                    retryable: true,
+                    exit: 1,
+                    details: receipt,
+                });
+        }
+        catch (error) {
+            this.handleApiError(error);
+        }
+    }
+}
+exports.default = RolesWithdraw;

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

@@ -0,0 +1,27 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr agents share <agent>` — the public, attributed link to a Store agent.
+ *
+ * Not `agent-shares`: that grants a NAMED person access to a private agent. A
+ * link is an address, not a permission (agent-distribution-2026-10-08,
+ * principle 1), so this works only for an agent with a public listing, and
+ * says what to do instead for one without.
+ *
+ * The printed URL carries the sharer's opaque code (`?s=`) and the channel
+ * (`?ch=`), so the publisher's analytics can say "this link drove N installs"
+ * without the link ever naming the sharer. Minting is idempotent: sharing the
+ * same agent the same way twice prints the same link.
+ */
+export default class AgentsShare extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agent: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        channel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        qr: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/share.js

@@ -0,0 +1,100 @@
+"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_ref_1 = require("../../lib/agent-ref");
+const agent_distribution_1 = require("../../lib/agent-distribution");
+const terminal_qr_1 = require("../../lib/terminal-qr");
+/** The channels a person sharing from a terminal can mean. */
+const SHARE_CHANNELS = ['link', 'qr', 'cli'];
+/**
+ * `skrr agents share <agent>` — the public, attributed link to a Store agent.
+ *
+ * Not `agent-shares`: that grants a NAMED person access to a private agent. A
+ * link is an address, not a permission (agent-distribution-2026-10-08,
+ * principle 1), so this works only for an agent with a public listing, and
+ * says what to do instead for one without.
+ *
+ * The printed URL carries the sharer's opaque code (`?s=`) and the channel
+ * (`?ch=`), so the publisher's analytics can say "this link drove N installs"
+ * without the link ever naming the sharer. Minting is idempotent: sharing the
+ * same agent the same way twice prints the same link.
+ */
+class AgentsShare extends base_command_1.BaseCommand {
+    static description = `Print a public, attributed link to a published agent — and a QR code a phone can scan (--qr). ` +
+        `For a private agent, use \`agent-shares create\`.`;
+    static examples = [
+        '<%= config.bin %> agents share agent_abc123',
+        '<%= config.bin %> agents share agent_abc123 --qr',
+        '<%= config.bin %> agents share https://skrr.ai/a/agent_abc123 --channel link',
+        '<%= config.bin %> agents share agent_abc123 --json',
+    ];
+    static args = {
+        agent: core_1.Args.string({
+            description: 'The published agent: its id or a link to it',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        channel: core_1.Flags.string({
+            description: 'How you are sharing it, recorded on the link for analytics. Defaults to cli, or qr with --qr',
+            options: [...SHARE_CHANNELS],
+        }),
+        qr: core_1.Flags.boolean({
+            description: 'Also draw a QR code (only in an interactive terminal without NO_COLOR; the URL is always printed)',
+        }),
+        json: core_1.Flags.boolean({ description: 'Print {agentId, channel, code, url} as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsShare);
+        const baseURL = this.cliConfig.baseURL;
+        let agentId;
+        try {
+            ({ agentId } = await (0, agent_ref_1.resolveAgentRef)(args.agent, { baseURL }));
+        }
+        catch (err) {
+            if (err instanceof agent_ref_1.AgentRefError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            this.handleApiError(err);
+        }
+        // Attribution is the SHARER's channel — the one this share is made through,
+        // never the channel of a link that was passed in to name the agent.
+        const channel = (flags.channel ?? (flags.qr ? 'qr' : 'cli'));
+        let link;
+        try {
+            link = await (0, agent_distribution_1.mintAgentShareLink)({ baseURL, agentId, channel });
+        }
+        catch (err) {
+            if (err instanceof agent_distribution_1.AgentNotShareableError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            this.handleApiError(err, { subject: `agent ${agentId}` });
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(link, null, 2));
+            return;
+        }
+        if (flags.qr) {
+            const decision = (0, terminal_qr_1.qrRenderDecision)(link.url);
+            if (decision.render) {
+                for (const line of (0, terminal_qr_1.renderQr)(link.url))
+                    this.log(line);
+                this.log('');
+            }
+            else {
+                // The URL below is the share either way; say why the code is missing
+                // on stderr so a pipe still receives exactly one line.
+                this.logToStderr(`No QR code: ${decision.reason}. Share the link instead.`);
+            }
+        }
+        this.log(link.url);
+        if (process.stdout.isTTY) {
+            this.logToStderr(`Anyone with this link can open the listing on ${data_provider_1.BRAND.displayName}; installs through it are attributed to it.`);
+        }
+    }
+}
+exports.default = AgentsShare;

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

@@ -0,0 +1,21 @@
+import type { AgentVanityView } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../base-command';
+/** The human rendering of a vanity view; exported for the spec. */
+export declare function renderAgentVanity(view: AgentVanityView, origin: string, log: (line: string) => void): void;
+/**
+ * `skrr agents vanity <agent>` — the agent's alias in your publisher namespace,
+ * `/@<handle>/<slug>`, which 301s to its canonical `/a/<id>` listing
+ * (agent-distribution-2026-10-08.md, "Vanity URLs").
+ */
+export default class AgentsVanity extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        slug: 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/vanity.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentVanity = renderAgentVanity;
+const core_1 = require("@oclif/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");
+const visibility_1 = require("./visibility");
+/** The human rendering of a vanity view; exported for the spec. */
+function renderAgentVanity(view, origin, log) {
+    if (view.path) {
+        log(`Vanity address: ${origin}${view.path}`);
+    }
+    else if (view.slug) {
+        log(`Slug: ${view.slug}`);
+        log('It starts resolving at /@<handle>/' + view.slug + ' once you claim a publisher handle.');
+    }
+    else {
+        log('No vanity address yet.');
+        if (view.suggestedSlug) {
+            log(`Publishing (or --slug) would claim: ${view.suggestedSlug}`);
+        }
+    }
+    if (view.retiredSlugs.length > 0) {
+        log(`Retired slugs (still resolve to this agent): ${view.retiredSlugs.join(', ')}`);
+    }
+}
+/**
+ * `skrr agents vanity <agent>` — the agent's alias in your publisher namespace,
+ * `/@<handle>/<slug>`, which 301s to its canonical `/a/<id>` listing
+ * (agent-distribution-2026-10-08.md, "Vanity URLs").
+ */
+class AgentsVanity extends base_command_1.BaseCommand {
+    static description = "Show or change an agent's vanity address (/@<handle>/<slug>). A replaced slug keeps resolving to the same agent.";
+    static examples = [
+        '<%= config.bin %> agents vanity <agent-id>',
+        '<%= config.bin %> agents vanity <agent-id> --slug trip-planner',
+        '<%= config.bin %> agents vanity <agent-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Agent ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        slug: core_1.Flags.string({
+            description: 'Change the slug of a listed agent. Typed text is canonicalised (My Agent → my-agent); the old slug is retired and keeps working.',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsVanity);
+        let slug;
+        if (flags.slug !== undefined) {
+            const check = (0, data_provider_1.checkAgentSlug)(flags.slug);
+            if (!check.ok)
+                this.error((0, visibility_1.describeSlugRefusal)(flags.slug, check), { exit: 1 });
+            slug = check.slug;
+        }
+        let view;
+        try {
+            view =
+                slug !== undefined
+                    ? await data_provider_1.dataService.updateAgentVanity(args.id, { slug })
+                    : await data_provider_1.dataService.getAgentVanity(args.id);
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: 'agent' });
+            return;
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(view, null, 2));
+            return;
+        }
+        renderAgentVanity(view, (0, web_url_1.webOrigin)(this.cliConfig.baseURL), (line) => this.log(line));
+    }
+}
+exports.default = AgentsVanity;

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

@@ -1,4 +1,4 @@
-import type { StoreReleaseLicense } from '@skrr-ai/data-provider';
+import type { AgentSlugCheck, StoreReleaseLicense } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../base-command';
 /**
  * `--capability-rationale <permission-key>=<note>` → the publisher notes a
@@ -29,6 +29,24 @@ export declare function buildReleaseLicense(licenseId: string | undefined, remix
     license?: StoreReleaseLicense;
     error?: string;
 };
+/**
+ * `--trial-brief <text|@file>` → the brief the server records on the release
+ * (`agents/trialBrief.ts`). A value starting with `@` names a file to read;
+ * `@@…` is the escape for a brief that itself begins with `@`. Validated with
+ * the server's own normalizer so an over-long brief is refused here, before a
+ * request, with the same limit.
+ */
+export declare function resolveTrialBrief(value: string | undefined, readFile?: (path: string) => string): {
+    trialBrief?: string;
+    error?: string;
+};
+/**
+ * Whether a release published with these terms keeps its instructions from
+ * the public — the case where, without a brief, its listing has no trial.
+ */
+export declare function releaseIsSealed(price: number | undefined, sourceVisibility?: string): boolean;
+/** One sentence for a slug the shared check refused, naming the canonical form. */
+export declare function describeSlugRefusal(input: string, check: AgentSlugCheck): string;
 export default class AgentsVisibility extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -49,6 +67,8 @@ export default class AgentsVisibility extends BaseCommand {
         dependency: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         license: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         remix: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        slug: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'trial-brief': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'source-visibility': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/agents/visibility.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCapabilityRationales = parseCapabilityRationales;
 exports.parseReleaseDependencies = parseReleaseDependencies;
 exports.buildReleaseLicense = buildReleaseLicense;
+exports.resolveTrialBrief = resolveTrialBrief;
+exports.releaseIsSealed = releaseIsSealed;
+exports.describeSlugRefusal = describeSlugRefusal;
+const node_fs_1 = require("node:fs");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -68,6 +72,66 @@ function buildReleaseLicense(licenseId, remix) {
         },
     };
 }
+/**
+ * `--trial-brief <text|@file>` → the brief the server records on the release
+ * (`agents/trialBrief.ts`). A value starting with `@` names a file to read;
+ * `@@…` is the escape for a brief that itself begins with `@`. Validated with
+ * the server's own normalizer so an over-long brief is refused here, before a
+ * request, with the same limit.
+ */
+function resolveTrialBrief(value, readFile = (path) => (0, node_fs_1.readFileSync)(path, 'utf8')) {
+    if (value === undefined)
+        return {};
+    let text = value;
+    if (value.startsWith('@@')) {
+        text = value.slice(1);
+    }
+    else if (value.startsWith('@')) {
+        const path = value.slice(1);
+        if (!path)
+            return { error: '--trial-brief @<file> needs a file path after the @.' };
+        try {
+            text = readFile(path);
+        }
+        catch (err) {
+            return { error: `--trial-brief could not read ${path}: ${err.message}` };
+        }
+    }
+    const normalized = (0, data_provider_1.normalizeTrialBrief)(text);
+    if (!normalized.ok) {
+        return {
+            error: normalized.reason === 'too_long'
+                ? `--trial-brief is at most ${normalized.maxChars} characters.`
+                : '--trial-brief must be text.',
+        };
+    }
+    // Blank is sent as blank: an explicit "no brief" on this release.
+    return { trialBrief: normalized.brief ?? '' };
+}
+/**
+ * Whether a release published with these terms keeps its instructions from
+ * the public — the case where, without a brief, its listing has no trial.
+ */
+function releaseIsSealed(price, sourceVisibility) {
+    if (sourceVisibility === 'public')
+        return false;
+    if (sourceVisibility === 'sealed' || sourceVisibility === 'licensed')
+        return true;
+    return (price ?? 0) > 0;
+}
+const SLUG_REFUSALS = {
+    empty: 'needs at least two letters or digits (a-z, 0-9)',
+    too_short: 'needs at least two letters or digits (a-z, 0-9)',
+    too_long: 'is at most 60 characters of a-z, 0-9 and hyphens',
+    reserved: 'is reserved; pick another',
+};
+/** One sentence for a slug the shared check refused, naming the canonical form. */
+function describeSlugRefusal(input, check) {
+    if (check.ok)
+        return '';
+    const shown = check.slug && check.slug !== input ? ` (as "${check.slug}")` : '';
+    return `--slug "${input}"${shown} ${SLUG_REFUSALS[check.reason] ?? 'is not a valid slug'}.`;
+}
 class AgentsVisibility extends base_command_1.BaseCommand {
     static description = 'Set the visibility of an agent';
     static examples = [
@@ -79,6 +143,8 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         '<%= config.bin %> agents visibility <agent-id> --public --dependency skill:<skill-id>@<store-release-id>',
         '<%= config.bin %> agents visibility <agent-id> --public --license mit --remix attributed --source-visibility public',
         '<%= config.bin %> agents visibility <agent-id> --public --license proprietary --source-visibility sealed',
+        '<%= config.bin %> agents visibility <agent-id> --public --slug trip-planner',
+        '<%= config.bin %> agents visibility <agent-id> --public --price 5000000 --trial-brief @trial-brief.md',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Agent ID', required: true, ignoreStdin: true }),
@@ -126,6 +192,18 @@ class AgentsVisibility extends base_command_1.BaseCommand {
             description: "Whether a buyer's installed copy may be published as a derived listing: attributed (the fork credits this release) or none. Needs --license; defaults to none",
             options: [...data_provider_1.STORE_RELEASE_REMIX_GRANTS],
         }),
+        slug: core_1.Flags.string({
+            description: "The agent's address in your publisher namespace, /@<handle>/<slug> (an alias of /a/<id>). " +
+                'Typed text is canonicalised (My Agent → my-agent). Omit to keep the current slug, or to claim ' +
+                'one from the name on a first publish. A replaced slug keeps working for this agent.',
+        }),
+        'trial-brief': core_1.Flags.string({
+            description: 'What someone trying this agent from its listing should experience, as text or @<file>. ' +
+                'A trial of a release whose instructions are private (paid, sealed or licensed) runs on this ' +
+                'brief instead, and without one that listing has no trial. People who try it can read it back, ' +
+                'so never put your private instructions here. At most 4000 characters; recorded on this ' +
+                'release only, so pass it on every publish (like --language).',
+        }),
         'source-visibility': core_1.Flags.string({
             description: "Who may read the release's source, independent of price: licensed (license holders), public (anyone who sees the listing) or sealed (you only). Omit to keep the price-derived rule",
             options: [...data_provider_1.STORE_RELEASE_SOURCE_VISIBILITIES],
@@ -171,6 +249,24 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         if ((license || sourceVisibility) && !isPublic) {
             this.error('--license, --remix and --source-visibility are terms of a public release; pass them with --public.', { exit: 1 });
         }
+        const { trialBrief, error: trialBriefError } = resolveTrialBrief(flags['trial-brief']);
+        if (trialBriefError)
+            this.error(trialBriefError, { exit: 1 });
+        if (trialBrief !== undefined && !isPublic) {
+            this.error('--trial-brief is recorded on a public release; pass it with --public.', {
+                exit: 1,
+            });
+        }
+        let slug;
+        if (flags.slug !== undefined) {
+            if (!isPublic) {
+                this.error('--slug names a public listing; pass it with --public.', { exit: 1 });
+            }
+            const check = (0, data_provider_1.checkAgentSlug)(flags.slug);
+            if (!check.ok)
+                this.error(describeSlugRefusal(flags.slug, check), { exit: 1 });
+            slug = check.slug;
+        }
         let result;
         try {
             result = await data_provider_1.dataService.setAgentVisibility({
@@ -186,6 +282,8 @@ class AgentsVisibility extends base_command_1.BaseCommand {
                 dependencies,
                 license,
                 sourceVisibility,
+                ...(trialBrief !== undefined ? { trialBrief } : {}),
+                ...(slug !== undefined ? { slug } : {}),
             });
         }
         catch (err) {
@@ -198,12 +296,26 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         const label = isPublic ? 'public' : 'private';
         this.log(`Set agent ${args.id} visibility: ${label}`);
         const recorded = result;
+        if (recorded?.vanity?.path) {
+            this.log(`Vanity address: ${recorded.vanity.path}`);
+        }
+        else if (recorded?.vanity?.slug) {
+            this.log(`Slug: ${recorded.vanity.slug} (claim a publisher handle for /@<handle>/${recorded.vanity.slug} to resolve)`);
+        }
         if (recorded?.license) {
             this.log(`License: ${recorded.license.id} (remix: ${recorded.license.remix})`);
         }
         if (recorded?.sourceVisibility) {
             this.log(`Source visibility: ${recorded.sourceVisibility}`);
         }
+        if (isPublic && recorded) {
+            if (recorded.trialBrief) {
+                this.log(`Trial brief: recorded (${recorded.trialBrief.length} characters)`);
+            }
+            else if (releaseIsSealed(recorded.price, recorded.sourceVisibility)) {
+                this.log('Trial: none. This release keeps its instructions private and has no trial brief, so its listing cannot be tried. Pass --trial-brief to add one.');
+            }
+        }
     }
 }
 exports.default = AgentsVisibility;

package/dist/commands/commands.d.ts

@@ -9,6 +9,7 @@ export default class Commands extends BaseCommand {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         search: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         schema: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        brief: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         audit: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/commands.js

@@ -9,6 +9,7 @@ class Commands extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> commands',
         '<%= config.bin %> commands --json',
+        '<%= config.bin %> commands --json --brief',
         '<%= config.bin %> commands --search agent --json',
         '<%= config.bin %> commands --search "publish release"',
         '<%= config.bin %> commands --schema "agent message send"',
@@ -28,6 +29,10 @@ class Commands extends base_command_1.BaseCommand {
             description: 'Filter commands by name, description, or examples',
         }),
         schema: core_1.Flags.boolean({ description: 'Return one command schema instead of the full list' }),
+        brief: core_1.Flags.boolean({
+            description: 'With --json: id, command and one-line description only (about 14x smaller than the full list). Use --schema "<command>" for one command\'s flags.',
+            exclusive: ['schema', 'audit'],
+        }),
         audit: core_1.Flags.boolean({
             description: 'Run command hygiene checks for agent-friendly CLI contracts',
             exclusive: ['schema'],
@@ -101,20 +106,28 @@ class Commands extends base_command_1.BaseCommand {
         // Search is a discovery operation: keep its JSON small enough to pass
         // directly into an agent's next decision. Use --schema for full flags and
         // argument metadata for one selected command.
-        const outputEntries = query
-            ? entries.map(({ id, command, description, aliases, examples }) => ({
-                id,
-                command,
-                description,
-                aliases,
-                examples,
-            }))
-            : entries;
+        const outputEntries = flags.brief
+            ? entries.map(({ id, command, description }) => ({ id, command, description }))
+            : query
+                ? entries.map(({ id, command, description, aliases, examples }) => ({
+                    id,
+                    command,
+                    description,
+                    aliases,
+                    examples,
+                }))
+                : entries;
         const payload = {
             object: 'list',
             data: outputEntries,
             count: entries.length,
             ...(query ? { query: flags.search } : {}),
+            ...(flags.brief
+                ? {
+                    brief: true,
+                    hint: 'Run `skrr commands --schema "<command>" --json` for one command\'s flags.',
+                }
+                : {}),
         };
         if (flags.json) {
             this.log(JSON.stringify(payload, null, 2));

package/dist/commands/commitments/{autonomy-requests → cadence-requests}/decide.d.ts

@@ -1,16 +1,14 @@
 import { BaseCommand } from '../../../base-command';
 /**
- * `skrr commitments autonomy-requests decide <id> <request-id> --approve`
+ * `skrr commitments cadence-requests decide <id> <request-id> --approve`
  *
- * When an Agent proposes changing its own commitment's cadence, the server does
- * NOT apply it — it parks a durable request (`state.pendingAutonomyRequests`)
- * and waits. This is the command that answers one. Approving materializes the
- * wake through the same resolver a bypass-mode agent would have used; rejecting
- * records the no and leaves the cadence alone.
+ * The server records concrete cadence proposals requiring an owner decision.
+ * Approval changes only the check schedule; it grants no execution permissions.
+ * Rejection records the decision and leaves the schedule unchanged.
  *
  * List the pending ones with `skrr commitments show <id>`.
  */
-export default class CommitmentsAutonomyRequestsDecide extends BaseCommand {
+export default class CommitmentsCadenceRequestsDecide extends BaseCommand {
     static description: string;
     static examples: string[];
     static args: {