@skrr-ai/cli 0.1.91 → 0.1.93

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

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDaemonLogLine = formatDaemonLogLine;
+const core_1 = require("@oclif/core");
+const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
+const machine_daemon_log_1 = require("../../../lib/machine-daemon-log");
+/** One line as it prints: UTC time (the daemon's clock), level, then the daemon's own text. */
+function formatDaemonLogLine(line) {
+    const at = new Date(line.at).toISOString().replace('T', ' ').replace('Z', '');
+    return `${at} ${line.level.toUpperCase().padEnd(5)} ${line.text}`;
+}
+class DedicatedMachinesLogs extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static summary = "Read the tail of a Dedicated Runtime machine's daemon log";
+    static description = "Shows the last lines the machine's daemon logged about itself — why it reconnected, " +
+        're-registered or failed to sign in — so you can debug it without reading syslog, which ' +
+        "the machine's workload user cannot. The daemon keeps a short, recent log in memory and " +
+        "redacts credentials before keeping a line; it is not the machine's system log and it does " +
+        'not survive a daemon restart (the start time is printed). A machine whose image predates ' +
+        'this says so: update it with `machines dedicated update-image`. Anyone the machine is ' +
+        'shared with at the watch tier or above can read it; each read is on the audit record.';
+    static examples = [
+        '<%= config.bin %> machines dedicated logs <lease-id>',
+        '<%= config.bin %> machines dedicated logs <lease-id> --since 30m --level warn',
+        '<%= config.bin %> machines dedicated logs <lease-id> --lines 300 --json',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            ignoreStdin: true,
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
+            required: true,
+        }),
+    };
+    static flags = {
+        lines: core_1.Flags.integer({
+            description: `The newest N lines (1-${machine_daemon_log_1.COMPUTER_DAEMON_LOG_LIMITS.maxLines})`,
+            default: machine_daemon_log_1.COMPUTER_DAEMON_LOG_LIMITS.defaultLines,
+            min: 1,
+            max: machine_daemon_log_1.COMPUTER_DAEMON_LOG_LIMITS.maxLines,
+        }),
+        since: core_1.Flags.string({
+            description: 'Only lines from this long ago: 90s, 30m, 2h, 1d (at most 24h)',
+        }),
+        level: core_1.Flags.string({
+            description: 'Only this level and above',
+            options: [...machine_daemon_log_1.COMPUTER_DAEMON_LOG_LEVELS],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesLogs);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        let sinceMs;
+        try {
+            sinceMs = flags.since ? (0, machine_daemon_log_1.parseDaemonLogSince)(flags.since) : undefined;
+        }
+        catch (err) {
+            this.error(err instanceof Error ? err.message : String(err), { exit: 2 });
+        }
+        let result;
+        try {
+            result = await (0, machine_daemon_log_1.getMachineDaemonLog)(`lease:${leaseId}`, {
+                lines: flags.lines,
+                ...(sinceMs !== undefined ? { sinceMs } : {}),
+                ...(flags.level
+                    ? { level: flags.level }
+                    : {}),
+            });
+        }
+        catch (err) {
+            const failure = (0, machine_daemon_log_1.describeDaemonLogFailure)(err, { bin: this.config.bin, leaseId });
+            if (failure)
+                this.failWithCliError({ ...failure, exit: 1 });
+            return this.callDedicated(async () => {
+                throw err;
+            });
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (result.lines.length === 0) {
+            // Empty is "nothing matched in what the daemon still holds", never "the
+            // daemon logged nothing": the log is a short in-memory window.
+            this.log(flags.since || flags.level
+                ? 'No log lines match those filters in what the daemon still holds.'
+                : 'The daemon has logged nothing since it started (or since its log was last cleared by a restart).');
+        }
+        for (const line of result.lines)
+            this.log(formatDaemonLogLine(line));
+        const started = new Date(result.startedAt).toISOString();
+        const notes = [`daemon started ${started}`];
+        if (result.truncated)
+            notes.push('more matched than this shows: raise --lines or narrow --since');
+        if (result.ringFull)
+            notes.push("older lines have rolled off the daemon's short log");
+        if (result.redactedLines > 0) {
+            notes.push(`${result.redactedLines} line(s) in the log had credential-shaped text masked`);
+        }
+        this.log(`-- ${notes.join('; ')}`);
+    }
+}
+exports.default = DedicatedMachinesLogs;

package/dist/commands/machines/dedicated/power/index.js

@@ -6,7 +6,7 @@ const core_1 = require("@oclif/core");
  * on its own. `set` is the standing policy; more verbs arrive with the power card.
  */
 class DedicatedMachinesPower extends core_1.Command {
-    static description = 'Power policy of a Dedicated Runtime — when it may stop and start on its own. Files are preserved across stops.\n\nSubcommands:\n  show        state, policy, holders, usage, next wake\n  explain     why it stayed on, stopped or woke, and the fix\n  set         always_on | on_demand | manual (+ --idle-after, --budget-hours)\n  keep-awake  --for <duration> | --until <iso> | --clear';
+    static description = 'Power policy of a Dedicated Runtime — when it may stop and start on its own. Files are preserved across stops.\n\nSubcommands:\n  show        state, policy, holders, usage, next wake\n  explain     why it stayed on, stopped or woke, and the fix\n  waiting     work waiting for the machine\n  set         always_on | on_demand | manual (+ --idle-after, --budget-hours/--no-budget)\n  keep-awake  --for <duration> | --until <iso> | --clear';
     static examples = [
         '<%= config.bin %> machines dedicated power set <lease-id> --policy manual',
         '<%= config.bin %> machines dedicated power set <lease-id> --policy on_demand --idle-after 60',
@@ -15,7 +15,8 @@ class DedicatedMachinesPower extends core_1.Command {
         this.log('skrr machines dedicated power commands:');
         this.log('  skrr machines dedicated power show      state, policy, holders, usage, next wake');
         this.log('  skrr machines dedicated power explain   why it stayed on, stopped or woke, and the fix');
-        this.log('  skrr machines dedicated power set   always_on | on_demand | manual (+ --idle-after)');
+        this.log('  skrr machines dedicated power waiting   work waiting for the machine');
+        this.log('  skrr machines dedicated power set   always_on | on_demand | manual (+ --idle-after, --budget-hours/--no-budget)');
         this.log('  skrr machines dedicated power keep-awake   --for <duration> | --until <iso> | --clear');
         this.log('');
         this.log('Every command takes a lease id (or `self` on the machine) and --json.');

package/dist/commands/machines/dedicated/power/set.js

@@ -80,7 +80,7 @@ class DedicatedMachinesPowerSet extends dedicated_lease_command_1.DedicatedLease
                 this.log(JSON.stringify({ ok: false, ...refusal }, null, 2));
             }
             else {
-                this.log(`on_demand is not available for ${leaseId}: ${refusal.reason}`);
+                this.log(`On demand is not available for ${leaseId}: ${refusal.reason}`);
                 this.log(`  ${refusal.detail}`);
                 this.log(`  Fix: ${refusal.fix}`);
                 this.log('  The power policy was not changed.');

package/dist/commands/machines/dedicated/power/waiting.d.ts

@@ -0,0 +1,13 @@
+import { DedicatedLeaseCommand } from '../../../../lib/dedicated-lease-command';
+/** `skrr machines dedicated power waiting` — what is waiting for this machine. Read-only. */
+export default class DedicatedMachinesPowerWaiting extends DedicatedLeaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        lease: 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/machines/dedicated/power/waiting.js

@@ -0,0 +1,36 @@
+"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_power_1 = require("../../../../lib/dedicated-power");
+/** `skrr machines dedicated power waiting` — what is waiting for this machine. Read-only. */
+class DedicatedMachinesPowerWaiting extends dedicated_lease_command_1.DedicatedLeaseCommand {
+    static description = 'List work waiting for a Dedicated Runtime: parked trigger fires and runs, queued runs, and work just aimed at it. Derived from the schedulers own records. A source that cannot be read is said, not read as nothing waiting. Read-only.';
+    static examples = [
+        '<%= config.bin %> machines dedicated power waiting <lease-id>',
+        '<%= config.bin %> machines dedicated power waiting self --json',
+    ];
+    static args = {
+        lease: core_1.Args.string({
+            description: dedicated_lease_command_1.DEDICATED_LEASE_ARG_DESCRIPTION,
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(DedicatedMachinesPowerWaiting);
+        const leaseId = await this.resolveLeaseArg(args.lease);
+        const waiting = await this.callDedicated(() => (0, dedicated_power_1.getDedicatedWaitingWork)(leaseId, this.scopeFrom(flags)));
+        if (flags.json) {
+            this.log(JSON.stringify(waiting, null, 2));
+            return;
+        }
+        for (const line of (0, dedicated_power_1.describeWaitingWork)(waiting))
+            this.log(line);
+    }
+}
+exports.default = DedicatedMachinesPowerWaiting;

package/dist/commands/open.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../base-command';
+/**
+ * Open a Skrr web page in the browser: a URL someone sent you, a site path, or
+ * a typed reference such as `space:<id>` or `listing:<agentId>`.
+ *
+ * Not signed-in on purpose: a link is an address, not a permission — the page
+ * itself decides what the viewer sees. The one API read it can make is the
+ * anonymous share-code resolve, for an app-scheme link that names nothing but
+ * a code.
+ * Like every `<entity> open`, a non-interactive shell (a pipe, a script, an
+ * agent) gets the URL printed instead of a browser it cannot see.
+ */
+export default class Open extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        print: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/open.js

@@ -0,0 +1,74 @@
+"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 entity_open_1 = require("../lib/entity-open");
+const open_target_1 = require("../lib/open-target");
+/**
+ * Open a Skrr web page in the browser: a URL someone sent you, a site path, or
+ * a typed reference such as `space:<id>` or `listing:<agentId>`.
+ *
+ * Not signed-in on purpose: a link is an address, not a permission — the page
+ * itself decides what the viewer sees. The one API read it can make is the
+ * anonymous share-code resolve, for an app-scheme link that names nothing but
+ * a code.
+ * Like every `<entity> open`, a non-interactive shell (a pipe, a script, an
+ * agent) gets the URL printed instead of a browser it cannot see.
+ */
+class Open extends base_command_1.BaseCommand {
+    static description = `Open a ${data_provider_1.BRAND.displayName} URL, site path or <kind>:<id> reference in the browser (--print to only print the URL)`;
+    static examples = [
+        '<%= config.bin %> open https://skrr.ai/a/agent_abc123',
+        '<%= config.bin %> open listing:agent_abc123',
+        '<%= config.bin %> open skrr://agent/agent_abc123',
+        '<%= config.bin %> open space:sp_123 --print',
+        '<%= config.bin %> open /spaces/sp_123/tasks --json',
+    ];
+    static args = {
+        target: core_1.Args.string({
+            required: true,
+            ignoreStdin: true,
+            description: `A ${data_provider_1.BRAND.displayName} URL, a site path (/…), <kind>:<id> (${open_target_1.OPEN_REF_KINDS.join(', ')}), or an agent id or skrr:// link (opens its listing)`,
+        }),
+    };
+    static flags = {
+        print: core_1.Flags.boolean({ char: 'p', description: 'Print the URL without opening a browser' }),
+        json: core_1.Flags.boolean({ description: 'Print {url, form, opened} as JSON without opening' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Open);
+        let resolved;
+        try {
+            resolved = await (0, open_target_1.resolveOpenTarget)(args.target, this.cliConfig.baseURL);
+        }
+        catch (err) {
+            if (err instanceof open_target_1.OpenTargetError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            throw err;
+        }
+        const launch = !flags.print && !flags.json && Boolean(process.stdout.isTTY);
+        if (launch) {
+            try {
+                await (0, entity_open_1.launchEntityUrl)(resolved.url, 'web');
+            }
+            catch (err) {
+                // Say what failed and still hand over the URL — the person can open it.
+                this.failWithCliError({
+                    message: `Could not open a browser (${err.message}). The URL: ${resolved.url}`,
+                    code: 'OPEN_BROWSER_FAILED',
+                    exit: 1,
+                    retryable: true,
+                    details: { url: resolved.url },
+                });
+            }
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ ...resolved, opened: launch }, null, 2));
+            return;
+        }
+        this.log(launch ? `Opened browser: ${resolved.url}` : resolved.url);
+    }
+}
+exports.default = Open;

package/dist/commands/projects/archive.d.ts

@@ -14,6 +14,7 @@ export default class ProjectsArchive extends BaseCommand {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         unarchive: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/projects/archive.js

@@ -3,6 +3,7 @@ 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 dry_run_plans_1 = require("../../lib/dry-run-plans");
 /**
  * Same verb shape as `goals archive` — one command, `--unarchive` to restore.
  * Archive rides the DELETE route (which archives by default); unarchive is a
@@ -13,6 +14,7 @@ class ProjectsArchive extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects archive <project-id> --space <space>',
         '<%= config.bin %> projects archive <project-id> --space <space> --unarchive',
+        '<%= config.bin %> projects archive <project-id> --space <space> --dry-run --json',
     ];
     static args = {
         id: core_1.Args.string({
@@ -27,11 +29,32 @@ class ProjectsArchive extends base_command_1.BaseCommand {
             description: 'Owning space — id, ref, or name. Needed only for a bare ref (OSK-P-12); an id or a qualified ref `<space>/<project>` resolves on its own.',
         }),
         unarchive: core_1.Flags.boolean({ description: 'Unarchive the project instead of archiving it' }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Read the project and print what would change without changing it',
+        }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(ProjectsArchive);
         const { projectRef, spaceId } = await this.resolveProjectReference(args.id, flags.space);
+        if (flags['dry-run']) {
+            let project;
+            try {
+                project = (await data_provider_1.dataService.getSpaceProject(spaceId, projectRef));
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `project ${projectRef}` });
+            }
+            const plan = (0, dry_run_plans_1.planProjectChange)(flags.unarchive ? 'unarchive' : 'archive', project, projectRef);
+            if (flags.json)
+                this.log(JSON.stringify(plan, null, 2));
+            else {
+                this.log(`Dry run: would ${plan.action} project ${projectRef}. Nothing was changed.`);
+                for (const note of plan.notes)
+                    this.log(`Note: ${note}`);
+            }
+            return;
+        }
         let result;
         try {
             result = flags.unarchive

package/dist/commands/projects/delete.d.ts

@@ -13,6 +13,7 @@ export default class ProjectsDelete extends BaseCommand {
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/projects/delete.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 prompt_1 = require("../../lib/prompt");
+const dry_run_plans_1 = require("../../lib/dry-run-plans");
 /**
  * Hard delete (`?mode=delete`): removes the project and detaches member
  * tasks/goals (invariant P3 — never cascades into the work itself). The
@@ -14,6 +15,7 @@ class ProjectsDelete extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects delete <project-id> --space <space>',
         '<%= config.bin %> projects delete <project-id> --space <space> --yes',
+        '<%= config.bin %> projects delete <project-id> --space <space> --dry-run --json',
     ];
     static args = {
         id: core_1.Args.string({
@@ -27,6 +29,9 @@ class ProjectsDelete extends base_command_1.BaseCommand {
         space: core_1.Flags.string({
             description: 'Owning space — id, ref, or name. Needed only for a bare ref (OSK-P-12); an id or a qualified ref `<space>/<project>` resolves on its own.',
         }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Read the project and print what a delete would remove and detach, without deleting or prompting',
+        }),
         yes: core_1.Flags.boolean({
             char: 'y',
             aliases: ['force'],
@@ -37,6 +42,24 @@ class ProjectsDelete extends base_command_1.BaseCommand {
         this.requireAuth();
         const { args, flags } = await this.parse(ProjectsDelete);
         const { projectRef, spaceId } = await this.resolveProjectReference(args.id, flags.space);
+        if (flags['dry-run']) {
+            let project;
+            try {
+                project = (await data_provider_1.dataService.getSpaceProject(spaceId, projectRef));
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `project ${projectRef}` });
+            }
+            const plan = (0, dry_run_plans_1.planProjectChange)('delete', project, projectRef);
+            if (flags.json)
+                this.log(JSON.stringify(plan, null, 2));
+            else {
+                const detached = plan.changes
+                    .detachedTasksEstimate;
+                this.log(`Dry run: would permanently delete project ${projectRef} and detach ${detached ?? 'its'} task(s). Nothing was changed.`);
+            }
+            return;
+        }
         let confirmed;
         try {
             confirmed = await (0, prompt_1.confirmDestructive)(`Delete project ${projectRef}? Member tasks and goals are detached, not deleted. This cannot be undone.`, flags.yes);

package/dist/commands/projects/list.d.ts

@@ -16,6 +16,9 @@ export default class ProjectsList extends BaseCommand {
         space: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        compact: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'include-archived': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/commands/projects/list.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const space_argument_1 = require("../../lib/space-argument");
 const format_1 = require("../../lib/format");
+const list_output_1 = require("../../lib/list-output");
 const projects_1 = require("../../lib/projects");
 /**
  * `skrr projects list [space]` — the projects in a space, or across every space
@@ -23,6 +24,7 @@ class ProjectsList extends base_command_1.BaseCommand {
         '<%= config.bin %> projects list --q "billing"',
         '<%= config.bin %> projects list <space> --include-archived',
         '<%= config.bin %> projects list --q billing --json',
+        '<%= config.bin %> projects list <space> --compact --json',
     ];
     static args = {
         space: core_1.Args.string({
@@ -41,6 +43,7 @@ class ProjectsList extends base_command_1.BaseCommand {
             description: 'Case-insensitive match on title, description, or ref. Searches every visible space unless one is named.',
         }),
         limit: core_1.Flags.integer({ description: 'Max results when searching (1-200)', default: 50 }),
+        ...list_output_1.listOutputFlags,
     };
     async run() {
         this.requireAuth();
@@ -73,8 +76,15 @@ class ProjectsList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err, { subject: spaceId ? `space ${spaceId}` : 'projects' });
         }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+        if (flags.json || flags.ndjson) {
+            // P3: the in-space list answered a bare `{data}` while the cross-space
+            // search answered a full envelope. One shape for both; `data` stays.
+            this.printList((0, list_output_1.shapeListResponse)(response, {
+                resource: 'project',
+                fields: flags.fields,
+                compact: flags.compact,
+                requestedLimit: crossSpace ? flags.limit : undefined,
+            }), Boolean(flags.ndjson));
             return;
         }
         // Qualify the ref only when rows can come from more than one space —

package/dist/commands/spaces/actions/add.js

@@ -25,6 +25,7 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsAdd);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -52,7 +53,7 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
         let result;
         try {
             result = await data_provider_1.dataService.addSpaceCustomAction({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 action: payload,
             });
         }
@@ -65,12 +66,12 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
         // returns just the action. A create returns the thing it created.
         const stored = (result?.customActions ?? []).find((action) => action.id === payload.id) ?? payload;
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', stored, ['id']), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', stored, ['id']), null, 2));
         else
             this.log(`Added custom action ${String(payload.id)}.`);
         // On stderr, so `--json` stays parseable: the action was saved, and still
         // cannot run until the space has a Leader (OSK-9641).
-        const unrunnable = (0, space_custom_actions_1.spaceActionsNotRunnableReason)({ id: args.id, leadAgentId: result?.leadAgentId }, this.config.bin);
+        const unrunnable = (0, space_custom_actions_1.spaceActionsNotRunnableReason)({ id: spaceRef, leadAgentId: result?.leadAgentId }, this.config.bin);
         if (unrunnable)
             this.warn(unrunnable);
     }

package/dist/commands/spaces/actions/available.js

@@ -25,9 +25,10 @@ class SpacesActionsAvailable extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsAvailable);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpaceAvailableActions(args.id);
+            response = await data_provider_1.dataService.listSpaceAvailableActions(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -54,7 +55,7 @@ class SpacesActionsAvailable extends base_command_1.BaseCommand {
         // The REF is for two commands, and they need different rights: attaching
         // works for any space member, running needs VIEW on the agent (OSK-9663).
         this.log('Attach to a task: skrr tasks actions attach <task-id> <agentId>:<actionId>');
-        this.log(`Run one in this space: skrr spaces actions run ${args.id} <agentId>:<actionId> (needs access to the agent; see what you can run with: skrr spaces actions list ${args.id} --all)`);
+        this.log(`Run one in this space: skrr spaces actions run ${spaceRef} <agentId>:<actionId> (needs access to the agent; see what you can run with: skrr spaces actions list ${spaceRef} --all)`);
     }
 }
 exports.default = SpacesActionsAvailable;

package/dist/commands/spaces/actions/list.js

@@ -24,9 +24,10 @@ class SpacesActionsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let space;
         try {
-            space = await data_provider_1.dataService.getSpace(args.id);
+            space = await data_provider_1.dataService.getSpace(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -35,12 +36,12 @@ class SpacesActionsList extends base_command_1.BaseCommand {
         if (flags.all)
             return this.listAll(space, flags.json);
         if (flags.json)
-            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', { data: actions }, [
+            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', { data: actions }, [
                 'id',
             ]), null, 2));
         if (!actions.length) {
             this.log('No custom actions.');
-            this.log(`Agent actions offered here: ${this.config.bin} spaces actions list ${args.id} --all`);
+            this.log(`Agent actions offered here: ${this.config.bin} spaces actions list ${spaceRef} --all`);
             return;
         }
         (0, format_1.renderTable)(actions.map((a) => ({
@@ -57,7 +58,7 @@ class SpacesActionsList extends base_command_1.BaseCommand {
             { key: 'id', header: 'ID' },
         ], (line) => this.log(line));
         this.noteUnrunnable(space);
-        this.log(`Agent actions offered here too: ${this.config.bin} spaces actions list ${args.id} --all`);
+        this.log(`Agent actions offered here too: ${this.config.bin} spaces actions list ${spaceRef} --all`);
     }
     /** Say, on stderr, when none of the listed space actions can run. */
     noteUnrunnable(space) {

package/dist/commands/spaces/actions/replace.js

@@ -24,6 +24,7 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsReplace);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let raw;
         try {
             raw = await (0, prompt_1.readJsonValue)(flags['from-json']);
@@ -37,19 +38,19 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
         if (flags['dry-run']) {
             const output = {
                 dryRun: true,
-                spaceId: args.id,
+                spaceId: spaceRef,
                 actions,
                 expectedActionIds: flags['expected-id'] ?? [],
             };
             this.log(flags.json
                 ? JSON.stringify(output, null, 2)
-                : `Dry run: would replace custom actions for space ${args.id}.`);
+                : `Dry run: would replace custom actions for space ${spaceRef}.`);
             return;
         }
         let result;
         try {
             result = await data_provider_1.dataService.replaceSpaceCustomActions({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 actions: actions,
                 expectedActionIds: flags['expected-id'],
             });
@@ -58,9 +59,9 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', result, ['id']), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', result, ['id']), null, 2));
         else
-            this.log(`Replaced custom actions for space ${args.id}.`);
+            this.log(`Replaced custom actions for space ${spaceRef}.`);
     }
 }
 exports.default = SpacesActionsReplace;

package/dist/commands/spaces/archive.js

@@ -16,9 +16,10 @@ class SpacesArchive extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesArchive);
+        const spaceId = await this.resolveEntityRef('space', args.id);
         let updated;
         try {
-            updated = await data_provider_1.dataService.archiveSpace(args.id);
+            updated = await data_provider_1.dataService.archiveSpace(spaceId);
         }
         catch (err) {
             this.handleApiError(err);
@@ -28,7 +29,7 @@ class SpacesArchive extends base_command_1.BaseCommand {
             return;
         }
         const s = updated;
-        this.log(`Archived space ${s.id ?? s._id ?? args.id} - ${s.title ?? '(no title)'}`);
+        this.log(`Archived space ${s.id ?? s._id ?? spaceId} - ${s.title ?? '(no title)'}`);
     }
 }
 exports.default = SpacesArchive;

package/dist/commands/spaces/auto-executor/preview.js

@@ -21,15 +21,16 @@ class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
         // ignored, and raw JSON printed unconditionally. There was no readable
         // rendering of a preview anywhere in the CLI.
         const { args, flags } = await this.parse(SpacesAutoExecutorPreview);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = (await data_provider_1.dataService.previewSpaceAutoExecutor(args.id));
+            result = (await data_provider_1.dataService.previewSpaceAutoExecutor(spaceRef));
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
             return;
         }
         const { space, plan } = result;
@@ -37,7 +38,7 @@ class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
             this.log('No plan was returned for this space.');
             return;
         }
-        this.log(`Space:      ${space.title ?? args.id}`);
+        this.log(`Space:      ${space.title ?? spaceRef}`);
         this.log(`Autopilot:  ${space.autoExecuteEnabled ? 'enabled' : 'disabled'}` +
             (space.autoExecuteLifecycleState === 'sleeping'
                 ? ` (sleeping${space.autoExecuteSuspensionReason ? `: ${String(space.autoExecuteSuspensionReason).replace(/_/g, ' ')}` : ''})`