@skrr-ai/cli 0.1.60 → 0.1.62

package/dist/commands/agents/usage-cap.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * YOUR monthly cap on ONE agent's hosted spend (C11), enforced where each of
+ * your hosted Agent SDK runs of it starts. It counts and bounds only the runs
+ * billed to you. For a Store agent, pass your installed copy's id — the cap is
+ * on the agent that runs, not on the publisher's listing.
+ */
+export default class AgentsUsageCap extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        set: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        clear: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/usage-cap.js

@@ -0,0 +1,76 @@
+"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");
+/**
+ * YOUR monthly cap on ONE agent's hosted spend (C11), enforced where each of
+ * your hosted Agent SDK runs of it starts. It counts and bounds only the runs
+ * billed to you. For a Store agent, pass your installed copy's id — the cap is
+ * on the agent that runs, not on the publisher's listing.
+ */
+class AgentsUsageCap extends base_command_1.BaseCommand {
+    static description = 'Show, set or remove your monthly hosted-spend cap on an agent';
+    static examples = [
+        '<%= config.bin %> agents usage-cap <agent-id>',
+        '<%= config.bin %> agents usage-cap <agent-id> --set 20',
+        '<%= config.bin %> agents usage-cap <agent-id> --clear --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Agent ID (for a Store agent, your installed copy)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        set: core_1.Flags.string({
+            description: 'Monthly cap in dollars of usage, e.g. 20 or 12.50',
+            exclusive: ['clear'],
+        }),
+        clear: core_1.Flags.boolean({ description: 'Remove the cap', exclusive: ['set'] }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsUsageCap);
+        let micros = null;
+        if (flags.set !== undefined) {
+            micros = (0, data_provider_1.parseAgentUsageCapDollars)(flags.set);
+            if (micros === null) {
+                this.error(`--set takes an amount in dollars, like 20 or 12.50 (got "${flags.set}")`, {
+                    exit: 2,
+                });
+            }
+        }
+        let cap;
+        try {
+            cap = flags.clear
+                ? await data_provider_1.dataService.clearAgentUsageCap(args.id)
+                : micros !== null
+                    ? await data_provider_1.dataService.setAgentUsageCap(args.id, { monthlyLimitMicros: micros })
+                    : await data_provider_1.dataService.getAgentUsageCap(args.id);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (!cap)
+            return;
+        if (flags.json) {
+            this.log(JSON.stringify(cap, null, 2));
+            return;
+        }
+        const resets = String(cap.periodEnd).slice(0, 10);
+        if (cap.monthlyLimitMicros === null) {
+            this.log(`Agent ${args.id}: no cap set · ${(0, data_provider_1.formatAgentUsageMicros)(cap.usedMicros)} used by you this month`);
+        }
+        else {
+            // Figures unclamped: usage past the cap is shown as it is. "Reached" is
+            // the server's call, made with the refusal's own threshold — a few cents
+            // left can already be too little to start a run.
+            this.log(`Agent ${args.id}: ${(0, data_provider_1.formatAgentUsageMicros)(cap.usedMicros)} of ${(0, data_provider_1.formatAgentUsageMicros)(cap.monthlyLimitMicros)} used by you this month (resets ${resets})${cap.exhausted ? ' — cap reached, your new runs are refused' : ''}`);
+        }
+        this.log(data_provider_1.AGENT_USAGE_CAP_EXPLANATION);
+    }
+}
+exports.default = AgentsUsageCap;

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

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+/**
+ * Check an agent-as-code document without signing in or touching the network.
+ *
+ * It extends oclif's `Command`, not `BaseCommand`, on purpose: `BaseCommand`
+ * resolves a credential (keychain, local broker) before any command runs, and
+ * a CI job or a pre-commit hook that validates a file must not need either.
+ * The rules are the same module the server applies on push, so a file that
+ * passes here is refused on push only for what needs the live agent — a field
+ * push cannot set that differs from the agent's current value.
+ */
+export default class AgentsValidate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        file: 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/validate.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const agent_spec_1 = require("../../lib/agent-spec");
+/**
+ * Check an agent-as-code document without signing in or touching the network.
+ *
+ * It extends oclif's `Command`, not `BaseCommand`, on purpose: `BaseCommand`
+ * resolves a credential (keychain, local broker) before any command runs, and
+ * a CI job or a pre-commit hook that validates a file must not need either.
+ * The rules are the same module the server applies on push, so a file that
+ * passes here is refused on push only for what needs the live agent — a field
+ * push cannot set that differs from the agent's current value.
+ */
+class AgentsValidate extends core_1.Command {
+    static description = 'Check an agent spec file offline: portable fields only, no credentials, no withheld references';
+    static examples = [
+        '<%= config.bin %> agents validate agent.json',
+        'cat agent.json | <%= config.bin %> agents validate -',
+        '<%= config.bin %> agents validate agent.json --json',
+    ];
+    static args = {
+        file: core_1.Args.string({
+            description: 'Agent spec document ("-" for stdin)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the result as JSON' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AgentsValidate);
+        let raw;
+        try {
+            raw = await (0, agent_spec_1.readSpecSource)(args.file);
+        }
+        catch (err) {
+            this.error(`Could not read ${args.file}: ${err.message}`, {
+                code: 'AGENT_SPEC_READ_FAILED',
+                exit: 1,
+            });
+        }
+        const parsed = (0, agent_spec_1.parseAndValidateAgentSpec)(raw, args.file);
+        if (!parsed.ok) {
+            if (flags.json) {
+                this.log(JSON.stringify({ ok: false, issues: [{ code: 'AGENT_SPEC_NOT_JSON', message: parsed.message }] }, null, 2));
+                this.exit(1);
+            }
+            this.error(parsed.message, { code: 'AGENT_SPEC_NOT_JSON', exit: 1 });
+        }
+        const { validation } = parsed;
+        if (flags.json) {
+            this.log(JSON.stringify({ ok: validation.ok, issues: validation.issues }, null, 2));
+            if (!validation.ok)
+                this.exit(1);
+            return;
+        }
+        if (!validation.ok) {
+            this.error((0, agent_spec_1.issueBlock)(`${args.file} is not a valid agent spec (${validation.issues.length} issue(s)):`, validation.issues), { code: 'AGENT_SPEC_INVALID', exit: 1 });
+        }
+        const fields = Object.keys(validation.document.spec);
+        this.log(`${args.file} is a valid agent spec (${fields.length} field(s): ${fields.join(', ')}).`);
+    }
+}
+exports.default = AgentsValidate;

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

@@ -1,4 +1,15 @@
 import { BaseCommand } from '../../base-command';
+/**
+ * `--capability-rationale <permission-key>=<note>` → the publisher notes a
+ * release carries beside its capability manifest. Split on the FIRST `=`, so a
+ * note may contain one. A later entry for the same key replaces an earlier one.
+ * The server keeps only keys the release actually discloses and never refuses
+ * a release over them (D7), so this only checks the shape it can see.
+ */
+export declare function parseCapabilityRationales(entries: readonly string[] | undefined): {
+    rationales?: Record<string, string>;
+    error?: string;
+};
 export default class AgentsVisibility extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -14,6 +25,8 @@ export default class AgentsVisibility extends BaseCommand {
         changelog: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'version-major': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'version-minor': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'capability-rationale': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        language: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/visibility.js

@@ -1,14 +1,42 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCapabilityRationales = parseCapabilityRationales;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+/**
+ * `--capability-rationale <permission-key>=<note>` → the publisher notes a
+ * release carries beside its capability manifest. Split on the FIRST `=`, so a
+ * note may contain one. A later entry for the same key replaces an earlier one.
+ * The server keeps only keys the release actually discloses and never refuses
+ * a release over them (D7), so this only checks the shape it can see.
+ */
+function parseCapabilityRationales(entries) {
+    if (!entries || entries.length === 0)
+        return {};
+    const rationales = {};
+    for (const entry of entries) {
+        const at = entry.indexOf('=');
+        const key = at > 0 ? entry.slice(0, at).trim() : '';
+        const note = at > 0 ? entry.slice(at + 1).trim() : '';
+        if (!key || !note) {
+            return {
+                error: `--capability-rationale expects <permission-key>=<note>, got "${entry}".`,
+            };
+        }
+        rationales[key] = note;
+    }
+    return { rationales };
+}
 class AgentsVisibility extends base_command_1.BaseCommand {
-    static description = 'Set the visibility of an agent (public or private)';
+    static description = 'Set the visibility of an agent (accounts with 2FA need recent step-up for public publishing)';
     static examples = [
         '<%= config.bin %> agents visibility <agent-id> --public',
+        '<%= config.bin %> step-up # required before public publishing when 2FA is enabled',
         '<%= config.bin %> agents visibility <agent-id> --private',
         '<%= config.bin %> agents visibility <agent-id> --public --json',
+        '<%= config.bin %> agents visibility <agent-id> --public --capability-rationale "network:*=Looks up flight prices on the web"',
+        '<%= config.bin %> agents visibility <agent-id> --public --language en --language zh-Hans',
     ];
     static args = {
         id: core_1.Args.string({ description: 'Agent ID', required: true, ignoreStdin: true }),
@@ -23,7 +51,9 @@ class AgentsVisibility extends base_command_1.BaseCommand {
             description: 'Make the agent private',
             exclusive: ['public'],
         }),
-        price: core_1.Flags.integer({ description: 'Price in token credits when publishing' }),
+        price: core_1.Flags.integer({
+            description: 'Listing price in micro-USD (1,000,000 = $1.00; the same unit the offer compares against)',
+        }),
         'share-mode': core_1.Flags.string({
             description: 'Published data sharing mode',
             options: ['none', 'bootstrap', 'memory', 'full'],
@@ -31,6 +61,17 @@ class AgentsVisibility extends base_command_1.BaseCommand {
         changelog: core_1.Flags.string({ description: 'Release changelog' }),
         'version-major': core_1.Flags.integer({ description: 'Explicit release major version' }),
         'version-minor': core_1.Flags.integer({ description: 'Explicit release minor version' }),
+        'capability-rationale': core_1.Flags.string({
+            description: "A publisher note shown beside one entry of the release's capability manifest, as " +
+                '<permission-key>=<note>. Keys are spelled tool:…, connector:…, data:…, network:… or ' +
+                'secret:… (for example network:* or connector:capability:*). Repeatable. A key the ' +
+                'release does not disclose is dropped; a note never blocks publishing.',
+            multiple: true,
+        }),
+        language: core_1.Flags.string({
+            description: 'A language the release works in, as a BCP 47 tag such as en or zh-Hans (repeatable). Shown on the listing as declared by you; the platform does not check it.',
+            multiple: true,
+        }),
     };
     async run() {
         this.requireAuth();
@@ -39,6 +80,45 @@ class AgentsVisibility extends base_command_1.BaseCommand {
             this.error('Pass either --public or --private.', { exit: 1 });
         }
         const isPublic = flags.public === true;
+        const { rationales: capabilityRationales, error: rationaleError } = parseCapabilityRationales(flags['capability-rationale']);
+        if (rationaleError) {
+            this.error(rationaleError, { exit: 1 });
+        }
+        if (capabilityRationales && !isPublic) {
+            this.error('--capability-rationale applies only when publishing with --public.', {
+                exit: 1,
+            });
+        }
+        // The declaration is recorded on the public release a publish creates; an
+        // unpublish creates none, so the flag would have nothing to attach to.
+        if (flags.language?.length && !isPublic) {
+            this.error('--language declares the languages of a public release; pass it with --public.', {
+                exit: 1,
+            });
+        }
+        // A public release reaches buyers. Accounts with 2FA need a recent
+        // second-factor proof; accounts without 2FA can publish from a verified
+        // sign-in session. Read that state before the publish write so the
+        // remedy is visible in the normal CLI flow instead of only after a 403.
+        // The server remains authoritative: this is user guidance, not a bypass.
+        if (isPublic) {
+            let stepUp;
+            try {
+                stepUp = await data_provider_1.dataService.getStepUpStatus(data_provider_1.STORE_PUBLISH_STEP_UP_PURPOSE);
+            }
+            catch (err) {
+                this.handleApiError(err);
+            }
+            if (!stepUp.active) {
+                const bin = this.config.bin;
+                if (!stepUp.sessionBound) {
+                    this.error(`This credential is not tied to a sign-in session. Run \`${bin} login\` before publishing, then \`${bin} step-up\` if your account has 2FA enabled.`, { code: 'STEP_UP_SESSION_UNBOUND', exit: 2 });
+                }
+                if (stepUp.methods.length > 0) {
+                    this.error(`Public publishing needs a recent two-factor verification. Run \`${bin} step-up\`, then retry this command.`, { code: 'STEP_UP_PROOF_REQUIRED', exit: 2 });
+                }
+            }
+        }
         let result;
         try {
             result = await data_provider_1.dataService.setAgentVisibility({
@@ -49,6 +129,8 @@ class AgentsVisibility extends base_command_1.BaseCommand {
                 changelog: flags.changelog,
                 versionMajor: flags['version-major'],
                 versionMinor: flags['version-minor'],
+                capabilityRationales,
+                supportedLanguages: flags.language,
             });
         }
         catch (err) {

package/dist/commands/commerce/fees/show.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr commerce fees show` — the Marketplace fee schedule (OSK-12271).
+ *
+ * The seller share, the platform fee, the standard hold and the payout minimum
+ * are declared once on the server, and every surface that states one of them
+ * reads this same response. The schedule is what a publisher is QUOTED: a
+ * completed sale keeps the split its offer and ledger row recorded, whatever
+ * this says today.
+ */
+export default class CommerceFeesShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/commerce/fees/show.js

@@ -0,0 +1,75 @@
+"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 commerce_1 = require("../../../lib/commerce");
+function describeTerms(fees) {
+    return `seller ${(0, data_provider_1.formatMarketplaceBasisPoints)(fees.sellerShareBps)}, platform ${(0, data_provider_1.formatMarketplaceBasisPoints)(fees.platformFeeBps)}, held ${fees.holdDays} days`;
+}
+/**
+ * `skrr commerce fees show` — the Marketplace fee schedule (OSK-12271).
+ *
+ * The seller share, the platform fee, the standard hold and the payout minimum
+ * are declared once on the server, and every surface that states one of them
+ * reads this same response. The schedule is what a publisher is QUOTED: a
+ * completed sale keeps the split its offer and ledger row recorded, whatever
+ * this says today.
+ */
+class CommerceFeesShow extends base_command_1.BaseCommand {
+    static description = 'Show the Marketplace fee schedule: seller share and hold per category, and the payout minimum.';
+    static examples = [
+        '<%= config.bin %> commerce fees show',
+        '<%= config.bin %> commerce fees show --json',
+        '<%= config.bin %> commerce fees show --version marketplace-fees.v1',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the full schedule as JSON' }),
+        version: core_1.Flags.string({
+            description: 'Read a named past schedule version instead of the current one',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(CommerceFeesShow);
+        let schedule;
+        try {
+            schedule = await (0, commerce_1.getMarketplaceFeeSchedule)(flags.version);
+        }
+        catch (error) {
+            this.handleApiError(error);
+            return;
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(schedule, null, 2));
+            return;
+        }
+        this.log(`Fee schedule ${schedule.version} (${schedule.currency})`);
+        this.log(schedule.publisherTerms
+            ? `Presented under publisher terms ${schedule.publisherTerms.termsVersion}`
+            : 'No publisher terms are configured; this schedule is not bound to any.');
+        this.log('');
+        for (const [category, fees] of Object.entries(schedule.categories)) {
+            const kinds = Object.entries(schedule.listingCategories)
+                .filter(([, mapped]) => mapped === category)
+                .map(([kind]) => kind);
+            this.log(`${category}: ${describeTerms(fees)}`);
+            if (kinds.length > 0)
+                this.log(`  quoted for: ${kinds.join(', ')}`);
+        }
+        this.log(`legacy (a sale with no versioned offer): ${describeTerms(schedule.legacy)}`);
+        this.log('');
+        this.log(`Payout: at least ${(0, data_provider_1.formatMarketplacePayoutMinimum)(schedule)}, ` +
+            `at most once every ${schedule.payout.cadenceDays} days`);
+        if (schedule.versions?.length) {
+            this.log('');
+            this.log('Versions:');
+            for (const v of schedule.versions) {
+                this.log(`  ${v.version} — effective ${v.effectiveAt.slice(0, 10)}` +
+                    `${v.current ? ' (current)' : ''}`);
+            }
+        }
+        this.log(`Content hash: ${schedule.contentHash}`);
+    }
+}
+exports.default = CommerceFeesShow;

package/dist/commands/earnings/index.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr earnings` — a publisher's balance and how it is paid out (OSK-12272).
+ *
+ * Read-only. Requesting a payout and turning automatic payouts on move money
+ * and refuse a daemon credential, so they live on the web Earnings page.
+ */
+export default class Earnings extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/earnings/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const earnings_1 = require("../../lib/earnings");
+/**
+ * `skrr earnings` — a publisher's balance and how it is paid out (OSK-12272).
+ *
+ * Read-only. Requesting a payout and turning automatic payouts on move money
+ * and refuse a daemon credential, so they live on the web Earnings page.
+ */
+class Earnings extends base_command_1.BaseCommand {
+    static description = 'Show your publisher earnings: available and pending balance, payout window and automatic payouts (read-only). ' +
+        'See `earnings statements` and `earnings payouts` for the history behind it.';
+    static examples = [
+        '<%= config.bin %> earnings',
+        '<%= config.bin %> earnings --json',
+        '<%= config.bin %> earnings statements',
+        '<%= config.bin %> earnings payouts',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(Earnings);
+        try {
+            const earnings = await (0, earnings_1.readEarnings)();
+            // Automatic payouts only mean something once payouts are set up; a
+            // publisher who has not onboarded gets the balance without them.
+            let autoPayout = null;
+            if (earnings.connectOnboarded) {
+                autoPayout = await (0, earnings_1.readAutoPayout)();
+            }
+            if (flags.json) {
+                this.log(JSON.stringify({ earnings, autoPayout }, null, 2));
+                return;
+            }
+            (0, earnings_1.renderEarningsSummary)(earnings, autoPayout, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: 'earnings' });
+        }
+    }
+}
+exports.default = Earnings;

package/dist/commands/earnings/payouts.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+/** `skrr earnings payouts` — your payout history, newest first (OSK-12272). Read-only. */
+export default class EarningsPayouts extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: 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/earnings/payouts.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const earnings_1 = require("../../lib/earnings");
+/** `skrr earnings payouts` — your payout history, newest first (OSK-12272). Read-only. */
+class EarningsPayouts extends base_command_1.BaseCommand {
+    static description = 'List your payouts, newest first: amount, status and when Stripe settled it';
+    static examples = [
+        '<%= config.bin %> earnings payouts',
+        '<%= config.bin %> earnings payouts --limit 50 --json',
+    ];
+    static flags = {
+        limit: core_1.Flags.integer({
+            description: 'Payouts per page (1-100)',
+            default: 20,
+            min: 1,
+            max: 100,
+        }),
+        cursor: core_1.Flags.string({ description: 'The last payout id of the previous page' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(EarningsPayouts);
+        try {
+            const result = await (0, earnings_1.readPayouts)({ limit: flags.limit, cursor: flags.cursor });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            (0, earnings_1.renderPayoutHistory)(result, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: 'payouts' });
+        }
+    }
+}
+exports.default = EarningsPayouts;

package/dist/commands/earnings/statements.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr earnings statements [YYYY-MM]` — monthly earnings statements
+ * (OSK-12272). Without a month, lists them newest first; with one, prints that
+ * month from opening balance to closing balance.
+ */
+export default class EarningsStatements extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        period: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: 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/earnings/statements.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const earnings_1 = require("../../lib/earnings");
+/**
+ * `skrr earnings statements [YYYY-MM]` — monthly earnings statements
+ * (OSK-12272). Without a month, lists them newest first; with one, prints that
+ * month from opening balance to closing balance.
+ */
+class EarningsStatements extends base_command_1.BaseCommand {
+    static description = 'List your monthly earnings statements, or show one month (YYYY-MM, UTC) from opening to closing balance';
+    static examples = [
+        '<%= config.bin %> earnings statements',
+        '<%= config.bin %> earnings statements 2026-09',
+        '<%= config.bin %> earnings statements --limit 24 --json',
+    ];
+    static args = {
+        period: core_1.Args.string({
+            description: 'Month to show, as YYYY-MM (UTC)',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        limit: core_1.Flags.integer({
+            description: 'Statements per page (1-60)',
+            default: 12,
+            min: 1,
+            max: 60,
+        }),
+        cursor: core_1.Flags.string({ description: 'The last month of the previous page (YYYY-MM)' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(EarningsStatements);
+        for (const [name, value] of [
+            ['month', args.period],
+            ['--cursor', flags.cursor],
+        ]) {
+            if (value !== undefined && !earnings_1.PERIOD_PATTERN.test(value)) {
+                this.error(`${name} must be a month as YYYY-MM, for example 2026-09.`, { exit: 2 });
+            }
+        }
+        try {
+            if (args.period) {
+                const statement = await (0, earnings_1.readStatement)(args.period);
+                if (flags.json) {
+                    this.log(JSON.stringify(statement, null, 2));
+                    return;
+                }
+                (0, earnings_1.renderStatement)(statement, (line) => this.log(line));
+                return;
+            }
+            const result = await (0, earnings_1.readStatements)({ limit: flags.limit, cursor: flags.cursor });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            (0, earnings_1.renderStatementList)(result, (line) => this.log(line));
+        }
+        catch (error) {
+            this.handleApiError(error, {
+                subject: args.period ? `statement ${args.period}` : 'statements',
+            });
+        }
+    }
+}
+exports.default = EarningsStatements;

package/dist/commands/goals/key-results/create.d.ts

@@ -18,7 +18,7 @@ export default class GoalsKeyResultsCreate extends BaseCommand {
         title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         progress: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'progress-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'progress-mode': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         order: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };