@skrr-ai/cli 0.1.92 → 0.1.94

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

@@ -51,15 +51,16 @@ class SpacesHeartbeatsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesHeartbeatsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpaceHeartbeats(args.id);
+            response = await data_provider_1.dataService.listSpaceHeartbeats(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'schedule', response, [
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'schedule', response, [
                 'agentId',
                 'id',
                 '_id',
@@ -87,7 +88,7 @@ class SpacesHeartbeatsList extends base_command_1.BaseCommand {
         ], (line) => this.log(line));
         this.log('');
         this.log('For live next-run status of a specific heartbeat:');
-        this.log(`  skrr spaces heartbeats status ${args.id} <agent-id>`);
+        this.log(`  skrr spaces heartbeats status ${spaceRef} <agent-id>`);
     }
 }
 exports.default = SpacesHeartbeatsList;

package/dist/commands/spaces/heartbeats/status.js

@@ -21,9 +21,10 @@ class SpacesHeartbeatsStatus extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesHeartbeatsStatus);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getSpaceHeartbeatStatus(args.id, args.agentId);
+            result = await data_provider_1.dataService.getSpaceHeartbeatStatus(spaceRef, args.agentId);
         }
         catch (err) {
             this.handleApiError(err);
@@ -31,7 +32,7 @@ class SpacesHeartbeatsStatus extends base_command_1.BaseCommand {
         // --json takes priority over the human-readable "not configured" message
         // so piped consumers always receive valid JSON (null when missing).
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'schedule', {
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'schedule', {
                 result: result ?? null,
             }), null, 2));
             return;

package/dist/commands/spaces/heartbeats/update.js

@@ -38,6 +38,7 @@ class SpacesHeartbeatsUpdate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesHeartbeatsUpdate);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -63,7 +64,7 @@ class SpacesHeartbeatsUpdate extends base_command_1.BaseCommand {
         let result;
         try {
             result = await data_provider_1.dataService.updateSpaceHeartbeat({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 agentId: args.agentId,
                 ...payload,
             });
@@ -72,10 +73,10 @@ class SpacesHeartbeatsUpdate extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'schedule', result), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'schedule', result), null, 2));
             return;
         }
-        this.log(`Updated heartbeat for agent ${args.agentId} in space ${args.id}`);
+        this.log(`Updated heartbeat for agent ${args.agentId} in space ${spaceRef}`);
     }
 }
 exports.default = SpacesHeartbeatsUpdate;

package/dist/commands/spaces/insights.js

@@ -144,6 +144,7 @@ class SpacesInsights extends base_command_1.BaseCommand {
         if ((!args.id && !flags.all) || (args.id && flags.all)) {
             this.error('Pass exactly one Space ID or --all', { exit: 2 });
         }
+        const spaceRef = args.id ? await this.resolveEntityRef('space', args.id) : undefined;
         let request;
         try {
             const requestFlags = {
@@ -166,13 +167,13 @@ class SpacesInsights extends base_command_1.BaseCommand {
         }
         try {
             if (flags.csv) {
-                process.stdout.write(args.id
-                    ? await data_provider_1.dataService.exportSpaceTaskInsightsCsv(args.id, request)
+                process.stdout.write(spaceRef
+                    ? await data_provider_1.dataService.exportSpaceTaskInsightsCsv(spaceRef, request)
                     : await data_provider_1.dataService.exportWorkspaceTaskInsightsCsv(request));
                 return;
             }
-            const result = args.id
-                ? await data_provider_1.dataService.getSpaceTaskInsights(args.id, request)
+            const result = spaceRef
+                ? await data_provider_1.dataService.getSpaceTaskInsights(spaceRef, request)
                 : await data_provider_1.dataService.getWorkspaceTaskInsights(request);
             if (flags.json) {
                 this.log(JSON.stringify(result, null, 2));

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

@@ -24,6 +24,7 @@ class SpacesLabelsAdd extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLabelsAdd);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         // `spaces update` deliberately refuses labelIds — the server routes label
         // changes through this atomic $addToSet endpoint so concurrent edits can't
         // clobber each other. Re-attaching an already-attached label is a no-op.
@@ -45,20 +46,20 @@ class SpacesLabelsAdd extends base_command_1.BaseCommand {
         }
         let result;
         try {
-            result = await data_provider_1.dataService.addLabelToSpace({ spaceId: args.id, labelId });
+            result = await data_provider_1.dataService.addLabelToSpace({ spaceId: spaceRef, labelId });
         }
         catch (err) {
             this.handleApiError(err);
         }
         const updated = (0, web_url_1.withSpaceUrl)(this.cliConfig.baseURL, {
-            id: args.id,
+            id: spaceRef,
             ...result,
         });
         if (flags.json) {
             this.log(JSON.stringify(updated, null, 2));
             return;
         }
-        this.log(`Attached label ${flags.label} to space ${args.id}`);
+        this.log(`Attached label ${flags.label} to space ${spaceRef}`);
         this.log(`URL: ${updated.url ?? '-'}`);
     }
 }

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

@@ -19,9 +19,10 @@ class SpacesLabelsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLabelsList);
+        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);

package/dist/commands/spaces/labels/remove.js

@@ -24,6 +24,7 @@ class SpacesLabelsRemove extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLabelsRemove);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         // Detach is intentionally permissive server-side: you can remove a label
         // you can no longer read, so a revoked label never gets stuck on a space.
         // A name is resolved against the DECLARED vocabulary; an unknown one is
@@ -44,20 +45,20 @@ class SpacesLabelsRemove extends base_command_1.BaseCommand {
         }
         let result;
         try {
-            result = await data_provider_1.dataService.removeLabelFromSpace({ spaceId: args.id, labelId });
+            result = await data_provider_1.dataService.removeLabelFromSpace({ spaceId: spaceRef, labelId });
         }
         catch (err) {
             this.handleApiError(err);
         }
         const updated = (0, web_url_1.withSpaceUrl)(this.cliConfig.baseURL, {
-            id: args.id,
+            id: spaceRef,
             ...result,
         });
         if (flags.json) {
             this.log(JSON.stringify(updated, null, 2));
             return;
         }
-        this.log(`Detached label ${flags.label} from space ${args.id}`);
+        this.log(`Detached label ${flags.label} from space ${spaceRef}`);
         this.log(`URL: ${updated.url ?? '-'}`);
     }
 }

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

@@ -34,6 +34,9 @@ export default class SpacesList extends BaseCommand {
     static description: string;
     static examples: string[];
     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>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         status: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         label: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/spaces/list.js

@@ -7,6 +7,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 const format_1 = require("../../lib/format");
+const list_output_1 = require("../../lib/list-output");
 /**
  * What an empty `--q` result is allowed to claim.
  *
@@ -55,6 +56,8 @@ class SpacesList extends base_command_1.BaseCommand {
         '<%= config.bin %> spaces list --label <label-a> --label <label-b>',
         '<%= config.bin %> spaces list --q "always on"',
         '<%= config.bin %> spaces list --include-archived --json',
+        '<%= config.bin %> spaces list --compact --json',
+        '<%= config.bin %> spaces list --fields id,identifier,title --ndjson',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
@@ -87,6 +90,7 @@ class SpacesList extends base_command_1.BaseCommand {
         }),
         limit: core_1.Flags.integer({ description: 'Max results', default: 50 }),
         cursor: core_1.Flags.string({ description: 'Pagination cursor from a previous page' }),
+        ...list_output_1.listOutputFlags,
     };
     async run() {
         this.requireAuth();
@@ -105,8 +109,13 @@ class SpacesList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
-        if (flags.json) {
-            this.log(JSON.stringify((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, response, web_url_1.spaceUrlFrom), null, 2));
+        if (flags.json || flags.ndjson) {
+            this.printList((0, list_output_1.shapeListResponse)((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, response, web_url_1.spaceUrlFrom), {
+                resource: 'space',
+                fields: flags.fields,
+                compact: flags.compact,
+                requestedLimit: flags.limit,
+            }), Boolean(flags.ndjson));
             return;
         }
         const r = response;

package/dist/commands/spaces/live/cards/create.js

@@ -27,6 +27,7 @@ class SpacesLiveCardsCreate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLiveCardsCreate);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -54,13 +55,13 @@ class SpacesLiveCardsCreate extends base_command_1.BaseCommand {
             this.error('Pass --kind and --title, or provide them in JSON.', { exit: 1 });
         let result;
         try {
-            result = await data_provider_1.dataService.createSpace3DCard(args.id, payload);
+            result = await data_provider_1.dataService.createSpace3DCard(spaceRef, payload);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'live', result, ['id']), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'live', result, ['id']), null, 2));
         else
             this.log(`Created Live card ${result?.id ?? '?'}.`);
     }

package/dist/commands/spaces/live/cards/list.js

@@ -14,15 +14,16 @@ class SpacesLiveCardsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLiveCardsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpace3DCards(args.id);
+            response = await data_provider_1.dataService.listSpace3DCards(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json)
-            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'live', response, ['id']), null, 2));
+            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'live', response, ['id']), null, 2));
         (0, format_1.renderTable)(response.data.map((c) => ({
             id: c.id,
             title: c.title,

package/dist/commands/spaces/live/cards/reorder.js

@@ -18,6 +18,7 @@ class SpacesLiveCardsReorder extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLiveCardsReorder);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let raw = {};
         if (flags['from-json']) {
             try {
@@ -36,7 +37,7 @@ class SpacesLiveCardsReorder extends base_command_1.BaseCommand {
             this.error('Provide repeated --card IDs or orderedIds JSON.', { exit: 1 });
         let result;
         try {
-            result = await data_provider_1.dataService.reorderSpace3DCards(args.id, {
+            result = await data_provider_1.dataService.reorderSpace3DCards(spaceRef, {
                 orderedIds: orderedIds,
             });
         }
@@ -44,7 +45,11 @@ class SpacesLiveCardsReorder extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify({ result, orderedIds, url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'live') }, null, 2));
+            this.log(JSON.stringify({
+                result,
+                orderedIds,
+                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'live'),
+            }, null, 2));
         else
             this.log(`Reordered ${orderedIds.length} Live cards.`);
     }

package/dist/commands/spaces/live/scene.js

@@ -18,6 +18,7 @@ class SpacesLiveScene extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesLiveScene);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         if (flags.character || flags['from-json']) {
             let body = {};
@@ -32,7 +33,7 @@ class SpacesLiveScene extends base_command_1.BaseCommand {
             if (!body.characterId || typeof body.characterId !== 'string')
                 this.error('Pass --character or characterId in JSON.', { exit: 1 });
             try {
-                result = await data_provider_1.dataService.updateSpaceLiveScene(args.id, body);
+                result = await data_provider_1.dataService.updateSpaceLiveScene(spaceRef, body);
             }
             catch (err) {
                 this.handleApiError(err);
@@ -40,14 +41,14 @@ class SpacesLiveScene extends base_command_1.BaseCommand {
         }
         else {
             try {
-                result = await data_provider_1.dataService.getSpaceLiveScene(args.id);
+                result = await data_provider_1.dataService.getSpaceLiveScene(spaceRef);
             }
             catch (err) {
                 this.handleApiError(err);
             }
         }
         const output = result && typeof result === 'object'
-            ? (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'live', result)
+            ? (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'live', result)
             : result;
         this.log(JSON.stringify(output, null, 2));
     }

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

@@ -76,6 +76,7 @@ class SpacesMembersAdd extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesMembersAdd);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         const userIds = flags.user ?? [];
         const agentIds = flags.agent ?? [];
         if (userIds.length + agentIds.length === 0) {
@@ -106,8 +107,8 @@ class SpacesMembersAdd extends base_command_1.BaseCommand {
         let current;
         let result;
         try {
-            current = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, args.id);
-            result = await data_provider_1.dataService.updateResourcePermissions(data_provider_1.ResourceType.SPACE, args.id, {
+            current = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, spaceRef);
+            result = await data_provider_1.dataService.updateResourcePermissions(data_provider_1.ResourceType.SPACE, spaceRef, {
                 updated: updated,
                 removed: [],
                 public: Boolean(current.public),
@@ -117,14 +118,14 @@ class SpacesMembersAdd extends base_command_1.BaseCommand {
             if ((brief && brief.trim().length > 0) || (expertise && expertise.length > 0)) {
                 const saves = [
                     ...userIds.map((principalId) => data_provider_1.dataService.upsertSpaceBrief({
-                        spaceId: args.id,
+                        spaceId: spaceRef,
                         principalType: 'user',
                         principalId,
                         content: brief && brief.trim().length > 0 ? brief : undefined,
                         expertise,
                     })),
                     ...agentIds.map((principalId) => data_provider_1.dataService.upsertSpaceBrief({
-                        spaceId: args.id,
+                        spaceId: spaceRef,
                         principalType: 'agent',
                         principalId,
                         content: brief && brief.trim().length > 0 ? brief : undefined,
@@ -138,14 +139,14 @@ class SpacesMembersAdd extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'members', result), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', result), null, 2));
             return;
         }
         const parts = [
             userIds.length ? `${userIds.length} user(s)` : '',
             agentIds.length ? `${agentIds.length} agent(s)` : '',
         ].filter(Boolean);
-        this.log(`Added ${parts.join(' and ')} to space ${args.id} as ${flags.role}.`);
+        this.log(`Added ${parts.join(' and ')} to space ${spaceRef} as ${flags.role}.`);
     }
 }
 exports.default = SpacesMembersAdd;

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

@@ -21,17 +21,18 @@ class SpacesMembersList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesMembersList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         let briefs = [];
         try {
-            response = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, args.id);
-            briefs = (await data_provider_1.dataService.listSpaceBriefs(args.id).catch(() => [])).filter((b) => Array.isArray(b.expertise) && b.expertise.length > 0);
+            response = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, spaceRef);
+            briefs = (await data_provider_1.dataService.listSpaceBriefs(spaceRef).catch(() => [])).filter((b) => Array.isArray(b.expertise) && b.expertise.length > 0);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'members', response), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', response), null, 2));
             return;
         }
         const principals = (response.principals ?? []);

package/dist/commands/spaces/members/remove.js

@@ -32,6 +32,7 @@ class SpacesMembersRemove extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesMembersRemove);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         const userIds = flags.user ?? [];
         const agentIds = flags.agent ?? [];
         if (userIds.length + agentIds.length === 0) {
@@ -44,8 +45,8 @@ class SpacesMembersRemove extends base_command_1.BaseCommand {
         let current;
         let result;
         try {
-            current = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, args.id);
-            result = await data_provider_1.dataService.updateResourcePermissions(data_provider_1.ResourceType.SPACE, args.id, {
+            current = await data_provider_1.dataService.getResourcePermissions(data_provider_1.ResourceType.SPACE, spaceRef);
+            result = await data_provider_1.dataService.updateResourcePermissions(data_provider_1.ResourceType.SPACE, spaceRef, {
                 updated: [],
                 removed: removed,
                 public: Boolean(current.public),
@@ -53,8 +54,8 @@ class SpacesMembersRemove extends base_command_1.BaseCommand {
             });
             if (!flags['keep-brief']) {
                 const deletes = [
-                    ...userIds.map((principalId) => data_provider_1.dataService.deleteSpaceBrief(args.id, 'user', principalId).catch(() => undefined)),
-                    ...agentIds.map((principalId) => data_provider_1.dataService.deleteSpaceBrief(args.id, 'agent', principalId).catch(() => undefined)),
+                    ...userIds.map((principalId) => data_provider_1.dataService.deleteSpaceBrief(spaceRef, 'user', principalId).catch(() => undefined)),
+                    ...agentIds.map((principalId) => data_provider_1.dataService.deleteSpaceBrief(spaceRef, 'agent', principalId).catch(() => undefined)),
                 ];
                 await Promise.all(deletes);
             }
@@ -63,14 +64,14 @@ class SpacesMembersRemove extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'members', result), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', result), null, 2));
             return;
         }
         const parts = [
             userIds.length ? `${userIds.length} user(s)` : '',
             agentIds.length ? `${agentIds.length} agent(s)` : '',
         ].filter(Boolean);
-        this.log(`Removed ${parts.join(' and ')} from space ${args.id}.`);
+        this.log(`Removed ${parts.join(' and ')} from space ${spaceRef}.`);
     }
 }
 exports.default = SpacesMembersRemove;

package/dist/commands/spaces/move.js

@@ -50,6 +50,7 @@ class SpacesMove extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesMove);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let parentSpaceId;
         try {
             parentSpaceId = resolveReparentTarget(flags);
@@ -59,7 +60,7 @@ class SpacesMove extends base_command_1.BaseCommand {
         }
         let updated;
         try {
-            updated = await data_provider_1.dataService.reparentSpace(args.id, parentSpaceId);
+            updated = await data_provider_1.dataService.reparentSpace(spaceRef, parentSpaceId);
         }
         catch (err) {
             this.handleApiError(err);
@@ -70,7 +71,7 @@ class SpacesMove extends base_command_1.BaseCommand {
         }
         const s = updated;
         const dest = parentSpaceId ? `under ${parentSpaceId}` : 'to the root';
-        this.log(`Moved space ${s.id ?? s._id ?? args.id} - ${s.title ?? '(no title)'} ${dest} (depth ${s.depth ?? 0})`);
+        this.log(`Moved space ${s.id ?? s._id ?? spaceRef} - ${s.title ?? '(no title)'} ${dest} (depth ${s.depth ?? 0})`);
         // The move committed; something downstream of it did not. The server used
         // to spend a 500 on this, which said the move had not happened. Now it says
         // what is stale, and the only way that reaches a human is if we print it.

package/dist/commands/spaces/pin.js

@@ -13,21 +13,22 @@ class SpacesPin extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesPin);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.toggleSpacePin(args.id);
+            result = await data_provider_1.dataService.toggleSpacePin(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json)
             this.log(JSON.stringify({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 ...result,
-                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'settings'),
+                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'settings'),
             }, null, 2));
         else
-            this.log(`${result?.isPinned ? 'Pinned' : 'Unpinned'} space ${args.id}.`);
+            this.log(`${result?.isPinned ? 'Pinned' : 'Unpinned'} space ${spaceRef}.`);
     }
 }
 exports.default = SpacesPin;

package/dist/commands/spaces/preferences/show.js

@@ -13,6 +13,7 @@ class SpacesPreferencesShow extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesPreferencesShow);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
             response = await data_provider_1.dataService.getAllSpacePreferences();
@@ -20,9 +21,9 @@ class SpacesPreferencesShow extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
-        const preferences = response.spacePreferences?.[args.id] ?? {};
-        const output = (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'settings', {
-            spaceId: args.id,
+        const preferences = response.spacePreferences?.[spaceRef] ?? {};
+        const output = (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'settings', {
+            spaceId: spaceRef,
             preferences,
         });
         if (flags.json)

package/dist/commands/spaces/preferences/tabs.js

@@ -19,6 +19,7 @@ class SpacesPreferencesTabs extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesPreferencesTabs);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let raw = {};
         if (flags['from-json']) {
             try {
@@ -34,7 +35,7 @@ class SpacesPreferencesTabs extends base_command_1.BaseCommand {
             this.error('Provide --visible/--hidden values or JSON arrays.', { exit: 1 });
         let result;
         try {
-            result = await data_provider_1.dataService.updateSpaceTabVisibility(args.id, {
+            result = await data_provider_1.dataService.updateSpaceTabVisibility(spaceRef, {
                 visible: visible,
                 hidden: hidden,
             });
@@ -43,9 +44,9 @@ class SpacesPreferencesTabs extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify({ result, url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'settings') }, null, 2));
+            this.log(JSON.stringify({ result, url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'settings') }, null, 2));
         else
-            this.log(`Updated tab visibility for space ${args.id}.`);
+            this.log(`Updated tab visibility for space ${spaceRef}.`);
     }
 }
 exports.default = SpacesPreferencesTabs;

package/dist/commands/spaces/revisions.js

@@ -20,15 +20,16 @@ class SpacesRevisions extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesRevisions);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.listSpaceRevisions(args.id);
+            result = await data_provider_1.dataService.listSpaceRevisions(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'settings', result), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'settings', result), null, 2));
             return;
         }
         const items = result?.data ?? [];

package/dist/commands/spaces/room/ensure.js

@@ -18,12 +18,13 @@ class SpacesRoomEnsure extends space_room_1.SpaceRoomCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesRoomEnsure);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         // Idempotent — the same POST the web Room tab issues on mount. Safe to run
         // repeatedly: it creates the room only when absent, and otherwise just
         // reconciles the chat's participants/agents against the space membership.
-        const payload = await this.fetchRoom(args.id, { ensure: true });
+        const payload = await this.fetchRoom(spaceRef, { ensure: true });
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'room', payload), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'room', payload), null, 2));
             return;
         }
         const room = payload.spaceRoom;
@@ -32,8 +33,8 @@ class SpacesRoomEnsure extends space_room_1.SpaceRoomCommand {
         const changes = (0, space_room_1.describeReconciliation)(room);
         this.log(changes ? `Reconciled: ${changes}` : 'Membership already up to date.');
         this.log('');
-        this.log(`Read:  ${this.config.bin} spaces room messages ${args.id}`);
-        this.log(`Send:  ${this.config.bin} spaces room send ${args.id} -m "..."`);
+        this.log(`Read:  ${this.config.bin} spaces room messages ${spaceRef}`);
+        this.log(`Send:  ${this.config.bin} spaces room send ${spaceRef} -m "..."`);
     }
 }
 exports.default = SpacesRoomEnsure;

package/dist/commands/spaces/room/messages.js

@@ -29,7 +29,8 @@ class SpacesRoomMessages extends space_room_1.SpaceRoomCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesRoomMessages);
-        const groupChatId = await this.resolveRoomChatId(args.id);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
+        const groupChatId = await this.resolveRoomChatId(spaceRef);
         let response;
         try {
             response = await data_provider_1.dataService.getGroupChatMessages(groupChatId, {
@@ -42,7 +43,7 @@ class SpacesRoomMessages extends space_room_1.SpaceRoomCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'room', response, [
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'room', response, [
                 'id',
                 'messageId',
                 '_id',