@neta-art/cohub-cli 6.6.0 → 6.8.0

package/README.md

@@ -299,10 +299,9 @@ Confirm before deleting files or directories.
 
 Publish and manage Apps from a Space workspace. Public App URLs require a username and a Space slug.
 
-`--file` and `--dir` take paths relative to the Space workspace — the same paths
-`spaces files ls` shows, not your local filesystem. To publish local build
-output, upload it first (`spaces files upload <dir>`), then publish the
-Space-side path.
+`apps publish` detects the source from the runtime by default: local CLI runs use local
+filesystem paths, while Cohub Sandbox runs use Space workspace paths. Pass
+`--source workspace` or `--source local` to override the default explicitly.
 
 ```bash
 cohub profile update --username <username>
@@ -311,8 +310,9 @@ cohub -s <spaceId> apps ls --json
 cohub apps get <appId|url|username/space/app> --json
 cohub apps stats <appId|url|username/space/app>
 cohub apps download <appId|url|username/space/app> --output <path>
-cohub -s <spaceId> apps publish demo --file dist/index.html
-cohub -s <spaceId> apps publish site --dir dist
+cohub -s <spaceId> apps publish demo --file ./dist/index.html
+cohub -s <spaceId> apps publish site --dir ./dist
+cohub -s <spaceId> apps publish site --source workspace --dir dist
 cohub -s <spaceId> apps publish app --port 3000
 cohub apps publish-version <appId>
 cohub apps versions <appId> --json

package/dist/commands/apps.js

@@ -1,4 +1,7 @@
-import { HttpError } from "@neta-art/cohub";
+import { randomUUID } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { basename } from "node:path";
+import { getCohubContext, HttpError } from "@neta-art/cohub";
 import { createClient, createClientWithAccessToken } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
 import { resolveSpace } from "../space.js";
@@ -6,6 +9,7 @@ import { downloadApp } from "../app-download.js";
 import { getAppByRef, parseAppRef } from "../app-ref.js";
 import { checkAppTarget } from "../app-target.js";
 import { registerAppCommerce } from "./app-commerce.js";
+import { collectPublicUpload } from "./public.js";
 const APP_STATUSES = ["published", "disabled"];
 const APP_VISIBILITIES = ["public", "space"];
 const collectOption = (value, previous = []) => [...previous, value];
@@ -57,6 +61,72 @@ function withCohubBarMeta(input) {
         delete meta.presentation;
     return Object.keys(meta).length > 0 ? meta : null;
 }
+const MAX_APP_SOURCE_FILES = 1000;
+const MAX_APP_SOURCE_BYTES = 1024 * 1024 * 1024;
+const APP_SOURCE_UPLOAD_CONCURRENCY = 4;
+async function uploadLocalAppSource(client, spaceId, source) {
+    if (source.targetType === "port")
+        return null;
+    const upload = await collectPublicUpload(source.targetRef);
+    const totalBytes = upload.files.reduce((sum, file) => sum + file.size, 0);
+    if (upload.files.length > MAX_APP_SOURCE_FILES)
+        return error("App source is too large", `Use no more than ${MAX_APP_SOURCE_FILES} files.`);
+    if (totalBytes > MAX_APP_SOURCE_BYTES)
+        return error("App source is too large", "The total source size must not exceed 1 GiB.");
+    const uploadId = randomUUID();
+    const directoryPrefix = source.targetType === "directory" ? upload.destination.replace(/\/$/, "") : "";
+    const files = new Array(upload.files.length);
+    let nextIndex = 0;
+    const workers = Array.from({ length: Math.min(APP_SOURCE_UPLOAD_CONCURRENCY, upload.files.length) }, async () => {
+        while (nextIndex < upload.files.length) {
+            const index = nextIndex++;
+            const file = upload.files[index];
+            if (!file)
+                return;
+            const plan = await client.publicAssets.createUpload({
+                purpose: "app_source",
+                uploadProtocol: "presigned_put_v1",
+                spaceId,
+                sessionId: uploadId,
+                file: { size: file.size, mimeType: file.mimeType, filename: basename(file.publicPath) },
+            });
+            const response = await fetch(plan.asset.uploadUrl, {
+                method: "PUT",
+                headers: plan.asset.uploadHeaders,
+                body: createReadStream(file.localPath),
+                duplex: "half",
+            });
+            if (!response.ok)
+                throw new Error(`Failed to upload ${file.publicPath}: HTTP ${response.status}`);
+            const path = directoryPrefix && file.publicPath.startsWith(`${directoryPrefix}/`)
+                ? file.publicPath.slice(directoryPrefix.length + 1)
+                : basename(file.publicPath);
+            files[index] = { path, objectKey: plan.asset.objectKey, size: file.size, mimeType: file.mimeType };
+        }
+    });
+    await Promise.all(workers);
+    const manifest = JSON.stringify({ kind: "cohub.app-source", version: 1, targetType: source.targetType, files });
+    const manifestBlob = new Blob([manifest], { type: "application/json" });
+    const manifestPlan = await client.publicAssets.createUpload({
+        purpose: "app_source",
+        uploadProtocol: "presigned_put_v1",
+        spaceId,
+        sessionId: uploadId,
+        file: { size: manifestBlob.size, mimeType: "application/json", filename: "manifest.json" },
+    });
+    const manifestResponse = await fetch(manifestPlan.asset.uploadUrl, {
+        method: "PUT",
+        headers: manifestPlan.asset.uploadHeaders,
+        body: manifestBlob,
+    });
+    if (!manifestResponse.ok)
+        throw new Error(`Failed to upload app source manifest: HTTP ${manifestResponse.status}`);
+    const manifestAsset = manifestPlan.asset;
+    return { sourceRef: manifestAsset.objectKey, targetRef: source.targetType === "file" ? files[0]?.path ?? "" : "." };
+}
+function resolveDefaultAppSource() {
+    return getCohubContext().runtime.kind === "sandbox" ? "workspace" : "local";
+}
 function resolveTarget(opts) {
     const targets = [
         opts.file ? { targetType: "file", targetRef: opts.file } : null,
@@ -197,7 +267,7 @@ export function registerApps(program) {
         .description("List apps in the target space")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(appsCmd);
+        const spaceId = await resolveSpace(appsCmd);
         const client = createClient();
         try {
             const result = await client.apps.listBySpace(spaceId);
@@ -321,8 +391,9 @@ export function registerApps(program) {
     appsCmd
         .command("publish <slug>")
         .description("Create or publish an app in the target space")
-        .option("--file <path>", "Publish a file (HTML page, board, or any other file) from the Space workspace")
-        .option("--dir <path>", "Publish a directory site from the Space workspace")
+        .option("--source <source>", "Source: workspace or local (auto-detected from runtime by default)")
+        .option("--file <path>", "Publish a file from the selected source")
+        .option("--dir <path>", "Publish a directory site from the selected source")
         .option("--port <port>", "Publish a public sandbox port")
         .option("--disabled", "Create as disabled")
         .option("--status <status>", "App status: published, disabled")
@@ -339,27 +410,42 @@ export function registerApps(program) {
         const target = resolveTarget(opts);
         if (!target)
             return error("Missing target", "Use one of --file, --dir, or --port.");
-        const spaceId = resolveSpace(appsCmd);
+        const source = opts.source ? parseChoice(opts.source, "source", ["workspace", "local"]) : resolveDefaultAppSource();
+        if (target.targetType === "port" && opts.source)
+            return error("Invalid source", "--source applies only to --file and --dir.");
+        const spaceId = await resolveSpace(appsCmd);
         const client = createClient();
-        const { targetType, targetRef } = target;
-        if (targetType !== "port")
+        let { targetType, targetRef } = target;
+        let sourceRef = null;
+        if (source === "local") {
+            const uploaded = await uploadLocalAppSource(client, spaceId, target);
+            if (!uploaded)
+                return error("Invalid source", "--source local applies only to --file and --dir.");
+            targetRef = uploaded.targetRef;
+            sourceRef = uploaded.sourceRef;
+        }
+        else if (targetType !== "port") {
             await guardAppTarget(client, spaceId, { targetType, targetRef });
+        }
         const status = resolveStatus(opts);
         const meta = withCohubBarMeta({
             meta: parseJsonObject(opts.meta, "meta"),
             hideCohubBar: opts.hideCohubBar,
             showCohubBar: opts.showCohubBar,
         });
+        const publishMeta = source === "local"
+            ? { ...(meta ?? {}), runtime: { source: { type: "upload", ref: sourceRef } } }
+            : meta;
         const input = {
             spaceId,
             slug,
             status,
             visibility: resolveVisibility(opts.visibility),
             targetType: target.targetType,
-            targetRef: target.targetRef,
+            targetRef,
             appScopes: opts.appScope,
             allowedViewerScopes: opts.viewerScope,
-            meta,
+            meta: publishMeta,
         };
         try {
             const result = await client.apps.create(input);
@@ -381,10 +467,10 @@ export function registerApps(program) {
                     status: status === "published" && existingApp.status !== "published" ? existingApp.status : status,
                     visibility: resolveVisibility(opts.visibility),
                     targetType: target.targetType,
-                    targetRef: target.targetRef,
+                    targetRef,
                     appScopes: opts.appScope,
                     allowedViewerScopes: opts.viewerScope,
-                    meta,
+                    meta: publishMeta,
                 });
                 const publishedVersion = status === "published"
                     ? await client.apps.publishVersion(app.id)

package/dist/commands/auth.js

@@ -1,4 +1,5 @@
 import { authSource, loginWithDeviceFlow, readAuthSession, refreshAccessToken, requestDeviceCode, revokeAndClearAuthSession, verifyDeviceCode } from "../auth.js";
+import { clearDefaultSpaceCache } from "../space.js";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, ok, error, spinner, handleHttp } from "../output.js";
 export function registerAuth(program) {
@@ -67,6 +68,7 @@ export function registerAuth(program) {
         .description("Clear stored Logto session")
         .action(async () => {
         await revokeAndClearAuthSession();
+        clearDefaultSpaceCache();
         if (process.env.COHUB_EXECUTION_TOKEN?.trim()) {
             ok("Local session cleared. COHUB_EXECUTION_TOKEN is still set.");
         }

package/dist/commands/boards/context.js

@@ -24,7 +24,7 @@ export function readOptions(command, label = "Comma-separated resource IDs") {
     return command.option("--ids <ids>", label);
 }
 export async function resolvedBoard(boards, target) {
-    const spaceId = resolveSpace(boards);
+    const spaceId = await resolveSpace(boards);
     const boardId = await resolveBoardId(spaceId, target);
     return createClient().space(spaceId).board(boardId);
 }

package/dist/commands/boards.js

@@ -171,7 +171,7 @@ function registerExportCommand(boards) {
             if (!out)
                 throw new Error("--out is required");
             const result = await runBoardExport({
-                spaceId: resolveSpace(boards),
+                spaceId: await resolveSpace(boards),
                 target: board,
                 region: parseExportRegion(options),
                 scale: parseNumber(options.scale ?? "2", "scale", { min: 0.01, max: 16 }),
@@ -213,7 +213,7 @@ export function registerBoards(program) {
     const boards = program
         .command("boards")
         .description("Inspect and update Boards by ID or .board path")
-        .hook("preAction", () => { resolveSpace(boards); });
+        .hook("preAction", async () => { await resolveSpace(boards); });
     withJson(boards.command("create <path>")
         .description("Create a Board")
         .option("--title <title>", "Board title")
@@ -239,7 +239,7 @@ Generate an editable seed:
                     (typeof content.mutationId === "string" ? content.mutationId : randomUUID()),
                 ...(options.title ? { title: options.title } : {}),
             };
-            const result = await createClient().space(resolveSpace(boards)).boards.create(input);
+            const result = await createClient().space(await resolveSpace(boards)).boards.create(input);
             if (jsonRequested(options))
                 return outJson({ ...result, path });
             ok(`Board created: ${path}`);
@@ -262,7 +262,7 @@ Apply multiple changes atomically:
   cohub boards batch <board> --input changes.json --dry-run`))
         .action(async (target, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const result = await createClient().space(spaceId).board(boardId).summary();
             if (jsonRequested(options))
@@ -283,7 +283,7 @@ Coordinates:
 Use boards examples for editable starter JSON.`))
         .action(async (target, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const result = await createClient().space(spaceId).board(boardId).capabilities();
             if (jsonRequested(options))
@@ -330,7 +330,7 @@ Use boards examples for editable starter JSON.`))
         .option("--command-id <id>", "Idempotency command ID"))
         .action(async (target, compositionId, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const result = await createClient().space(spaceId).board(boardId).play({
                 commandId: commandId(options),
@@ -351,7 +351,7 @@ Use boards examples for editable starter JSON.`))
     });
     const playbackAction = (type) => async (target, playbackId, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const board = createClient().space(spaceId).board(boardId);
             const id = commandId(options);
@@ -375,7 +375,7 @@ Use boards examples for editable starter JSON.`))
         .option("--command-id <id>", "Idempotency command ID"))
         .action(async (target, playbackId, position, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const result = await createClient().space(spaceId).board(boardId).seek({
                 commandId: commandId(options),
@@ -399,7 +399,7 @@ Use boards examples for editable starter JSON.`))
         .description("Stream Board events"))
         .action(async (target, options) => {
         try {
-            const spaceId = resolveSpace(boards);
+            const spaceId = await resolveSpace(boards);
             const boardId = await resolveBoardId(spaceId, target);
             const client = createRealtimeClient();
             const board = client.space(spaceId).board(boardId);

package/dist/commands/desktop.js

@@ -7,6 +7,7 @@ import { getAppByRef } from "../app-ref.js";
 const FILE_SCHEME = "file://";
 const APP_SCHEME = "app://";
 const LEGACY_WORK_SCHEME = "work://";
+/** Optional disambiguation for file:// vs app:// — do not fall back to Home. */
 function optionalSpaceId(command) {
     let current = command;
     while (current) {

package/dist/commands/generations.js

@@ -257,7 +257,7 @@ Examples:
 `)
         .action(async (prompt, opts) => {
         try {
-            const spaceId = resolveSpace(program);
+            const spaceId = await resolveSpace(program);
             const content = [{ type: "text", text: prompt }];
             content.push(...await Promise.all(opts.image.map((value) => contentFromPathOrUrl("image", value))));
             content.push(...await Promise.all(opts.video.map((value) => contentFromPathOrUrl("video", value))));

package/dist/commands/public.js

@@ -179,7 +179,7 @@ function publicUrlPrefix(destination, entry) {
 }
 async function uploadPublic(command, source, destination, opts, deps) {
     const client = deps.createClient?.() ?? createClient();
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     try {
         const upload = await collectPublicUpload(source, destination);
         const plan = await client.space(spaceId).publicFiles.createUpload({
@@ -244,7 +244,7 @@ async function uploadPublic(command, source, destination, opts, deps) {
 async function listPublic(command, path, opts, deps) {
     const client = deps.createClient?.() ?? createClient();
     try {
-        const publicFiles = client.space(resolveSpace(command)).publicFiles;
+        const publicFiles = client.space(await resolveSpace(command)).publicFiles;
         const entries = [];
         let cursor;
         do {
@@ -271,7 +271,7 @@ async function listPublic(command, path, opts, deps) {
 async function printPublicUrl(command, path, deps) {
     const client = deps.createClient?.() ?? createClient();
     try {
-        const result = await client.space(resolveSpace(command)).publicFiles.url(path);
+        const result = await client.space(await resolveSpace(command)).publicFiles.url(path);
         console.log(result.url);
     }
     catch (exception) {

package/dist/commands/run.js

@@ -1,5 +1,6 @@
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, spinner } from "../output.js";
+import { missingSpaceError, resolveDefaultSpace } from "../space.js";
 const DEFAULT_WAIT_TIMEOUT_MS = (6 * 60 * 60 + 60) * 1000;
 const DEFAULT_POLL_INTERVAL_MS = 1500;
 function shellQuote(value) {
@@ -43,13 +44,13 @@ function parseSpaceId(tokens) {
     }
     return undefined;
 }
-function parseRunCliOptions(argv) {
+async function parseRunCliOptions(argv) {
     const runIndex = topLevelRunIndex(argv);
     if (runIndex < 0)
         return error("Invalid invocation", "Use `cohub run [options] <command>`");
     const beforeRun = argv.slice(0, runIndex);
     const afterRun = argv.slice(runIndex + 1);
-    let spaceId = parseSpaceId(beforeRun) ?? process.env.COHUB_SPACE_ID?.trim() ?? "";
+    const explicitSpaceId = parseSpaceId(beforeRun) ?? process.env.COHUB_SPACE_ID?.trim() ?? "";
     let json = beforeRun.includes("--json");
     let async = false;
     let commandOption = null;
@@ -103,9 +104,7 @@ function parseRunCliOptions(argv) {
     if (!command) {
         return error("No command", "Pass --command <shell command>, or use `--` followed by the command.");
     }
-    if (!spaceId) {
-        return error("Missing required space", "Add -s, --space <id> before `run` or set COHUB_SPACE_ID.");
-    }
+    const spaceId = explicitSpaceId || (await resolveDefaultSpace().catch(handleHttp)) || missingSpaceError();
     return { spaceId, json, async, command };
 }
 function printRunHelp() {
@@ -126,6 +125,7 @@ Examples:
   cohub -s <spaceId> run -- git status -sb
 
 Notes:
+  - Without -s or COHUB_SPACE_ID, the command targets your Home space.
   - Use --command for commands that contain leading flags, or use -- before the shell command.
   - The command runs in /workspace.
 `);
@@ -199,7 +199,7 @@ async function waitForRunCompletion(taskRunId, showSpinner) {
     }
 }
 async function handleRunCli(argv) {
-    const opts = parseRunCliOptions(argv);
+    const opts = await parseRunCliOptions(argv);
     const client = createClient();
     try {
         const { taskRunId } = await client.space(opts.spaceId).runCommand({ command: opts.command });

package/dist/commands/sandbox.js

@@ -5,7 +5,7 @@ import { basename, resolve } from "node:path";
 import { resolveCohubEnvironment, resolveWebsocketUrl } from "@neta-art/cohub";
 import { requireAccessToken } from "../auth.js";
 import { createClient } from "../client.js";
-import { error, json as outJson, jsonRequested, ok, spinner } from "../output.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, spinner } from "../output.js";
 import { resolveSpace } from "../space.js";
 import { ensureSandboxdBinary, SandboxdDownloadError } from "./sandboxd-binary.js";
 // Derive the gateway relay control endpoint from the realtime websocket URL,
@@ -154,18 +154,22 @@ export function registerSandbox(program) {
         .option("-s, --space <id>", "Target space ID")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = opts.space?.trim() || resolveSpace(program);
+        const spaceId = opts.space?.trim() || await resolveSpace(program);
         const client = createClient();
-        const result = await client.space(spaceId).sandbox.get().catch(() => null);
-        const sandbox = result?.sandbox ?? null;
-        if (jsonRequested(opts))
-            return outJson({ spaceId, sandbox });
-        if (!sandbox) {
-            console.log("  (no sandbox)");
-            return;
+        try {
+            const sandbox = (await client.space(spaceId).sandbox.get()).sandbox ?? null;
+            if (jsonRequested(opts))
+                return outJson({ spaceId, sandbox });
+            if (!sandbox) {
+                console.log("  (no sandbox)");
+                return;
+            }
+            console.log(`  space:    ${spaceId}`);
+            console.log(`  provider: ${sandbox.provider ?? "cloud"}`);
+            console.log(`  status:   ${sandbox.status ?? "unknown"}`);
+        }
+        catch (cause) {
+            handleHttp(cause);
         }
-        console.log(`  space:    ${spaceId}`);
-        console.log(`  provider: ${sandbox.provider ?? "cloud"}`);
-        console.log(`  status:   ${sandbox.status ?? "unknown"}`);
     });
 }

package/dist/commands/sandboxd-binary.js

@@ -19,7 +19,7 @@ const BINARY_NAME = "cohub-sandboxd";
 // Public CDN prefix hosting the release archives (the repo is private, so the
 // GitHub Release assets are not publicly downloadable). Overridable for staging
 // or self-hosting.
-const cdnBaseUrl = () => (process.env.COHUB_SANDBOXD_CDN_BASE_URL?.trim() || "https://public.cohub.run/sandboxd").replace(/\/+$/, "");
+const cdnBaseUrl = () => (process.env.COHUB_SANDBOXD_CDN_BASE_URL?.trim() || "https://public.cohub.live/sandboxd").replace(/\/+$/, "");
 const DOWNLOAD_TIMEOUT_MS = 120_000;
 const LOCK_STALE_MS = 5 * 60 * 1000;
 // Map Node's platform/arch to the Go GOOS/GOARCH used in release asset names.

package/dist/commands/space-activity.js

@@ -124,7 +124,7 @@ export function registerSpaceActivity(spacesCmd, dependencies = {}) {
         .description("Space activity overview: usage, contributors, rankings")
         .option("--json", "Output as JSON")
         .action(async (days, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         let parsedDays;
         try {
             parsedDays = parseActivityDays(days);

package/dist/commands/space-commerce.js

@@ -153,8 +153,8 @@ async function confirmDanger(opts, detail) {
     if (answer !== "y" && answer !== "yes")
         return error("Cancelled");
 }
-function commerceClient(spacesCmd) {
-    const spaceId = resolveSpace(spacesCmd);
+async function commerceClient(spacesCmd) {
+    const spaceId = await resolveSpace(spacesCmd);
     return { spaceId, commerce: createClient().space(spaceId).commerce };
 }
 export function registerSpaceCommerce(spacesCmd) {
@@ -172,7 +172,7 @@ Examples:
         .description("Initialize commerce for the target space")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.setup();
             if (jsonRequested(opts))
@@ -196,7 +196,7 @@ Examples:
         .description("List products")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.listProducts();
             if (jsonRequested(opts))
@@ -235,7 +235,7 @@ Examples:
             status: parseChoice(opts.status, "status", PRODUCT_STATUSES),
             visibility: parseChoice(opts.visibility, "visibility", PRODUCT_VISIBILITIES),
         };
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.createProduct(input);
             if (jsonRequested(opts))
@@ -269,7 +269,7 @@ Examples:
         });
         if (Object.keys(input).length === 0)
             return error("Nothing to update", "Pass --name, --description, --clear-description, --status, or --visibility.");
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.updateProduct(productKey, input);
             if (jsonRequested(opts))
@@ -290,7 +290,7 @@ Examples:
         .action(async (opts) => {
         const productKey = requireText(opts.productKey, "product key", "--product-key <key>");
         await confirmDanger(opts, `archive product "${productKey}"`);
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.updateProduct(productKey, { status: "archived" });
             if (jsonRequested(opts))
@@ -314,7 +314,7 @@ Examples:
         .description("List benefits")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.listBenefits();
             if (jsonRequested(opts))
@@ -353,7 +353,7 @@ Examples:
                     ? parseInteger(opts.expiresInDays, "expires-in-days", { fallback: 0, min: 1 })
                     : undefined,
             };
-            const { commerce } = commerceClient(spacesCmd);
+            const { commerce } = await commerceClient(spacesCmd);
             try {
                 const result = await commerce.createBenefit(input);
                 if (jsonRequested(opts))
@@ -373,7 +373,7 @@ Examples:
             type: "feature",
             metadata: parseMetadataJson(opts.metadataJson),
         };
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.createBenefit(input);
             if (jsonRequested(opts))
@@ -407,7 +407,7 @@ Examples:
         });
         if (Object.keys(input).length === 0)
             return error("Nothing to update", "Pass --name, --description, --clear-description, --status, or --metadata-json.");
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.updateBenefit(benefitKey, input);
             if (jsonRequested(opts))
@@ -428,7 +428,7 @@ Examples:
         .action(async (opts) => {
         const benefitKey = requireText(opts.benefitKey, "benefit key", "--benefit-key <key>");
         await confirmDanger(opts, `archive benefit "${benefitKey}"`);
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.updateBenefit(benefitKey, { status: "archived" });
             if (jsonRequested(opts))
@@ -450,7 +450,7 @@ Examples:
             productKey: requireText(opts.productKey, "product key", "--product-key <key>"),
             benefitKey: requireText(opts.benefitKey, "benefit key", "--benefit-key <key>"),
         };
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.bindProductBenefit(input);
             if (jsonRequested(opts))
@@ -474,7 +474,7 @@ Examples:
             benefitKey: requireText(opts.benefitKey, "benefit key", "--benefit-key <key>"),
         };
         await confirmDanger(opts, `unbind benefit "${input.benefitKey}" from product "${input.productKey}"`);
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.unbindProductBenefit(input);
             if (jsonRequested(opts))
@@ -495,7 +495,7 @@ Examples:
         .option("--limit <limit>", "Page size, max 50")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const { commerce } = commerceClient(spacesCmd);
+        const { commerce } = await commerceClient(spacesCmd);
         try {
             const result = await commerce.listOrders({
                 page: parseInteger(opts.page, "page", { fallback: 1, min: 1 }),

package/dist/commands/space-invitations.js

@@ -72,7 +72,7 @@ export function registerSpaceInvitations(spacesCommand, dependencies = {
         .option("--max-uses <count>", "Usage limit, or 0 for unlimited", "0")
         .option("--json", "Output as JSON")
         .action(async (options) => {
-        const spaceId = resolveSpace(spacesCommand);
+        const spaceId = await resolveSpace(spacesCommand);
         let input;
         try {
             input = parseSpaceInvitationCreateOptions(options);
@@ -111,7 +111,7 @@ export function registerSpaceInvitations(spacesCommand, dependencies = {
         .description("List invite links")
         .option("--json", "Output as JSON")
         .action(async (options) => {
-        const spaceId = resolveSpace(spacesCommand);
+        const spaceId = await resolveSpace(spacesCommand);
         try {
             const result = await dependencies
                 .createClient()
@@ -150,7 +150,7 @@ export function registerSpaceInvitations(spacesCommand, dependencies = {
         .option("--json", "Output as JSON")
         .action(async (code, options) => {
         await confirmRevoke(options);
-        const spaceId = resolveSpace(spacesCommand);
+        const spaceId = await resolveSpace(spacesCommand);
         try {
             const result = await dependencies
                 .createClient()

package/dist/commands/space-turns.js

@@ -82,8 +82,8 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
     const turnsCmd = spacesCmd
         .command("turns")
         .description("Browse turns across the space")
-        .hook("preAction", () => {
-        resolveSpace(spacesCmd);
+        .hook("preAction", async () => {
+        await resolveSpace(spacesCmd);
     });
     turnsCmd
         .command("ls")
@@ -108,7 +108,7 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
             }
             throw cause;
         }
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = dependencies.createClient?.() ?? createClient();
         try {
             try {
@@ -179,7 +179,7 @@ export function registerSpaceTurns(spacesCmd, dependencies = {}) {
         .description("Read persisted intermediate messages from the CDN archive")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, options) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = dependencies.createClient?.() ?? createClient();
         try {
             const archive = await client.space(spaceId).session(sessionId).turns.intermediate.get(turnId);