@skrr-ai/cli 0.1.80 → 0.1.81

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

package/dist/commands/store/reviews.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeReview = describeReview;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const review_1 = require("./review");
+const REVIEW_LIST_MAX = 50;
+function reviewerName(review) {
+    return review.reviewer?.displayName || review.reviewer?.username || 'a former user';
+}
+/** Plain-text lines for one written review and the publisher's reply to it. */
+function describeReview(review) {
+    const when = (review.reviewedAt || review.updatedAt || review.createdAt || '').slice(0, 10);
+    const lines = [
+        `${review.id}  ${review.rating}/${data_provider_1.STORE_AGENT_RATING_MAX}  ${(0, review_1.describeRatedRelease)(review.ratedRelease)}  by ${reviewerName(review)}${when ? `  ${when}` : ''}`,
+    ];
+    if (review.review)
+        lines.push(`  ${review.review}`);
+    const reply = review.publisherReply;
+    if (reply) {
+        lines.push(`  Publisher reply${reply.predatesReviewEdit ? ' (written before the review was last edited)' : ''}: ${reply.body}`);
+    }
+    return lines;
+}
+/**
+ * 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.
+ */
+class StoreReviews extends base_command_1.BaseCommand {
+    static description = "List a Store agent's written reviews, show your own rating, or reply to a review as its publisher";
+    static examples = [
+        '<%= config.bin %> store reviews agent_abc',
+        '<%= config.bin %> store reviews agent_abc --limit 20 --cursor <next-cursor>',
+        '<%= config.bin %> store reviews agent_abc --mine',
+        '<%= config.bin %> store reviews agent_abc --reply <review-id> --body "Fixed in 1.4.1, thanks"',
+        '<%= config.bin %> store reviews agent_abc --remove-reply <review-id>',
+    ];
+    static args = {
+        agentId: core_1.Args.string({
+            description: 'The Store agent (or, to reply, your own published agent)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        limit: core_1.Flags.integer({
+            description: `Reviews per page (max ${REVIEW_LIST_MAX})`,
+            min: 1,
+            max: REVIEW_LIST_MAX,
+        }),
+        cursor: core_1.Flags.string({ description: 'Continue from the cursor a previous page printed' }),
+        mine: core_1.Flags.boolean({
+            description: 'Show only your own rating and review of this agent',
+            exclusive: ['reply', 'remove-reply', 'limit', 'cursor'],
+        }),
+        reply: core_1.Flags.string({
+            description: 'Review id to answer publicly (the agent publisher only); needs --body',
+            exclusive: ['remove-reply', 'mine', 'limit', 'cursor'],
+            dependsOn: ['body'],
+        }),
+        body: core_1.Flags.string({
+            description: `Reply text (at most ${data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH} characters). Replaces any earlier reply`,
+            dependsOn: ['reply'],
+        }),
+        'remove-reply': core_1.Flags.string({
+            description: 'Review id whose publisher reply to withdraw (the agent publisher only)',
+            exclusive: ['reply', 'mine', 'limit', 'cursor'],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreReviews);
+        const agentId = args.agentId;
+        if (flags.reply !== undefined) {
+            const body = (flags.body ?? '').trim();
+            if (!body)
+                this.error('--body is empty; a reply needs text.', { exit: 2 });
+            if (body.length > data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH) {
+                this.error(`--body is ${body.length} characters; a reply holds at most ${data_provider_1.STORE_AGENT_REVIEW_MAX_LENGTH}.`, { exit: 2 });
+            }
+            try {
+                const res = await data_provider_1.dataService.replyToAgentReview({
+                    agentId,
+                    reviewId: flags.reply,
+                    body,
+                });
+                if (flags.json) {
+                    this.log(JSON.stringify(res, null, 2));
+                    return;
+                }
+                this.log(`Replied to review ${res.review.id}.`);
+                describeReview(res.review).forEach((line) => this.log(line));
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `Replying to review ${flags.reply}` });
+            }
+            return;
+        }
+        if (flags['remove-reply'] !== undefined) {
+            try {
+                const res = await data_provider_1.dataService.deleteAgentReviewReply({
+                    agentId,
+                    reviewId: flags['remove-reply'],
+                });
+                this.log(flags.json
+                    ? JSON.stringify(res, null, 2)
+                    : `Withdrew your reply to review ${res.review.id}.`);
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `Withdrawing the reply to ${flags['remove-reply']}` });
+            }
+            return;
+        }
+        if (flags.mine) {
+            try {
+                const res = await data_provider_1.dataService.getAgentUserRating(agentId);
+                if (flags.json) {
+                    this.log(JSON.stringify(res, null, 2));
+                    return;
+                }
+                if (res.userRating == null) {
+                    this.log(`You have not rated ${agentId}. Rate it with: skrr store review ${agentId} --rating <1-5>`);
+                    return;
+                }
+                this.log(`You rated ${agentId} ${res.userRating}/${data_provider_1.STORE_AGENT_RATING_MAX} on ${(0, review_1.describeRatedRelease)(res.ratedRelease)}.`);
+                this.log(res.userReview ? `Review: ${res.userReview}` : 'No written review.');
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `Reading your rating of ${agentId}` });
+            }
+            return;
+        }
+        try {
+            const res = await data_provider_1.dataService.getStoreAgentReviews(agentId, {
+                ...(flags.limit !== undefined ? { limit: flags.limit } : {}),
+                ...(flags.cursor ? { cursor: flags.cursor } : {}),
+            });
+            if (flags.json) {
+                this.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            if (res.data.length === 0) {
+                this.log(`No written reviews of ${agentId}${flags.cursor ? ' on this page' : ''}.`);
+            }
+            res.data.forEach((review, index) => {
+                if (index > 0)
+                    this.log('');
+                describeReview(review).forEach((line) => this.log(line));
+            });
+            if (res.has_more && res.next_cursor) {
+                this.log('');
+                this.log(`More: skrr store reviews ${agentId} --cursor ${res.next_cursor}`);
+            }
+            if (res.viewerIsPublisher && res.data.length > 0) {
+                this.log('');
+                this.log(`You publish this agent. Answer a review with: skrr store reviews ${agentId} --reply <review-id> --body "..."`);
+            }
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `Listing reviews of ${agentId}` });
+        }
+    }
+}
+exports.default = StoreReviews;

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

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Tip a public listing (SVC10). A tip is charged once from your balance under
+ * the fee schedule's tipping rate and grants nothing. `--tip-id` is the
+ * idempotency identity: repeat it to retry the SAME tip safely; omit it and
+ * every invocation is a new charge.
+ */
+export default class StoreTip extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        amount: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'tip-id': 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/tip.js

@@ -0,0 +1,57 @@
+"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 usd_micros_1 = require("../../lib/usd-micros");
+/**
+ * Tip a public listing (SVC10). A tip is charged once from your balance under
+ * the fee schedule's tipping rate and grants nothing. `--tip-id` is the
+ * idempotency identity: repeat it to retry the SAME tip safely; omit it and
+ * every invocation is a new charge.
+ */
+class StoreTip extends base_command_1.BaseCommand {
+    static description = 'Tip the publisher of a public store listing — charged once, grants no entitlement';
+    static examples = [
+        '<%= config.bin %> store tip agent_abc123 --amount 5',
+        '<%= config.bin %> store tip agent_abc123 --amount 2.50 --tip-id my-retry-key',
+    ];
+    static args = {
+        agentId: core_1.Args.string({
+            description: 'Store listing (agent) id',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        amount: core_1.Flags.string({ description: 'Amount in USD, e.g. 5 or 2.50', required: true }),
+        'tip-id': core_1.Flags.string({
+            description: 'Idempotency key — reuse it to retry the same tip without charging twice',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreTip);
+        const amountMicros = (0, usd_micros_1.usdToMicros)(flags.amount);
+        if (amountMicros === null) {
+            this.error(`--amount must be a positive USD amount with at most 2 decimals (got "${flags.amount}")`);
+        }
+        const tipId = flags['tip-id'] ?? (0, node_crypto_1.randomUUID)();
+        try {
+            const result = await data_provider_1.dataService.tipStoreAgent(args.agentId, { amountMicros, tipId });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(result.replayed
+                ? `Already tipped under ${tipId}; nothing new was charged.`
+                : `Tipped $${(result.amountMicros / 1_000_000).toFixed(2)} (tip ${tipId}).`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StoreTip;

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

@@ -0,0 +1,28 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr tokens create` — mint a personal access token (`osk_pat_*`, OSK-13208)
+ * for CI. The secret is printed EXACTLY ONCE.
+ *
+ * Creating one needs a sign-in session (a token cannot mint a token) and, for
+ * an account with two-factor authentication, a fresh authenticator code from
+ * that session. `--otp` / `--backup-code` supply it up front; at a terminal the
+ * command asks for it when the server does.
+ */
+export default class TokensCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'expires-in-days': import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        otp: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'backup-code': 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>;
+    private verify;
+    private refuseStepUp;
+}