@skrr-ai/cli 0.1.79 → 0.1.81

package/dist/commands/store/publishers/profile/handle.js

@@ -0,0 +1,39 @@
+"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 publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Rename your public handle. The server refuses a lookalike of an existing one. */
+class StorePublishersProfileHandle extends base_command_1.BaseCommand {
+    static description = 'Rename your public publisher handle (a lookalike handle is refused)';
+    static examples = ['<%= config.bin %> store publishers profile handle acme-labs'];
+    static args = {
+        handle: core_1.Args.string({
+            description: 'The new handle (with or without @)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = { 'publish-as': publisher_profile_flags_1.publishAsFlag, json: publisher_profile_flags_1.jsonFlag };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StorePublishersProfileHandle);
+        const handle = args.handle.replace(/^@/, '');
+        try {
+            const result = await data_provider_1.dataService.renameStorePublisherProfileHandle({
+                publishAs: flags['publish-as'],
+                handle,
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`Handle is now @${handle}.`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfileHandle;

package/dist/commands/store/publishers/profile/hide.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../../base-command';
+/** Take the public profile down; published revisions stay restorable. */
+export default class StorePublishersProfileHide extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'publish-as': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        revision: 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/store/publishers/profile/hide.js

@@ -0,0 +1,39 @@
+"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 publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Take the public profile down; published revisions stay restorable. */
+class StorePublishersProfileHide extends base_command_1.BaseCommand {
+    static description = 'Hide your public publisher profile (published revisions stay restorable)';
+    static examples = ['<%= config.bin %> store publishers profile hide'];
+    static flags = {
+        'publish-as': publisher_profile_flags_1.publishAsFlag,
+        revision: core_1.Flags.integer({
+            description: 'Apply only if the profile is still at this revision (default: its current one)',
+            min: 0,
+        }),
+        json: publisher_profile_flags_1.jsonFlag,
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StorePublishersProfileHide);
+        try {
+            const publishAs = flags['publish-as'];
+            const result = await data_provider_1.dataService.hideStorePublisherProfile({
+                publishAs,
+                expectedRevision: await (0, publisher_profile_flags_1.currentRevision)(publishAs, flags.revision),
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log('Hidden. Restore a revision or publish again to make it public.');
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfileHide;

package/dist/commands/store/publishers/profile/preview.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../../base-command';
+/** Render a draft exactly as the public page would, without saving anything. */
+export default class StorePublishersProfilePreview extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'publish-as': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        file: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/publishers/profile/preview.js

@@ -0,0 +1,39 @@
+"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 publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Render a draft exactly as the public page would, without saving anything. */
+class StorePublishersProfilePreview extends base_command_1.BaseCommand {
+    static description = 'Preview a publisher profile draft as the public page would render it (writes nothing)';
+    static examples = [
+        '<%= config.bin %> store publishers profile preview --file draft.json',
+    ];
+    static flags = {
+        'publish-as': publisher_profile_flags_1.publishAsFlag,
+        file: core_1.Flags.string({ description: 'JSON file holding the draft', required: true }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StorePublishersProfilePreview);
+        let draft;
+        try {
+            draft = (0, publisher_profile_flags_1.readDraftFile)(flags.file);
+        }
+        catch (err) {
+            this.error(err.message);
+        }
+        try {
+            const result = await data_provider_1.dataService.previewStorePublisherProfile({
+                publishAs: flags['publish-as'],
+                draft,
+            });
+            this.log(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfilePreview;

package/dist/commands/store/publishers/profile/publish.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../../../base-command';
+/** Publish the current draft as a new public revision. */
+export default class StorePublishersProfilePublish extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'publish-as': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        revision: 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/store/publishers/profile/publish.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+const publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Publish the current draft as a new public revision. */
+class StorePublishersProfilePublish extends base_command_1.BaseCommand {
+    static description = 'Publish your current publisher profile draft as a new public revision';
+    static examples = ['<%= config.bin %> store publishers profile publish'];
+    static flags = {
+        'publish-as': publisher_profile_flags_1.publishAsFlag,
+        revision: core_1.Flags.integer({
+            description: 'Apply only if the profile is still at this revision (default: its current one)',
+            min: 0,
+        }),
+        json: publisher_profile_flags_1.jsonFlag,
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StorePublishersProfilePublish);
+        try {
+            const publishAs = flags['publish-as'];
+            const result = await data_provider_1.dataService.publishStorePublisherProfile({
+                publishAs,
+                expectedRevision: await (0, publisher_profile_flags_1.currentRevision)(publishAs, flags.revision),
+                idempotencyKey: (0, node_crypto_1.randomUUID)(),
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log('Published.');
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfilePublish;

package/dist/commands/store/publishers/profile/restore.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../../../base-command';
+/** Re-publish an earlier revision. Hidden revisions are not restore candidates. */
+export default class StorePublishersProfileRestore extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        revisionId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'publish-as': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        revision: 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/store/publishers/profile/restore.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+const publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Re-publish an earlier revision. Hidden revisions are not restore candidates. */
+class StorePublishersProfileRestore extends base_command_1.BaseCommand {
+    static description = 'Restore an earlier published revision of your publisher profile';
+    static examples = ['<%= config.bin %> store publishers profile restore ppr_abc123'];
+    static args = {
+        revisionId: core_1.Args.string({
+            description: 'Revision id (from `profile revisions`)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        'publish-as': publisher_profile_flags_1.publishAsFlag,
+        revision: core_1.Flags.integer({
+            description: 'Apply only if the profile is still at this revision (default: its current one)',
+            min: 0,
+        }),
+        json: publisher_profile_flags_1.jsonFlag,
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StorePublishersProfileRestore);
+        try {
+            const publishAs = flags['publish-as'];
+            const result = await data_provider_1.dataService.restoreStorePublisherProfileRevision({
+                publishAs,
+                revisionId: args.revisionId,
+                expectedRevision: await (0, publisher_profile_flags_1.currentRevision)(publishAs, flags.revision),
+                idempotencyKey: (0, node_crypto_1.randomUUID)(),
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`Restored ${args.revisionId}.`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfileRestore;

package/dist/commands/store/publishers/profile/revisions.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../../base-command';
+/** Published revisions of your publisher profile — the restore candidates. */
+export default class StorePublishersProfileRevisions extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'publish-as': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/publishers/profile/revisions.js

@@ -0,0 +1,30 @@
+"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 publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** Published revisions of your publisher profile — the restore candidates. */
+class StorePublishersProfileRevisions extends base_command_1.BaseCommand {
+    static description = 'List published revisions of your publisher profile (the restore candidates)';
+    static examples = ['<%= config.bin %> store publishers profile revisions --limit 10'];
+    static flags = {
+        'publish-as': publisher_profile_flags_1.publishAsFlag,
+        limit: core_1.Flags.integer({ description: 'How many revisions to return', min: 1 }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StorePublishersProfileRevisions);
+        try {
+            const result = await data_provider_1.dataService.getStorePublisherProfileRevisions({
+                publishAs: flags['publish-as'],
+                limit: flags.limit,
+            });
+            this.log(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfileRevisions;

package/dist/commands/store/publishers/profile/show.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../../base-command';
+/** The private publisher-profile console: draft, visibility and CAS revision. */
+export default class StorePublishersProfileShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'publish-as': 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/store/publishers/profile/show.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+const publisher_profile_flags_1 = require("../../../../lib/publisher-profile-flags");
+/** The private publisher-profile console: draft, visibility and CAS revision. */
+class StorePublishersProfileShow extends base_command_1.BaseCommand {
+    static description = 'Show your publisher profile console — draft, visibility and the revision a write must name';
+    static examples = [
+        '<%= config.bin %> store publishers profile show',
+        '<%= config.bin %> store publishers profile show --publish-as ws_123 --json > draft.json',
+    ];
+    static flags = { 'publish-as': publisher_profile_flags_1.publishAsFlag, json: publisher_profile_flags_1.jsonFlag };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StorePublishersProfileShow);
+        try {
+            const result = await data_provider_1.dataService.getStorePublisherProfileEditor(flags['publish-as']);
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const { profile } = result;
+            this.log(`Profile:    ${profile.profileId} (${profile.publisher.type} ${profile.publisher.id})`);
+            this.log(`Visibility: ${profile.visibility}`);
+            this.log(`Revision:   ${profile.revision}`);
+            this.log(`Published:  ${profile.publishedRevision
+                ? `#${profile.publishedRevision.number} at ${profile.publishedRevision.publishedAt}`
+                : 'never'}`);
+            this.log(`Name:       ${profile.draft.displayName ?? '(unset)'}`);
+            if (profile.draft.headline)
+                this.log(`Headline:   ${profile.draft.headline}`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StorePublishersProfileShow;

package/dist/commands/store/review.d.ts

@@ -0,0 +1,26 @@
+import type { StoreAgentRatedRelease } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../base-command';
+/** `1.2 (release 3)`, or the honest "unknown release" for a pre-release install. */
+export declare function describeRatedRelease(release: StoreAgentRatedRelease | null | undefined): string;
+/**
+ * Rate a Store agent you installed, optionally with a written review.
+ *
+ * The release the rating is recorded against is NOT a flag: the server stamps
+ * it from your own install, so a review cannot claim a version its author
+ * never ran. Rating again replaces your earlier rating; omitting --text keeps
+ * the review text you already wrote, and --clear-text removes it.
+ */
+export default class StoreReview extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        rating: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        text: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'clear-text': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/review.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeRatedRelease = describeRatedRelease;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+/** `1.2 (release 3)`, or the honest "unknown release" for a pre-release install. */
+function describeRatedRelease(release) {
+    if (!release)
+        return 'an unknown release';
+    const label = release.versionLabel ? `v${release.versionLabel}` : release.id;
+    return release.releaseNumber != null ? `${label} (release ${release.releaseNumber})` : label;
+}
+/**
+ * Rate a Store agent you installed, optionally with a written review.
+ *
+ * The release the rating is recorded against is NOT a flag: the server stamps
+ * it from your own install, so a review cannot claim a version its author
+ * never ran. Rating again replaces your earlier rating; omitting --text keeps
+ * the review text you already wrote, and --clear-text removes it.
+ */
+class StoreReview extends base_command_1.BaseCommand {
+    static description = 'Rate a Store agent you installed (1-5 stars), optionally with a written review';
+    static examples = [
+        '<%= config.bin %> store review agent_abc --rating 5',
+        '<%= config.bin %> store review agent_abc --rating 4 --text "Great at triage, slow on long threads"',
+        '<%= config.bin %> store review agent_abc --rating 4 --clear-text',
+        '<%= config.bin %> store reviews agent_abc --mine',
+    ];
+    static args = {
+        agentId: core_1.Args.string({
+            description: 'The Store agent to rate',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        rating: core_1.Flags.integer({
+            description: `Star rating, ${data_provider_1.STORE_AGENT_RATING_MIN}-${data_provider_1.STORE_AGENT_RATING_MAX}`,
+            required: true,
+            min: data_provider_1.STORE_AGENT_RATING_MIN,
+            max: data_provider_1.STORE_AGENT_RATING_MAX,
+        }),
+        text: core_1.Flags.string({
+            description: `Written review (at most ${data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH} characters). Omit to keep your existing review text`,
+            exclusive: ['clear-text'],
+        }),
+        'clear-text': core_1.Flags.boolean({
+            description: 'Remove your written review and keep only the star rating',
+            exclusive: ['text'],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreReview);
+        let review;
+        if (flags['clear-text']) {
+            review = '';
+        }
+        else if (flags.text !== undefined) {
+            review = flags.text.trim();
+            if (!review) {
+                this.error('--text is empty. Pass review text, or --clear-text to remove your review.', {
+                    exit: 2,
+                });
+            }
+            if (review.length > data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH) {
+                this.error(`--text is ${review.length} characters; a review holds at most ${data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH}.`, { exit: 2 });
+            }
+        }
+        try {
+            const result = await data_provider_1.dataService.rateAgent({
+                agentId: args.agentId,
+                rating: flags.rating,
+                ...(review !== undefined ? { review } : {}),
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`Rated ${args.agentId} ${result.userRating}/${data_provider_1.STORE_AGENT_RATING_MAX} on ${describeRatedRelease(result.ratedRelease)}.`);
+            this.log(result.userReview
+                ? `Review: ${result.userReview}`
+                : 'No written review (star rating only).');
+            this.log(`Listing now averages ${Number(result.rating).toFixed(1)} from ${result.ratingCount} rating(s).`);
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `Rating ${args.agentId}` });
+        }
+    }
+}
+exports.default = StoreReview;

package/dist/commands/store/reviews.d.ts

@@ -0,0 +1,29 @@
+import type { StoreAgentReview } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../base-command';
+/** Plain-text lines for one written review and the publisher's reply to it. */
+export declare function describeReview(review: StoreAgentReview): string[];
+/**
+ * Read a Store agent's written reviews, or your own rating of it, and — as the
+ * agent's publisher — answer a review publicly.
+ *
+ * Star-only ratings are not listed; they are anonymous contributions to the
+ * average. Only the agent's author may reply, and the server decides that
+ * (`viewerIsPublisher`), not this command.
+ */
+export default class StoreReviews extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        mine: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        reply: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        body: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'remove-reply': 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>;
+}