@skrr-ai/cli 0.1.116 → 0.1.118

package/dist/commands/guide.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+export default class Guide extends Command {
+    static baseFlags: {
+        bare: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        raw: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        section: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        offline: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/guide.js

@@ -0,0 +1,46 @@
+"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_guides_1 = require("../lib/agent-guides");
+// Documentation stays available when a daemon-issued Agent credential is
+// unavailable. Do not run BaseCommand's mandatory credential initialization.
+class Guide extends core_1.Command {
+    static baseFlags = base_command_1.BaseCommand.baseFlags;
+    static description = 'Read Skrr operation guides on demand';
+    static args = {
+        id: core_1.Args.string({ description: 'Guide id', ignoreStdin: true }),
+        section: core_1.Args.string({ description: 'Section id', ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the guide and source provenance as JSON' }),
+        offline: core_1.Flags.boolean({
+            description: 'Read the bundled release guides without checking credentials or the server',
+        }),
+    };
+    static examples = [
+        '<%= config.bin %> guide',
+        '<%= config.bin %> guide tasks',
+        '<%= config.bin %> guide tasks updates --offline',
+    ];
+    async run() {
+        const { args, flags } = await this.parse(Guide);
+        const request = {
+            ...(args.id ? { id: args.id } : {}),
+            ...(args.section ? { section: args.section } : {}),
+        };
+        const read = await (0, agent_guides_1.readAgentGuide)(request, flags);
+        if (!read.found)
+            return (0, agent_guides_1.writeAgentGuideMiss)(this, read.miss, flags.json);
+        if (flags.json) {
+            process.stdout.write((0, agent_guides_1.agentGuideJson)(read));
+            return;
+        }
+        const notice = (0, agent_guides_1.agentGuideFallbackNotice)(read);
+        if (notice)
+            process.stderr.write(`${notice}\n`);
+        process.stdout.write((0, data_provider_1.renderAgentGuideText)(read.response));
+    }
+}
+exports.default = Guide;

package/dist/commands/instructions/guide.js

@@ -4,19 +4,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
 const node_crypto_1 = require("node:crypto");
 const base_command_1 = require("../../base-command");
 const managed_instruction_guides_json_1 = __importDefault(require("../../generated/managed-instruction-guides.json"));
-const api_fetch_1 = require("../../lib/api-fetch");
-const auth_core_init_1 = require("../../lib/auth-core-init");
-const credential_resolver_1 = require("../../lib/credential-resolver");
-const harness_context_1 = require("../../lib/harness-context");
-const keychain_1 = require("../../lib/keychain");
+const agent_guides_1 = require("../../lib/agent-guides");
+// The installed v20 instructions still name this command; the guide body they
+// ask for now lives in the tasks card. The card also dropped the membership
+// and scheduling rules, so one trailing line keeps an agent pointed at where
+// those went.
+const TASKS_GUIDE_POINTER = 'Membership and scheduling now live in `skrr guide spaces access` for Space membership ' +
+    'and `skrr guide tasks followups` for follow-ups and scheduling.';
 // Documentation stays available when a daemon-issued Agent credential is
 // unavailable. Do not run BaseCommand's mandatory credential initialization.
 class InstructionsGuide extends core_1.Command {
     static baseFlags = base_command_1.BaseCommand.baseFlags;
-    static description = 'Read the detailed task-management guide on demand';
+    static description = 'Kept for installed instructions — prints the tasks guide. `skrr guide` reads every guide.';
     static args = {
         name: core_1.Args.string({
             description: 'Guide to read',
@@ -37,55 +40,34 @@ class InstructionsGuide extends core_1.Command {
     ];
     async run() {
         const { flags } = await this.parse(InstructionsGuide);
-        let guide = managed_instruction_guides_json_1.default['oversky-task-management'];
-        let source = 'bundled';
-        let reason = flags.offline ? 'offline-requested' : 'no-session';
-        if (!flags.offline) {
-            try {
-                (0, keychain_1.setActiveProfile)(flags.profile ?? process.env.OVERSKY_PROFILE ?? '');
-                const autonomous = (0, credential_resolver_1.resolveTrustedAutonomousCredential)();
-                if (!autonomous && !flags.bare && !(0, harness_context_1.isHarnessCliContext)())
-                    await (0, auth_core_init_1.prefetchCliAuth)();
-                const credential = autonomous ??
-                    (await (0, credential_resolver_1.resolveCredential)({
-                        flagToken: flags.token,
-                        bareMode: flags.bare,
-                        allowUnreadableStoredCredential: true,
-                    }));
-                if (credential.token) {
-                    reason = 'server-unavailable';
-                    const response = await (0, api_fetch_1.apiFetch)('/api/instructions/presets/oversky-task-management/guide', { credential, signal: AbortSignal.timeout(3_000) });
-                    if ((0, node_crypto_1.createHash)('sha256').update(response.body).digest('hex') !== response.hash) {
-                        // An integrity failure, not a network failure: the server
-                        // answered, but the body it sent does not match its own hash.
-                        // Give it its own reason before the catch below can flatten it
-                        // into 'server-unavailable', which describes the opposite world.
-                        reason = 'server-hash-mismatch';
-                        throw new Error('The server guide hash does not match its body.');
-                    }
-                    guide = response;
-                    source = 'server';
-                    reason = undefined;
-                }
-            }
-            catch {
-                // A missing/unreadable auth envelope or delegated daemon cannot make
-                // a read-only local guide unavailable, and must never emit auth JSON.
-                reason ??= 'server-unavailable';
-            }
-        }
-        if (flags.json)
+        const read = await (0, agent_guides_1.readAgentGuide)({ id: 'tasks' }, flags);
+        if (!read.found)
+            return (0, agent_guides_1.writeAgentGuideMiss)(this, read.miss, flags.json);
+        const body = (0, data_provider_1.renderAgentGuideText)(read.response);
+        if (flags.json) {
+            // The ManagedInstructionGuide shape is the contract older callers read:
+            // keep its keys, but `body` is the tasks card text and `hash` its sha256,
+            // so a consumer that verifies hash against body still succeeds.
+            const preset = managed_instruction_guides_json_1.default['oversky-task-management'];
             this.log(JSON.stringify({
-                ...guide,
-                provenance: { source, fallback: source === 'bundled', ...(reason ? { reason } : {}) },
+                key: preset.key,
+                name: preset.name,
+                templateVersion: preset.templateVersion,
+                body,
+                hash: (0, node_crypto_1.createHash)('sha256').update(body, 'utf8').digest('hex'),
+                redirectedTo: 'tasks',
+                provenance: {
+                    source: read.source,
+                    fallback: read.source === 'bundled',
+                    ...(read.reason ? { reason: read.reason } : {}),
+                },
             }, null, 2));
-        else {
-            if (source === 'bundled')
-                this.logToStderr(reason === 'server-hash-mismatch'
-                    ? `The server guide’s body does not match its hash; using the CLI’s bundled task-management guide (template v${guide.templateVersion}).`
-                    : `Using the CLI’s bundled task-management guide (template v${guide.templateVersion}).`);
-            this.log(guide.body);
+            return;
         }
+        const notice = (0, agent_guides_1.agentGuideFallbackNotice)(read);
+        if (notice)
+            process.stderr.write(`${notice}\n`);
+        this.log(`${body}\n${TASKS_GUIDE_POINTER}`);
     }
 }
 exports.default = InstructionsGuide;

package/dist/commands/memory/maintain.js

@@ -16,7 +16,7 @@ class MemoryMaintain extends base_command_1.BaseCommand {
     static description = 'Apply an auditable canonical memory maintenance operation';
     static examples = [
         '<%= config.bin %> memory maintain remember \'{"path":"/notes","claim":"Ship notes on Fridays."}\' --agent agent_abc123',
-        '<%= config.bin %> memory maintain archive \'{"factId":"fact_abc"}\' --agent agent_abc123',
+        '<%= config.bin %> memory maintain archive \'{"path":"/notes/old-note"}\' --agent agent_abc123',
     ];
     static args = {
         operation: core_1.Args.string({ required: true, options: [...OPERATIONS], ignoreStdin: true }),

package/dist/commands/skills/browse.js

@@ -6,6 +6,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
+const usd_micros_1 = require("../../lib/usd-micros");
 function skillBrowseDescription(skill) {
     const description = String(skill.description ?? '').trim();
     if (description && description !== '>' && description !== '|')
@@ -64,7 +65,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(response), null, 2));
             return;
         }
         const r = response;

package/dist/commands/skills/details.js

@@ -4,6 +4,8 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const local_skills_1 = require("../../lib/local-skills");
+const store_listing_1 = require("../../lib/store-listing");
+const usd_micros_1 = require("../../lib/usd-micros");
 class SkillsDetails extends base_command_1.BaseCommand {
     static description = 'Show full details for a skill';
     static examples = [
@@ -49,7 +51,7 @@ class SkillsDetails extends base_command_1.BaseCommand {
             await this.failOnStoreMiss(err, args.id);
         }
         if (flags.json) {
-            this.log(JSON.stringify(skill, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(skill), null, 2));
             return;
         }
         const s = skill;
@@ -59,7 +61,7 @@ class SkillsDetails extends base_command_1.BaseCommand {
         this.log(`Author:       ${s.authorName ?? s.author ?? '-'}`);
         this.log(`Rating:       ${s.rating != null ? s.rating.toFixed(1) : '-'} (${s.ratingCount ?? 0} reviews)`);
         this.log(`Installs:     ${s.installCount ?? 0}`);
-        this.log(`Price:        ${s.price ? `${s.price} credits` : 'Free'}`);
+        this.log(`Price:        ${(0, store_listing_1.formatListingPrice)(typeof s.price === 'number' ? s.price : null)}`);
         this.log(`Public:       ${s.isPublic ? 'yes' : 'no'}`);
         this.log(`Created:      ${s.createdAt ?? '-'}`);
         if (s.description) {

package/dist/commands/skills/featured.js

@@ -5,6 +5,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
+const usd_micros_1 = require("../../lib/usd-micros");
 const browse_1 = require("./browse");
 function featuredSkillIndex(response, limit) {
     const envelope = response;
@@ -41,7 +42,7 @@ class SkillsFeatured extends base_command_1.BaseCommand {
         }
         const index = featuredSkillIndex(response, flags.limit);
         if (flags.json)
-            return void this.log(JSON.stringify(index, null, 2));
+            return void this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(index), null, 2));
         const items = index.data;
         if (items.length === 0) {
             this.log('No featured skills.');

package/dist/commands/skills/install.d.ts

@@ -9,6 +9,8 @@ export default class SkillsInstall extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         service: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'expected-price': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     /** A store 404 for a name that may be a skill on the caller's machine. */
     private failOnStoreMiss;

package/dist/commands/skills/install.js

@@ -3,12 +3,15 @@ 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 prompt_1 = require("../../lib/prompt");
 const local_skills_1 = require("../../lib/local-skills");
+const usd_micros_1 = require("../../lib/usd-micros");
 class SkillsInstall extends base_command_1.BaseCommand {
-    static description = 'Install a skill from the store to a service (agent)';
+    static description = 'Install a skill from the store to a service (agent). A paid skill shows its price and asks you to confirm first.';
     static examples = [
         '<%= config.bin %> skills install <skill-id>',
         '<%= config.bin %> skills install <skill-id> --agent <agent-id>',
+        '<%= config.bin %> skills install <skill-id> --yes',
         '<%= config.bin %> skills install <skill-id> --json',
     ];
     static args = {
@@ -25,6 +28,14 @@ class SkillsInstall extends base_command_1.BaseCommand {
             description: '[DEPRECATED] Use --agent. Same meaning, kept for script compatibility.',
             hidden: true,
         }),
+        yes: core_1.Flags.boolean({
+            char: 'y',
+            description: 'Confirm a paid install without prompting. The price is still printed.',
+        }),
+        'expected-price': core_1.Flags.string({
+            description: 'Refuse unless the install would charge exactly this USD amount (e.g. 4 or 2.50; 0 pins free). ' +
+                'Use it to pin the price the person named, not just the one read now.',
+        }),
     };
     /** A store 404 for a name that may be a skill on the caller's machine. */
     async failOnStoreMiss(err, id) {
@@ -56,18 +67,66 @@ class SkillsInstall extends base_command_1.BaseCommand {
                 retryable: false,
             });
         }
+        // What installing would charge NOW, read before the install sends it.
+        // A paid skill shows its price and asks first; the install then pins what
+        // was shown, so a listing whose price moved in between is refused rather
+        // than charged (OSK-18042 — same convention as `store install`, OSK-12240).
+        let listing;
+        try {
+            listing = await data_provider_1.dataService.getSkill(args.id);
+        }
+        catch (err) {
+            return await this.failOnStoreMiss(err, args.id);
+        }
+        const charge = Number(listing.price) || 0;
+        // A caller-pinned price binds the install to what the PERSON named, not
+        // just to what this command read (OSK-18256 — same convention as
+        // `store install`).
+        const expectedMicros = (0, usd_micros_1.expectedPriceFlagMicros)(flags['expected-price']);
+        if (expectedMicros === null) {
+            this.error(`--expected-price must be a USD amount with at most 2 decimals, e.g. 4 or 2.50 (got "${flags['expected-price']}")`, { exit: 2 });
+        }
+        if (expectedMicros !== undefined && expectedMicros !== charge) {
+            this.failWithCliError({
+                message: (0, usd_micros_1.expectedPriceMismatchMessage)(expectedMicros, charge),
+                code: 'EXPECTED_PRICE_MISMATCH',
+                exit: 1,
+                retryable: false,
+            });
+        }
+        if (charge > 0) {
+            const name = listing.displayName || listing.name || args.id;
+            // Printed before any prompt and even with --yes, so a scripted purchase
+            // still leaves the price it agreed to in its own output.
+            this.logToStderr(`${name} is a paid skill.`);
+            this.logToStderr(`  Price: ${(0, data_provider_1.formatStoreAcquisitionPrice)(charge)} USD`);
+            if (listing.offerVersionId) {
+                this.logToStderr(`  Offer: ${listing.offerVersionId}`);
+            }
+            const confirmed = await (0, prompt_1.confirmDestructive)(`Buy ${name} for ${(0, data_provider_1.formatStoreAcquisitionPrice)(charge)}?`, flags.yes).catch((err) => this.error(err.message, { exit: err.exit ?? 1 }));
+            if (!confirmed) {
+                this.log('Cancelled. Nothing was bought.');
+                return;
+            }
+        }
         let result;
         try {
             result = await data_provider_1.dataService.installSkill({
                 skillId: args.id,
                 targetAgentId,
+                // Pin what the person was shown: the charge always, the offer when
+                // there is one to charge under.
+                expectedPrice: charge,
+                ...(charge > 0 && listing.offerVersionId
+                    ? { expectedOfferVersionId: listing.offerVersionId }
+                    : {}),
             });
         }
         catch (err) {
-            await this.failOnStoreMiss(err, args.id);
+            return await this.failOnStoreMiss(err, args.id);
         }
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(result), null, 2));
             return;
         }
         const r = result;

package/dist/commands/skills/search.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const search_query_1 = require("../../lib/search-query");
+const usd_micros_1 = require("../../lib/usd-micros");
 class SkillsSearch extends base_command_1.BaseCommand {
     static description = 'Search skills in the skrr store by keyword (same as `search skills`)';
     static examples = [
@@ -53,7 +54,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(response), null, 2));
             return;
         }
         const r = response;

package/dist/commands/slack/send-as-agent.js

@@ -181,14 +181,14 @@ class SlackSendAsAgent extends base_command_1.BaseCommand {
 exports.default = SlackSendAsAgent;
 function generatedSessionIdempotencyKey(agentId, channelId, text) {
     const requestId = process.env.OVERSKY_SESSION_REQUEST_ID || process.env.OVERSKY_REQUEST_ID;
-    if (requestId)
-        return `session:slack:${requestId}`;
     const digest = crypto
         .createHash('sha256')
         .update(JSON.stringify({ agentId, channelId, text }))
         .digest('hex')
         .slice(0, 32);
-    return `session:slack:${digest}`;
+    if (requestId)
+        return `session:slack:${requestId}:${digest}`;
+    return `session:slack:${crypto.randomUUID()}`;
 }
 function formatSessionSlackResult(result, agentId, channelId) {
     const status = result.status || 'submitted';

package/dist/commands/spaces/create.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
-const outbox_1 = require("../../lib/outbox");
+const node_crypto_1 = require("node:crypto");
 const api_fetch_1 = require("../../lib/api-fetch");
 const base_command_1 = require("../../base-command");
 const label_ref_1 = require("../../lib/label-ref");
@@ -124,7 +124,13 @@ class SpacesCreate extends base_command_1.BaseCommand {
         // replay must collapse onto the write that already landed. A key sent only
         // on the replay would create a second Space instead — the exact duplicate
         // the outbox exists to prevent.
-        const idempotencyKey = (0, outbox_1.idempotencyKeyFor)('space-create', String(payload.title), JSON.stringify(payload));
+        //
+        // The key is fresh per invocation and travels with the queued write; it is
+        // never derived from the payload. A payload-derived key made a second
+        // `spaces create` with the same title and parent replay the first for 24
+        // hours, so a person who archived "Billing migration" and asked for a new
+        // one got the archived Space back, and their new work was filed inside it.
+        const idempotencyKey = `space-create_${(0, node_crypto_1.randomUUID)()}`;
         let created;
         try {
             // apiFetch rather than `dataService.createSpace`: the shared transport

package/dist/commands/spaces/guide.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+/** Local documentation must remain readable without credentials or a daemon. */
+export default class SpacesGuide extends Command {
+    static baseFlags: {
+        bare: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        raw: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static description: string;
+    static args: {
+        section: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        offline: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/spaces/guide.js

@@ -0,0 +1,40 @@
+"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_guides_1 = require("../../lib/agent-guides");
+/** Local documentation must remain readable without credentials or a daemon. */
+class SpacesGuide extends core_1.Command {
+    static baseFlags = base_command_1.BaseCommand.baseFlags;
+    static description = 'Alias of `skrr guide spaces views` — the Space perspective map. `skrr guide spaces` reads the whole guide.';
+    static args = {
+        section: core_1.Args.string({
+            description: 'A section of the spaces guide to read instead of `views`',
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the guide and source provenance as JSON' }),
+        offline: core_1.Flags.boolean({
+            description: 'Read the bundled release guides without checking credentials or the server',
+        }),
+    };
+    static examples = [
+        '<%= config.bin %> spaces guide',
+        '<%= config.bin %> spaces guide goals',
+        '<%= config.bin %> spaces guide --json',
+    ];
+    async run() {
+        const { args, flags } = await this.parse(SpacesGuide);
+        const read = await (0, agent_guides_1.readAgentGuide)({ id: 'spaces', section: args.section ?? 'views' }, flags);
+        if (!read.found)
+            return (0, agent_guides_1.writeAgentGuideMiss)(this, read.miss, flags.json);
+        if (flags.json) {
+            process.stdout.write((0, agent_guides_1.agentGuideJson)(read));
+            return;
+        }
+        process.stdout.write((0, data_provider_1.renderAgentGuideText)(read.response));
+    }
+}
+exports.default = SpacesGuide;

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

@@ -9,7 +9,6 @@ declare const PERSPECTIVES: SpacePerspective[];
 export default class Spaces extends BaseCommand {
     static description: string;
     static examples: string[];
-    static aliases: string[];
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };

package/dist/commands/spaces/index.js

@@ -102,12 +102,7 @@ const PERSPECTIVES = [
 exports.PERSPECTIVES = PERSPECTIVES;
 class Spaces extends base_command_1.BaseCommand {
     static description = 'Discover space perspectives and the CLI commands for each one';
-    static examples = [
-        '<%= config.bin %> spaces',
-        '<%= config.bin %> spaces --json',
-        '<%= config.bin %> spaces guide',
-    ];
-    static aliases = ['spaces guide'];
+    static examples = ['<%= config.bin %> spaces', '<%= config.bin %> spaces --json'];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output the perspective guide as JSON' }),
     };

package/dist/commands/store/acquisitions/list.js

@@ -5,6 +5,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const store_acquisition_1 = require("../../../lib/store-acquisition");
+const usd_micros_1 = require("../../../lib/usd-micros");
 /**
  * Every purchase or install an agent asked to make for you, newest first
  * (OSK-13403). Before this, a request was only reachable by its id — one from
@@ -42,7 +43,7 @@ class StoreAcquisitionsList extends base_command_1.BaseCommand {
         }
         const requests = result?.requests ?? [];
         if (flags.json) {
-            this.printJsonResult((0, list_output_1.listResult)(result, 'requests'));
+            this.printJsonResult((0, list_output_1.listResult)((0, usd_micros_1.withUsdPrices)(result), 'requests'));
             return;
         }
         if (requests.length === 0) {

package/dist/commands/store/acquisitions/show.js

@@ -4,6 +4,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const store_acquisition_1 = require("../../../lib/store-acquisition");
+const usd_micros_1 = require("../../../lib/usd-micros");
 /**
  * A purchase an agent asked to make, read from the server's stored request
  * (OSK-12240) — the same data the web approval card shows.
@@ -38,7 +39,7 @@ class StoreAcquisitionsShow extends base_command_1.BaseCommand {
             this.error('The purchase request could not be read.', { exit: 1 });
         }
         if (flags.json) {
-            this.log(JSON.stringify(request, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(request), null, 2));
             return;
         }
         for (const line of (0, store_acquisition_1.describeAcquisitionRequestLines)(request)) {

package/dist/commands/store/browse.js

@@ -4,6 +4,8 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
+const store_listing_1 = require("../../lib/store-listing");
+const usd_micros_1 = require("../../lib/usd-micros");
 class StoreBrowse extends base_command_1.BaseCommand {
     static description = 'Browse published agents in the store';
     static examples = [
@@ -63,7 +65,7 @@ class StoreBrowse extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.log(JSON.stringify((0, usd_micros_1.withUsdPrices)(response), null, 2));
             return;
         }
         const r = response;
@@ -77,7 +79,7 @@ class StoreBrowse extends base_command_1.BaseCommand {
             name: String(a.name ?? '-'),
             // Price is a property of the LISTING, so it is read from the listing
             // row rather than from anything the agent carries.
-            price: a.price ? String(a.price) : 'free',
+            price: (0, store_listing_1.formatListingPrice)(typeof a.price === 'number' ? a.price : null),
             rating: a.rating ? `${Number(a.rating).toFixed(1)} (${a.ratingCount ?? 0})` : '-',
             installs: String(a.installCount ?? 0),
             author: String(a.authorName ?? '-'),

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

@@ -12,6 +12,7 @@ export default class StoreInstall extends BaseCommand {
         'include-bootstrap': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'include-memory': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'expected-price': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'run-on': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'share-outcomes': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };