@skrr-ai/cli 0.1.25 → 0.1.27

package/dist/commands/machines/dedicated/list.js

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const format_1 = require("../../../lib/format");
 const dedicated_machines_1 = require("../../../lib/dedicated-machines");
-class DedicatedMachinesList extends base_command_1.BaseCommand {
+class DedicatedMachinesList extends dedicated_lease_command_1.DedicatedLeaseCommand {
     static description = 'List Dedicated Runtime leases';
     static examples = [
         '<%= config.bin %> machines dedicated list',
-        '<%= config.bin %> machines dedicated list --json',
+        '<%= config.bin %> machines dedicated list --state stopped',
+        '<%= config.bin %> machines dedicated list --workspace <workspace-id> --json',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
@@ -18,38 +19,48 @@ class DedicatedMachinesList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(DedicatedMachinesList);
-        let response;
-        try {
-            response = await (0, dedicated_machines_1.listDedicatedRuntimes)({
-                limit: flags.limit,
-                state: flags.state,
-            });
-        }
-        catch (err) {
-            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
-            if (message)
-                this.error(message, { exit: 1 });
-            this.handleApiError(err);
-        }
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.listDedicatedRuntimes)({
+            limit: flags.limit,
+            state: flags.state,
+            ...this.scopeFrom(flags),
+        }));
         if (flags.json) {
             this.log(JSON.stringify(response, null, 2));
             return;
         }
         const leases = response?.leases ?? [];
         if (leases.length === 0) {
-            this.log('No Dedicated Runtime leases.');
+            // An empty filtered list and an empty account are different facts, and a
+            // scope that sees nothing is the usual reason a machine "disappeared".
+            this.log(flags.state
+                ? `No Dedicated Runtime leases in state "${flags.state}".`
+                : 'No Dedicated Runtime leases.');
+            if (!flags.workspace) {
+                this.log('Machines created in a workspace are listed with --workspace <id>.');
+            }
             return;
         }
         (0, format_1.renderTable)(leases.map((lease) => ({
             id: (0, format_1.formatCell)((0, dedicated_machines_1.dedicatedLeaseId)(lease)),
             status: (0, format_1.formatCell)((0, dedicated_machines_1.dedicatedLeaseState)(lease)),
             name: (0, format_1.formatCell)((0, dedicated_machines_1.dedicatedLeaseDisplayName)(lease)),
+            size: (0, format_1.formatCell)([
+                lease.resources?.sizePreset,
+                lease.resources?.storageGb ? `${lease.resources.storageGb}G` : '',
+            ]
+                .filter(Boolean)
+                .join(' ') || '-'),
+            spend: (0, format_1.formatCell)(lease.billing
+                ? `${(0, dedicated_machines_1.formatUsdCents)(lease.billing.currentMonthSpendCents)}/${(0, dedicated_machines_1.formatUsdCents)(lease.billing.monthlySpendLimitCents)}${lease.billing.spendingLimitExceeded ? ' OVER' : ''}`
+                : '-'),
             retention: (0, format_1.formatCell)(lease.storage?.retentionClass || '-'),
             backup: (0, format_1.formatCell)(lease.storage?.lastBackupAt || '-'),
         })), [
             { key: 'id', header: 'ID' },
             { key: 'status', header: 'STATUS' },
             { key: 'name', header: 'NAME', maxWidth: 28 },
+            { key: 'size', header: 'SIZE', maxWidth: 18 },
+            { key: 'spend', header: 'MONTH/CAP', maxWidth: 24 },
             { key: 'retention', header: 'RETENTION', maxWidth: 14 },
             { key: 'backup', header: 'LAST BACKUP', maxWidth: 24 },
         ], (line) => this.log(line));

package/dist/commands/machines/dedicated/restart.d.ts

@@ -1,11 +1,14 @@
-import { BaseCommand } from '../../../base-command';
-export default class DedicatedMachinesRestart extends BaseCommand {
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+export default class DedicatedMachinesRestart extends DedicatedLeaseCommand {
     static description: string;
     static examples: string[];
     static args: {
         lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        wait: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        interval: 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/machines/dedicated/restart.js

@@ -1,42 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const dedicated_machines_1 = require("../../../lib/dedicated-machines");
-class DedicatedMachinesRestart extends base_command_1.BaseCommand {
-    static description = 'Restart a Dedicated Runtime lease';
+class DedicatedMachinesRestart extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Restart a Dedicated Runtime to recover availability. Files survive; memory, shells and background jobs do not.';
     static examples = [
         '<%= config.bin %> machines dedicated restart <lease-id>',
-        '<%= config.bin %> machines dedicated restart <lease-id> --json',
+        '<%= config.bin %> machines dedicated restart <lease-id> --wait',
+        '<%= config.bin %> machines dedicated restart <lease-id> --wait --timeout 10m --json',
     ];
     static args = {
         lease: core_1.Args.string({
-            description: 'Dedicated Runtime lease id',
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
             required: true,
             ignoreStdin: true,
         }),
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        ...dedicated_lease_command_1.dedicatedWaitFlags,
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(DedicatedMachinesRestart);
-        let response;
-        try {
-            response = await (0, dedicated_machines_1.performDedicatedLeaseAction)(args.lease, 'restart');
-        }
-        catch (err) {
-            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
-            if (message)
-                this.error(message, { exit: 1 });
-            this.handleApiError(err);
-        }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
-            return;
-        }
-        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(response?.lease)} ${(0, dedicated_machines_1.dedicatedLeaseState)(response?.lease)}.`);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.performDedicatedLeaseAction)(leaseId, 'restart', this.scopeFrom(flags)));
+        await this.reportLeaseAction(response, flags, { kind: 'running' }, 'Restarting');
     }
 }
 exports.default = DedicatedMachinesRestart;

package/dist/commands/machines/dedicated/restore.d.ts

@@ -0,0 +1,26 @@
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+/**
+ * `skrr machines dedicated restore` — bring back a deleted Dedicated Runtime.
+ *
+ * Deleting a workspace keeps one final recovery point for a window (seven days
+ * by default), because whoever deleted it may have been an agent acting with
+ * the owner's authority. This builds a NEW machine from that point, with the
+ * deleted one's files; the deleted lease stays deleted.
+ */
+export default class DedicatedMachinesRestore extends DedicatedLeaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        wait: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        interval: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'spending-limit-cents': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'request-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/machines/dedicated/restore.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const node_crypto_1 = require("node:crypto");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
+const dedicated_machines_1 = require("../../../lib/dedicated-machines");
+/**
+ * `skrr machines dedicated restore` — bring back a deleted Dedicated Runtime.
+ *
+ * Deleting a workspace keeps one final recovery point for a window (seven days
+ * by default), because whoever deleted it may have been an agent acting with
+ * the owner's authority. This builds a NEW machine from that point, with the
+ * deleted one's files; the deleted lease stays deleted.
+ */
+class DedicatedMachinesRestore extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Restore a deleted Dedicated Runtime into a new machine, from the recovery point its deletion kept. Only inside the recovery window, and once.';
+    static examples = [
+        '<%= config.bin %> machines dedicated restore <deleted-lease-id>',
+        '<%= config.bin %> machines dedicated restore <deleted-lease-id> --name research-box --wait',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: 'The deleted Dedicated Runtime lease id (see `machines dedicated show`)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        name: core_1.Flags.string({
+            description: 'Display name for the new machine (defaults to the deleted one, "(restored)")',
+        }),
+        'spending-limit-cents': core_1.Flags.integer({
+            description: "Monthly spending cap for the new machine (defaults to the deleted machine's)",
+            min: 1,
+        }),
+        'request-id': core_1.Flags.string({
+            description: 'Idempotency key. Reuse it to safely retry the same restore.',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        ...dedicated_lease_command_1.dedicatedWaitFlags,
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesRestore);
+        const requestId = flags['request-id'] || `dedicated-restore:${Date.now()}:${(0, node_crypto_1.randomBytes)(6).toString('hex')}`;
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.restoreDeletedDedicatedRuntime)(args.lease, {
+            ...this.scopeFrom(flags),
+            requestId,
+            ...(flags.name ? { displayName: flags.name } : {}),
+            ...(flags['spending-limit-cents'] !== undefined
+                ? { monthlySpendingLimitCents: flags['spending-limit-cents'] }
+                : {}),
+        }));
+        if (!flags.json) {
+            const lease = response?.lease;
+            this.log(`Restoring ${args.lease} into ${(0, dedicated_machines_1.dedicatedLeaseDisplayName)(lease)} (${(0, dedicated_machines_1.dedicatedLeaseId)(lease) || 'unknown'}).`);
+            if (flags.wait && !flags['request-id']) {
+                process.stderr.write(`Request id ${requestId} (reuse it with --request-id to retry safely)\n`);
+            }
+        }
+        await this.reportLeaseAction(response, flags, { kind: 'running' }, 'Restoring');
+    }
+}
+exports.default = DedicatedMachinesRestore;

package/dist/commands/machines/dedicated/show.d.ts

@@ -1,5 +1,5 @@
-import { BaseCommand } from '../../../base-command';
-export default class DedicatedMachinesShow extends BaseCommand {
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+export default class DedicatedMachinesShow extends DedicatedLeaseCommand {
     static description: string;
     static examples: string[];
     static args: {

package/dist/commands/machines/dedicated/show.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const dedicated_machines_1 = require("../../../lib/dedicated-machines");
-class DedicatedMachinesShow extends base_command_1.BaseCommand {
-    static description = 'Show one Dedicated Runtime lease';
+const harnesses_1 = require("../../../lib/harnesses");
+class DedicatedMachinesShow extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Show one Dedicated Runtime lease: state, size, workspace, spend against the cap, health, deletion clock and the engines its daemon registered';
     static examples = [
         '<%= config.bin %> machines dedicated show <lease-id>',
         '<%= config.bin %> machines dedicated show <lease-id> --json',
@@ -12,47 +13,45 @@ class DedicatedMachinesShow extends base_command_1.BaseCommand {
     static args = {
         lease: core_1.Args.string({
             ignoreStdin: true,
-            description: 'Dedicated Runtime lease id',
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
             required: true,
         }),
     };
-    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(DedicatedMachinesShow);
-        let response;
-        try {
-            response = await (0, dedicated_machines_1.getDedicatedRuntime)(args.lease);
-        }
-        catch (err) {
-            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
-            if (message)
-                this.error(message, { exit: 1 });
-            this.handleApiError(err);
-        }
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.getDedicatedRuntime)(leaseId, this.scopeFrom(flags)));
         const lease = response?.lease;
         if (!lease) {
             this.error('Dedicated Runtime lease not found.', { exit: 1 });
         }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
-            return;
-        }
-        this.log((0, dedicated_machines_1.dedicatedLeaseDisplayName)(lease));
-        this.log(`  id           ${(0, dedicated_machines_1.dedicatedLeaseId)(lease)}`);
-        this.log(`  status       ${(0, dedicated_machines_1.dedicatedLeaseState)(lease)}`);
-        if (lease.storage?.retentionClass) {
-            this.log(`  retention    ${lease.storage.retentionClass}`);
-        }
-        if (lease.storage?.backupProfile) {
-            this.log(`  backup       ${lease.storage.backupProfile}`);
+        // The harness rows are what an agent attaches to and what a terminal opens
+        // on, and the lease payload deliberately names no daemon. Best-effort: a
+        // failed harness read must not hide the lease the caller asked for.
+        let harnesses = [];
+        try {
+            const listed = (await (0, harnesses_1.listHarnesses)());
+            harnesses = Array.isArray(listed) ? listed : (listed?.harnesses ?? []);
         }
-        if (lease.storage?.lastBackupAt) {
-            this.log(`  last backup  ${lease.storage.lastBackupAt}`);
+        catch {
+            harnesses = [];
         }
-        if (lease.billing?.monthlySpendLimitCents != null) {
-            this.log(`  monthly cap  ${lease.billing.monthlySpendLimitCents} cents`);
+        if (flags.json) {
+            const engines = (0, dedicated_machines_1.dedicatedLeaseHarnesses)(lease, harnesses).map((harness) => ({
+                harnessId: harness._id,
+                provider: harness.provider,
+                status: harness.status,
+                lastSeenAt: harness.lastSeenAt,
+            }));
+            this.log(JSON.stringify({ ...response, harnesses: engines }, null, 2));
+            return;
         }
+        for (const line of (0, dedicated_machines_1.describeDedicatedLease)(lease, harnesses))
+            this.log(line);
     }
 }
 exports.default = DedicatedMachinesShow;

package/dist/commands/machines/dedicated/sign-in.d.ts

@@ -0,0 +1,19 @@
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+/**
+ * `skrr machines dedicated sign-in` — the lease card's Sign in menu.
+ *
+ * Opens the machine's terminal and types the tool's sign-in command once the
+ * shell is ready. The commands are the SAME fixed strings the web offers,
+ * declared once in `@skrr-ai/data-provider`; each is a device-code or
+ * paste-a-code flow, because the machine has no browser.
+ */
+export default class DedicatedMachinesSignIn extends DedicatedLeaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        tool: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {};
+    run(): Promise<void>;
+}

package/dist/commands/machines/dedicated/sign-in.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
+const TOOLS = data_provider_1.DEDICATED_RUNTIME_SIGN_IN_PRESETS.map((preset) => preset.tool);
+/**
+ * `skrr machines dedicated sign-in` — the lease card's Sign in menu.
+ *
+ * Opens the machine's terminal and types the tool's sign-in command once the
+ * shell is ready. The commands are the SAME fixed strings the web offers,
+ * declared once in `@skrr-ai/data-provider`; each is a device-code or
+ * paste-a-code flow, because the machine has no browser.
+ */
+class DedicatedMachinesSignIn extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Sign in to GitHub CLI, Claude Code or Codex on a Dedicated Runtime, in an interactive terminal. The sign-in is shared by everything that runs on the machine, agents included.';
+    static examples = [
+        '<%= config.bin %> machines dedicated sign-in <lease-id> github',
+        '<%= config.bin %> machines dedicated sign-in <lease-id> claude',
+        '<%= config.bin %> machines dedicated sign-in <lease-id> codex',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: 'Dedicated Runtime lease id',
+            required: true,
+            ignoreStdin: true,
+        }),
+        tool: core_1.Args.string({
+            description: `What to sign in to: ${TOOLS.join(', ')}`,
+            required: true,
+            options: TOOLS,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {};
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesSignIn);
+        const preset = data_provider_1.DEDICATED_RUNTIME_SIGN_IN_PRESETS.find((candidate) => candidate.tool === args.tool);
+        if (!preset) {
+            this.error(`Unknown tool "${args.tool}". Choose one of: ${TOOLS.join(', ')}.`, { exit: 2 });
+        }
+        // Said before, not after: once the code is entered the credential already
+        // sits on the workspace volume, in every later snapshot.
+        process.stderr.write(`${preset.label} sign-in is stored on the workspace volume and shared by everything running as skrr-workload on this machine, including agents. Prefer a narrowly-scoped account or token.\n`);
+        await this.openDedicatedTerminal(args.lease, flags, preset.command);
+    }
+}
+exports.default = DedicatedMachinesSignIn;

package/dist/commands/machines/dedicated/snapshot.d.ts

@@ -1,11 +1,14 @@
-import { BaseCommand } from '../../../base-command';
-export default class DedicatedMachinesSnapshot extends BaseCommand {
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+export default class DedicatedMachinesSnapshot extends DedicatedLeaseCommand {
     static description: string;
     static examples: string[];
     static args: {
         lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        wait: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        interval: 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/machines/dedicated/snapshot.js

@@ -1,42 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const dedicated_machines_1 = require("../../../lib/dedicated-machines");
-class DedicatedMachinesSnapshot extends base_command_1.BaseCommand {
-    static description = 'Snapshot a Dedicated Runtime lease workspace';
+class DedicatedMachinesSnapshot extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Take a recovery point of a Dedicated Runtime workspace before something risky. With --wait, succeeds only once a new recovery point is recorded.';
     static examples = [
         '<%= config.bin %> machines dedicated snapshot <lease-id>',
-        '<%= config.bin %> machines dedicated snapshot <lease-id> --json',
+        '<%= config.bin %> machines dedicated snapshot <lease-id> --wait',
+        '<%= config.bin %> machines dedicated snapshot <lease-id> --wait --json',
     ];
     static args = {
         lease: core_1.Args.string({
-            description: 'Dedicated Runtime lease id',
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
             required: true,
             ignoreStdin: true,
         }),
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        ...dedicated_lease_command_1.dedicatedWaitFlags,
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(DedicatedMachinesSnapshot);
-        let response;
-        try {
-            response = await (0, dedicated_machines_1.performDedicatedLeaseAction)(args.lease, 'snapshot');
-        }
-        catch (err) {
-            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
-            if (message)
-                this.error(message, { exit: 1 });
-            this.handleApiError(err);
-        }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
-            return;
-        }
-        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(response?.lease)} ${(0, dedicated_machines_1.dedicatedLeaseState)(response?.lease)}.`);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.performDedicatedLeaseAction)(leaseId, 'snapshot', this.scopeFrom(flags)));
+        // A snapshot returns the lease to the state it left, so the state cannot say
+        // whether it worked. The recovery point's timestamp can: the 202 carries the
+        // previous one, and success is a newer one.
+        await this.reportLeaseAction(response, flags, { kind: 'snapshot', previousBackupAt: response?.lease?.storage?.lastBackupAt ?? null }, 'Snapshotting');
     }
 }
 exports.default = DedicatedMachinesSnapshot;

package/dist/commands/machines/dedicated/spending-limit.d.ts

@@ -0,0 +1,22 @@
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+/**
+ * `skrr machines dedicated spending-limit` — change the monthly cap after create.
+ *
+ * The cap is the ONE guardrail on a machine with no wall-clock TTL: when a
+ * month's spend reaches it, the platform stops compute and keeps the workspace.
+ * It could be set at create and changed from the web lease card, but not from
+ * here — so an operator who hit it at 2am had to find a browser to raise it,
+ * and an agent watching its own machine could not lower it.
+ */
+export default class DedicatedMachinesSpendingLimit extends DedicatedLeaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        cents: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/machines/dedicated/spending-limit.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
+const dedicated_machines_1 = require("../../../lib/dedicated-machines");
+/**
+ * `skrr machines dedicated spending-limit` — change the monthly cap after create.
+ *
+ * The cap is the ONE guardrail on a machine with no wall-clock TTL: when a
+ * month's spend reaches it, the platform stops compute and keeps the workspace.
+ * It could be set at create and changed from the web lease card, but not from
+ * here — so an operator who hit it at 2am had to find a browser to raise it,
+ * and an agent watching its own machine could not lower it.
+ */
+class DedicatedMachinesSpendingLimit extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Change the monthly spending cap of a Dedicated Runtime. At the cap, compute stops and the workspace is kept.';
+    static examples = [
+        '<%= config.bin %> machines dedicated spending-limit <lease-id> --cents 30000',
+        '<%= config.bin %> machines dedicated spending-limit <lease-id> --cents 5000 --json',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        cents: core_1.Flags.integer({
+            description: 'New monthly cap in cents (30000 = $300). Refused below what this month has already spent or is projected to.',
+            required: true,
+            min: 1,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesSpendingLimit);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.setDedicatedRuntimeSpendingLimit)(leaseId, flags.cents, this.scopeFrom(flags)));
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        const lease = response?.lease;
+        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(lease) || leaseId} spending cap updated.`);
+        if (lease)
+            this.log(`  ${(0, dedicated_machines_1.dedicatedSpendSummary)(lease)}`);
+    }
+}
+exports.default = DedicatedMachinesSpendingLimit;

package/dist/commands/machines/dedicated/start.d.ts

@@ -1,11 +1,14 @@
-import { BaseCommand } from '../../../base-command';
-export default class DedicatedMachinesStart extends BaseCommand {
+import { DedicatedLeaseCommand } from '../../../lib/dedicated-lease-command';
+export default class DedicatedMachinesStart extends DedicatedLeaseCommand {
     static description: string;
     static examples: string[];
     static args: {
         lease: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        wait: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        interval: 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/machines/dedicated/start.js

@@ -1,42 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
-const base_command_1 = require("../../../base-command");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const dedicated_machines_1 = require("../../../lib/dedicated-machines");
-class DedicatedMachinesStart extends base_command_1.BaseCommand {
-    static description = 'Start a Dedicated Runtime lease';
+class DedicatedMachinesStart extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'Start a stopped Dedicated Runtime. Files under /workspace are as you left them; nothing that was running is.';
     static examples = [
         '<%= config.bin %> machines dedicated start <lease-id>',
-        '<%= config.bin %> machines dedicated start <lease-id> --json',
+        '<%= config.bin %> machines dedicated start <lease-id> --wait',
+        '<%= config.bin %> machines dedicated start <lease-id> --wait --timeout 10m --json',
     ];
     static args = {
         lease: core_1.Args.string({
-            description: 'Dedicated Runtime lease id',
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
             required: true,
             ignoreStdin: true,
         }),
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        ...dedicated_lease_command_1.dedicatedWaitFlags,
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(DedicatedMachinesStart);
-        let response;
-        try {
-            response = await (0, dedicated_machines_1.performDedicatedLeaseAction)(args.lease, 'start');
-        }
-        catch (err) {
-            const message = (0, dedicated_machines_1.formatDedicatedRuntimeApiError)(err);
-            if (message)
-                this.error(message, { exit: 1 });
-            this.handleApiError(err);
-        }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
-            return;
-        }
-        this.log(`Dedicated Runtime ${(0, dedicated_machines_1.dedicatedLeaseId)(response?.lease)} ${(0, dedicated_machines_1.dedicatedLeaseState)(response?.lease)}.`);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const response = await this.callDedicated(() => (0, dedicated_machines_1.performDedicatedLeaseAction)(leaseId, 'start', this.scopeFrom(flags)));
+        await this.reportLeaseAction(response, flags, { kind: 'running' }, 'Starting');
     }
 }
 exports.default = DedicatedMachinesStart;