@skrr-ai/cli 0.1.91 → 0.1.93

package/dist/commands/agents/create.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FROM_SPEC_COMPATIBLE_FLAGS = void 0;
 exports.agentCreateMissingFieldsMessage = agentCreateMissingFieldsMessage;
 exports.agentCreateMissingFields = agentCreateMissingFields;
 exports.unappliedPayloadKeys = unappliedPayloadKeys;
@@ -15,6 +16,7 @@ const execution_target_1 = require("../../lib/execution-target");
 const prompt_1 = require("../../lib/prompt");
 const agent_config_1 = require("../../lib/agent-config");
 const web_url_1 = require("../../lib/web-url");
+const agent_spec_1 = require("../../lib/agent-spec");
 /**
  * OSK-4831 — build the missing-fields sentence from the real missing set.
  *
@@ -138,6 +140,23 @@ function backgroundLoopLines(agentId, relationshipLoopsSkipped) {
         '  skrr agents create --no-relationship-loops                  # a single-purpose agent next time',
     ];
 }
+/**
+ * The flags `--from-spec` may be combined with: placement and identity for the
+ * NEW row, which a spec document deliberately cannot carry (where an agent runs
+ * is not portable). Every configuration flag is refused alongside it, because
+ * the file is the source — a flag that quietly overrode a line of it would
+ * leave git and the agent disagreeing from the first push.
+ */
+exports.FROM_SPEC_COMPATIBLE_FLAGS = Object.freeze([
+    'from-spec',
+    'json',
+    'name',
+    'target',
+    'next-target',
+    'working-directory',
+    'default-permission-mode',
+    'no-relationship-loops',
+]);
 class AgentsCreate extends base_command_1.BaseCommand {
     static description = 'Create a new agent in the selected workspace, or in your default workspace when --workspace is omitted (`skrr workspaces list` names it)';
     static examples = [
@@ -147,11 +166,19 @@ class AgentsCreate extends base_command_1.BaseCommand {
         '<%= config.bin %> agents create --from-json agent.json',
         'cat agent.json | <%= config.bin %> agents create --from-json -',
         '<%= config.bin %> agents create --from-json template.json --name "Override name"',
+        '<%= config.bin %> agents create --from-spec agents/reviewer.agent.json',
+        '<%= config.bin %> agents create --from-spec agents/reviewer.agent.json --name "Reviewer (staging)" --target hosted-machine',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output the created agent as JSON' }),
         'from-json': core_1.Flags.string({
             description: 'Path to a JSON file (or "-" for stdin) to use as the request body',
+            exclusive: ['from-spec'],
+        }),
+        'from-spec': core_1.Flags.string({
+            description: 'Create the agent from an agent-as-code spec document (`skrr agents pull` writes one; "-" for stdin). ' +
+                'Checked with the same rules as `agents push`; a refused document leaves no agent behind',
+            exclusive: ['from-json'],
         }),
         // `--title` is an alias, not a rename (OSK-4850). tasks, spaces, projects,
         // goals and `chats create` all name the thing with `--title`, so muscle
@@ -295,6 +322,10 @@ class AgentsCreate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(AgentsCreate);
+        if (flags['from-spec']) {
+            await this.createFromSpec(flags);
+            return;
+        }
         // Default to {} so TS flow-analysis is satisfied — the catch calls this.error(), which throws.
         let body = {};
         try {
@@ -447,5 +478,186 @@ class AgentsCreate extends base_command_1.BaseCommand {
         }
         this.log(`URL: ${(0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, a).url ?? '-'}`);
     }
+    /**
+     * `agents create --from-spec <file>`: bootstrap a NEW agent from an
+     * agent-as-code document, so a repository can hold an agent before one
+     * exists (`agents push` needs an existing id).
+     *
+     * Two writes, one writer per concern. The create carries only what makes a
+     * row — its name, provider, model and placement — and every other field
+     * reaches the agent through the push endpoint, so the document is held to
+     * exactly the rules `agents push` and `agents validate` apply (portable
+     * fields only, no credentials, no withheld references, nothing push may not
+     * set). Validation runs first with no network. If the server then refuses
+     * the document, the agent just created is deleted again: a refused spec must
+     * not leave behind a half-configured agent that looks like it worked.
+     */
+    async createFromSpec(flags) {
+        const source = String(flags['from-spec']);
+        const incompatible = Object.keys(flags)
+            // This command's own flags only: the global ones (--profile, --workspace,
+            // --token, --bare) choose WHO creates, not what is created.
+            .filter((flag) => Object.prototype.hasOwnProperty.call(AgentsCreate.flags, flag))
+            .filter((flag) => flags[flag] !== undefined && flags[flag] !== false)
+            .filter((flag) => !exports.FROM_SPEC_COMPATIBLE_FLAGS.includes(flag));
+        if (incompatible.length > 0) {
+            this.failWithCliError({
+                message: `--from-spec takes the agent's configuration from ${source}; ` +
+                    `${incompatible.map((flag) => `--${flag}`).join(', ')} cannot be combined with it. ` +
+                    'Edit the file instead (placement flags --target, --next-target, --working-directory, ' +
+                    '--default-permission-mode, and --name, are accepted).',
+                code: 'AGENT_SPEC_FLAG_CONFLICT',
+                exit: 1,
+                retryable: false,
+                details: { incompatible },
+            });
+        }
+        let raw;
+        try {
+            raw = await (0, agent_spec_1.readSpecSource)(source);
+        }
+        catch (err) {
+            this.failWithCliError({
+                message: `Could not read ${source}: ${err.message}`,
+                code: 'AGENT_SPEC_READ_FAILED',
+                exit: 1,
+                retryable: true,
+                details: { path: source },
+            });
+        }
+        const parsed = (0, agent_spec_1.parseAndValidateAgentSpec)(raw, source);
+        if (!parsed.ok) {
+            this.failWithCliError({
+                message: parsed.message,
+                code: 'AGENT_SPEC_NOT_JSON',
+                exit: 1,
+                retryable: false,
+            });
+        }
+        if (!parsed.validation.ok) {
+            this.failWithCliError({
+                message: (0, agent_spec_1.issueBlock)(`Refused before sending: ${source} carries fields that may not travel. No agent was created.`, parsed.validation.issues),
+                code: 'AGENT_SPEC_INVALID',
+                exit: 1,
+                retryable: false,
+                details: { issues: parsed.validation.issues },
+            });
+        }
+        const document = parsed.validation.document;
+        const spec = { ...document.spec };
+        // `--name` renames the copy (a staging twin of a committed agent). It is
+        // written into the document too, or the push would rename it straight back.
+        if (typeof flags.name === 'string' && flags.name.trim())
+            spec.name = flags.name.trim();
+        const name = typeof spec.name === 'string' ? spec.name.trim() : '';
+        if (!name) {
+            this.failWithCliError({
+                message: `${source} has no "name" under "spec". Add one, or pass --name.`,
+                code: 'AGENT_CREATE_MISSING_FIELDS',
+                exit: 1,
+                retryable: false,
+                details: { missing: ['--name'] },
+            });
+        }
+        // Placement is never in a spec (it is not portable), so it defaults here
+        // exactly as a named create does, and the defaults are said out loud.
+        const appliedDefaults = [];
+        const provider = typeof spec.provider === 'string' && spec.provider ? spec.provider : 'agentic';
+        if (provider !== spec.provider)
+            appliedDefaults.push('provider=agentic');
+        const model = typeof spec.model === 'string' && spec.model ? spec.model : 'default';
+        if (model !== spec.model)
+            appliedDefaults.push('model=default');
+        let target = typeof flags.target === 'string' ? flags.target : undefined;
+        const nextTargets = flags['next-target'] ?? [];
+        if (!target) {
+            if (nextTargets.length > 0) {
+                this.error('--next-target requires --target.', { exit: 1 });
+            }
+            target = 'agent-worker';
+            appliedDefaults.push('target=agent-worker');
+        }
+        let executionPolicy;
+        try {
+            executionPolicy = (0, execution_target_1.buildExecutionOrderPatch)({
+                selectors: [target, ...nextTargets],
+            }).executionPolicy;
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        const payload = (0, prompt_1.mergeDefined)({}, {
+            name,
+            provider,
+            model,
+            executionPolicy,
+            workingDirectory: flags['working-directory'],
+            defaultPermissionMode: flags['default-permission-mode'],
+            relationshipLoops: flags['no-relationship-loops'] ? false : undefined,
+        });
+        let created;
+        try {
+            created = (await data_provider_1.dataService.createAgent(payload));
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const agentId = String(created.id ?? created._id ?? '');
+        let pushed;
+        try {
+            pushed = await data_provider_1.dataService.pushAgentSpec(agentId, { ...document, spec });
+        }
+        catch (err) {
+            // Undo the create first, then report — whichever way the undo went.
+            let rollback;
+            try {
+                await data_provider_1.dataService.deleteAgent({ agent_id: agentId });
+                rollback = `The agent created for it (${agentId}) was deleted again.`;
+            }
+            catch (deleteErr) {
+                rollback =
+                    `The agent created for it (${agentId}) could NOT be deleted ` +
+                        `(${deleteErr.message}); remove it with \`skrr agents delete ${agentId}\`.`;
+            }
+            const refusal = (0, agent_spec_1.refusalIssues)(err);
+            this.failWithCliError({
+                message: refusal
+                    ? (0, agent_spec_1.issueBlock)(`The server refused ${source}. ${rollback}`, refusal.issues)
+                    : `Could not apply ${source} (${err.message}). ${rollback}`,
+                code: refusal?.code ?? 'AGENT_SPEC_REFUSED',
+                status: err.status,
+                exit: 1,
+                retryable: !refusal,
+                details: { agentId, rolledBack: !rollback.includes('NOT'), issues: refusal?.issues },
+            });
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({
+                agent: (0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, created),
+                spec: {
+                    source,
+                    applied: pushed.applied,
+                    unchanged: pushed.unchanged,
+                    derived: pushed.derived ?? [],
+                    untouched: pushed.untouched,
+                },
+                defaultsApplied: appliedDefaults,
+            }, null, 2));
+            return;
+        }
+        const fields = [...pushed.applied, ...pushed.unchanged];
+        this.log(`Created agent ${agentId} — ${name}, from ${source} (${fields.length} field(s)).`);
+        if (appliedDefaults.length > 0)
+            this.log(`Defaults applied: ${appliedDefaults.join(', ')}`);
+        const derived = pushed.derived ?? [];
+        if (derived.length > 0) {
+            this.log(`Not taken from the file, because the server derives it from other fields: ${derived.join(', ')}.`);
+        }
+        this.log(`Keep the file in step: \`skrr agents push ${agentId} --file ${source === '-' ? '<file>' : source}\`.`);
+        for (const line of backgroundLoopLines(agentId, flags['no-relationship-loops'] === true)) {
+            this.log(line);
+        }
+        this.log(`URL: ${(0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, created).url ?? '-'}`);
+    }
 }
 exports.default = AgentsCreate;

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

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr agents embed <agent>` — the snippet that puts a listing CARD for a
+ * public agent on another site (agent-distribution-2026-10-08.md, "Embed").
+ *
+ * Mints (idempotently) your share code on the `embed` channel, so installs
+ * that start from the card are attributed to you and show up under that
+ * channel in the listing's funnel. The card is a listing, not a chat.
+ */
+export default class AgentsEmbed 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/embed.js

@@ -0,0 +1,61 @@
+"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 web_url_1 = require("../../lib/web-url");
+/**
+ * `skrr agents embed <agent>` — the snippet that puts a listing CARD for a
+ * public agent on another site (agent-distribution-2026-10-08.md, "Embed").
+ *
+ * Mints (idempotently) your share code on the `embed` channel, so installs
+ * that start from the card are attributed to you and show up under that
+ * channel in the listing's funnel. The card is a listing, not a chat.
+ */
+class AgentsEmbed extends base_command_1.BaseCommand {
+    static description = "Print the HTML snippet that embeds a public agent's listing card on another site, with your embed share code";
+    static examples = [
+        '<%= config.bin %> agents embed <agent-id>',
+        '<%= config.bin %> agents embed <agent-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID of a public Store listing',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON ({ code, snippet, cardUrl })' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsEmbed);
+        let code;
+        try {
+            ({ code } = await data_provider_1.dataService.mintDistributionCode({
+                entity: { kind: 'agent', id: args.id },
+                channel: 'embed',
+            }));
+        }
+        catch (error) {
+            // A private or missing agent answers ENTITY_NOT_FOUND: only a public
+            // listing can be embedded.
+            this.handleApiError(error, { subject: 'public agent listing' });
+            return;
+        }
+        const origin = (0, web_url_1.webOrigin)(this.cliConfig.baseURL);
+        const snippet = (0, data_provider_1.buildAgentEmbedSnippet)({ origin, agentId: args.id, code });
+        const cardUrl = `${origin}${(0, data_provider_1.embedListingPath)(args.id, { code })}`;
+        if (flags.json) {
+            this.log(JSON.stringify({ code, snippet, cardUrl }, null, 2));
+            return;
+        }
+        this.log('Paste this where the card should appear:');
+        this.log('');
+        this.log(snippet);
+        this.log('');
+        this.log(`Preview: ${cardUrl}`);
+    }
+}
+exports.default = AgentsEmbed;

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>;