@neta-art/cohub-cli 6.6.0 → 6.8.0

package/dist/commands/spaces.js

@@ -168,7 +168,7 @@ async function putUploadEntry(entry, uploadUrl, headers) {
     }
 }
 async function uploadFiles(command, paths, opts) {
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const client = createClient();
     try {
         const files = await collectUploadFiles(paths);
@@ -242,7 +242,7 @@ async function sendPrompt(command, words, opts) {
         && !new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]).has(thinkingLevel)) {
         return error("Invalid thinking level", "Use off|minimal|low|medium|high|xhigh|max");
     }
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const client = createClient();
     try {
         const schedule = opts.delayMs
@@ -304,7 +304,7 @@ async function sendPrompt(command, words, opts) {
     }
 }
 async function runCompletionCommand(command, words, opts) {
-    const spaceId = resolveSpace(command);
+    const spaceId = await resolveSpace(command);
     const content = words.join(" ").trim();
     if (!content && process.stdin.isTTY) {
         return error("Message required", "Pass content args or pipe via stdin");
@@ -490,7 +490,7 @@ export function registerSpaces(program) {
         .description("Show space details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = id?.trim() || resolveSpace(spacesCmd);
+        const spaceId = id?.trim() || await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const space = await client.spaces.get(spaceId);
@@ -562,7 +562,7 @@ export function registerSpaces(program) {
         .description("Upload the space avatar")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const asset = await uploadAvatarAsset({ client, purpose: "space_avatar", spaceId, path });
@@ -699,7 +699,7 @@ export function registerSpaces(program) {
         .description("Space usage statistics (default: 30 days)")
         .option("--json", "Output as JSON")
         .action(async (days, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const usage = await client.space(spaceId).usage.get(parseInteger(days ?? "30", "days", { min: 1 }));
@@ -737,14 +737,14 @@ function registerLabels(spacesCmd) {
     const labelsCmd = spacesCmd
         .command("labels")
         .description("Manage labels")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     labelsCmd
         .command("ls")
         .alias("list")
         .description("List labels")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.list();
@@ -764,7 +764,7 @@ function registerLabels(spacesCmd) {
         .description("Create a label")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.create(labelRef);
@@ -784,7 +784,7 @@ function registerLabels(spacesCmd) {
         .option("--rank <n>", "Sort rank")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.update(labelRef, {
@@ -805,7 +805,7 @@ function registerLabels(spacesCmd) {
         .alias("delete")
         .description("Delete a label")
         .action(async (labelRef) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).labels.delete(labelRef);
@@ -820,7 +820,7 @@ function registerLabels(spacesCmd) {
         .description("Reorder labels")
         .option("--json", "Output as JSON")
         .action(async (labelRefs, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.reorder(labelRefs);
@@ -839,7 +839,7 @@ function registerLabels(spacesCmd) {
         .option("--cursor <cursor>", "Page cursor")
         .option("--json", "Output as JSON")
         .action(async (labelRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.listItems(labelRef, {
@@ -864,7 +864,7 @@ function registerLabels(spacesCmd) {
         .description("Attach a label")
         .option("--json", "Output as JSON")
         .action(async (labelRef, resourceType, resourceRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.attach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
@@ -880,7 +880,7 @@ function registerLabels(spacesCmd) {
         .command("detach <labelRef> <resourceType> <resourceRef>")
         .description("Detach a label")
         .action(async (labelRef, resourceType, resourceRef) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).labels.detach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
@@ -897,7 +897,7 @@ function registerLabels(spacesCmd) {
         .option("--remove <refs>", "Comma-separated label refs to remove")
         .option("--json", "Output as JSON")
         .action(async (resourceType, resourceRef, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).labels.patchResourceLabels(parseLabelResourceType(resourceType), resourceRef, {
@@ -918,7 +918,7 @@ function registerLabels(spacesCmd) {
         .option("--labels <refs>", "Comma-separated label refs")
         .option("--json", "Output as JSON")
         .action(async (resourceType, resourceRef, labelRefs, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const refs = [...parseLabelRefs(opts.labels), ...labelRefs];
@@ -936,14 +936,14 @@ function registerMods(spacesCmd) {
     const modsCmd = spacesCmd
         .command("mods")
         .description("Manage space mods")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     modsCmd
         .command("ls")
         .alias("list")
         .description("List mods")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.list();
@@ -969,7 +969,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modSpaceId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.create({ modSpaceId, name: opts.name, mountSlug: opts.slug });
@@ -988,7 +988,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.update(modId, { enabled: true });
@@ -1007,7 +1007,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.update(modId, { enabled: false });
@@ -1027,7 +1027,7 @@ function registerMods(spacesCmd) {
         .option("--json", "Output as JSON")
         .action(async (modId, opts) => {
         await confirmRestart(opts);
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).mods.remove(modId);
@@ -1111,14 +1111,14 @@ function registerFiles(spacesCmd) {
     const filesCmd = spacesCmd
         .command("files")
         .description("File operations")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     filesCmd
         .command("ls [path]")
         .alias("list")
         .description("List directory tree")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const tree = await client.space(spaceId).files.list(path ?? "");
@@ -1143,7 +1143,7 @@ function registerFiles(spacesCmd) {
         .command("cat <path>")
         .description("Read file content")
         .action(async (path) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const file = await client.space(spaceId).files.read(path);
@@ -1173,7 +1173,7 @@ function registerFiles(spacesCmd) {
         }
         if (!content)
             return error("No content provided", "Use -c or pipe via stdin");
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).files.write({
@@ -1197,7 +1197,7 @@ function registerFiles(spacesCmd) {
         .command("mkdir <path>")
         .description("Create a directory")
         .action(async (path) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.createDir(path);
@@ -1212,7 +1212,7 @@ function registerFiles(spacesCmd) {
         .description("Delete a file or directory")
         .option("-r, --recursive", "Delete recursively")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.delete(path, opts.recursive ?? false);
@@ -1226,7 +1226,7 @@ function registerFiles(spacesCmd) {
         .command("mv <from> <to>")
         .description("Move or rename")
         .action(async (from, to) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).files.move({ fromPath: from, toPath: to });
@@ -1241,7 +1241,7 @@ function registerFiles(spacesCmd) {
         .description("Show pending workspace changes vs last checkpoint")
         .option("--json", "Output as JSON")
         .action(async (path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             if (path) {
@@ -1272,14 +1272,14 @@ function registerSessions(spacesCmd) {
     const sessionsCmd = spacesCmd
         .command("sessions")
         .description("Browse sessions and turns")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     sessionsCmd
         .command("ls")
         .alias("list")
         .description("List sessions")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).sessions.list();
@@ -1306,7 +1306,7 @@ function registerSessions(spacesCmd) {
         .option("--label <ref>", "Attach a label, e.g. Bug or Area/Frontend", collectOption, [])
         .option("--json", "Output as JSON")
         .action(async (title, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).sessions.create({
@@ -1330,7 +1330,7 @@ function registerSessions(spacesCmd) {
         .description("Session details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(id).get();
@@ -1352,7 +1352,7 @@ function registerSessions(spacesCmd) {
         .command("rename <id> <name>")
         .description("Rename a session")
         .action(async (id, name) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).session(id).rename(name);
@@ -1368,7 +1368,7 @@ function registerSessions(spacesCmd) {
         .description("Stream realtime session events")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         const session = client.space(spaceId).session(id);
         process.stdout.write("  Listening for events...\n\n");
@@ -1423,7 +1423,7 @@ function registerTurns(sessionsCmd) {
         .option("--limit <n>", "Page size", "30")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.listPaginated({
@@ -1455,7 +1455,7 @@ function registerTurns(sessionsCmd) {
         .description("Show turn details")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.get(turnId);
@@ -1484,7 +1484,7 @@ function registerTurns(sessionsCmd) {
         .description("Run a queued follow-up now")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).steerTurn(turnId);
@@ -1501,7 +1501,7 @@ function registerTurns(sessionsCmd) {
         .description("Cancel a queued follow-up")
         .option("--json", "Output as JSON")
         .action(async (sessionId, turnId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).cancelTurn(turnId);
@@ -1520,7 +1520,7 @@ function registerTurns(sessionsCmd) {
         .option("--limit <n>", "Page size", "100")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).session(sessionId).turns.index({
@@ -1554,7 +1554,7 @@ function registerTurns(sessionsCmd) {
         .option("--after <n>", "Turns after anchor", "20")
         .option("--json", "Output as JSON")
         .action(async (sessionId, opts) => {
-        const spaceId = resolveSpace(sessionsCmd);
+        const spaceId = await resolveSpace(sessionsCmd);
         if (!opts.sequence && !opts.turn)
             return error("Missing anchor", "Use --sequence <n> or --turn <id>");
         const client = createClient();
@@ -1647,14 +1647,14 @@ function registerMembers(spacesCmd) {
     const memCmd = spacesCmd
         .command("members")
         .description("Member management")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     memCmd
         .command("ls")
         .alias("list")
         .description("List space members")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).members.list();
@@ -1678,7 +1678,7 @@ function registerMembers(spacesCmd) {
         .command("update <userId> <role>")
         .description("Change member role (host | builder | guest)")
         .action(async (userId, role) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).members.update(userId, parseChoice(role, "role", SPACE_ROLES));
@@ -1692,7 +1692,7 @@ function registerMembers(spacesCmd) {
         .command("remove <userId>")
         .description("Remove a member")
         .action(async (userId) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             await client.space(spaceId).members.remove(userId);
@@ -1708,13 +1708,13 @@ function registerAccess(spacesCmd) {
     const accCmd = spacesCmd
         .command("access")
         .description("Access control")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     accCmd
         .command("get")
         .description("Get access policy")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const policy = await client.space(spaceId).access.get();
@@ -1736,7 +1736,7 @@ function registerAccess(spacesCmd) {
         .option("--anonymous <role>", "Role for anonymous users (host|builder|guest|null)")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const policy = await client.space(spaceId).access.set({
@@ -1761,7 +1761,7 @@ function registerCheckpoints(spacesCmd) {
     const cpCmd = spacesCmd
         .command("checkpoints")
         .description("Checkpoint management")
-        .hook("preAction", () => { resolveSpace(spacesCmd); });
+        .hook("preAction", async () => { await resolveSpace(spacesCmd); });
     cpCmd
         .command("ls")
         .alias("list")
@@ -1770,7 +1770,7 @@ function registerCheckpoints(spacesCmd) {
         .option("--cursor <cursor>", "Pagination cursor")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.list({
@@ -1799,7 +1799,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Checkpoint details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.get(id);
@@ -1822,7 +1822,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Create a checkpoint")
         .option("--json", "Output as JSON")
         .action(async (description, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const result = await client.space(spaceId).checkpoints.create(description ?? null);
@@ -1839,7 +1839,7 @@ function registerCheckpoints(spacesCmd) {
         .description("List checkpoint tree")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const tree = await client.space(spaceId).checkpoints(checkpointId).files.list(path ?? "");
@@ -1866,7 +1866,7 @@ function registerCheckpoints(spacesCmd) {
         .description("Show checkpoint file content")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             const file = await client.space(spaceId).checkpoints(checkpointId).files.read(path);
@@ -1888,7 +1888,7 @@ function registerCheckpoints(spacesCmd) {
         .option("--base <checkpointId>", "Compare against another checkpoint")
         .option("--json", "Output as JSON")
         .action(async (checkpointId, path, opts) => {
-        const spaceId = resolveSpace(spacesCmd);
+        const spaceId = await resolveSpace(spacesCmd);
         const client = createClient();
         try {
             if (path) {

package/dist/index.js

@@ -36,7 +36,7 @@ program
     .summary("Work with Cohub from your terminal")
     .description("Send prompts, manage Space files, and publish public output.")
     .version(VERSION, "-v, --version", "Show version")
-    .option("-s, --space <id>", "Target Space ID")
+    .option("-s, --space <id>", "Target Space ID (defaults to your Home space)")
     .option("--json", "Print machine-readable JSON when supported")
     .helpOption("-h, --help", "Show help")
     .addHelpText("after", `
@@ -45,9 +45,9 @@ Common commands:
   cohub auth login
   cohub profile avatar ./avatar.png
   cohub spaces ls
-  cohub -s <space-id> prompt "Fix the failing tests"
-  cohub -s <space-id> completion "Summarize AGENTS.md" --system-prompt AGENTS.md --stream
-  cohub -s <space-id> run -- git status
+  cohub prompt "Fix the failing tests"
+  cohub completion "Summarize AGENTS.md" --system-prompt AGENTS.md --stream
+  cohub run -- git status
   cohub sandbox up ./my-project
   cohub search "release notes"
   cohub -s <space-id> boards inspect <board-id>
@@ -62,7 +62,11 @@ Common commands:
   cohub models ls --model-type multimodal
   cohub generate "A calm lake at sunrise" --model <model> --output lake.png
 
+Target space:
+  -s <space-id>, then COHUB_SPACE_ID, then your Home space
+
 Environment:
+  COHUB_SPACE_ID         Target Space ID when -s is omitted
   COHUB_EXECUTION_TOKEN  Use this token instead of the stored Logto session
   ENV=dev                Use the development Cohub environment
 `);

package/dist/space.d.ts

@@ -1,2 +1,32 @@
 import type { Command } from "commander";
-export declare function resolveSpace(program: Command): string;
+/**
+ * Cache key aligned with auth: execution token is exclusive (same as
+ * `resolveAccessToken`) and never falls back to a local Logto session.
+ * Execution grants identify the actor as `actorUserId`, not `sub`.
+ */
+export declare function identityKeyFrom(input: {
+    env: string;
+    executionToken?: string | null;
+    idToken?: string | null;
+    accessToken?: string | null;
+}): string | null;
+/** Exported for tests; production always uses `CACHE_PATH`. */
+export declare function readDefaultSpaceCache(path: string, key: string, now?: number): string | null;
+export declare function clearDefaultSpaceCache(): void;
+/** Explicit target from `-s/--space` (any ancestor) or `COHUB_SPACE_ID`, else null. */
+export declare function explicitSpace(program: Command): string | null;
+/**
+ * Resolve the user's home space when no target is given. Cached locally per
+ * identity so repeated invocations skip the network entirely, and memoized
+ * in-process so preAction hooks and actions share a single lookup.
+ * Network and auth failures propagate so callers can report them faithfully.
+ */
+export declare function resolveDefaultSpace(): Promise<string | null>;
+/** Shared exit for commands that need a space but resolved none. */
+export declare function missingSpaceError(): never;
+/**
+ * Target space for a command: explicit `-s`/`COHUB_SPACE_ID` first, then the
+ * user's home space. Exits with guidance when neither is available; request
+ * failures go through the shared HTTP error handler.
+ */
+export declare function resolveSpace(program: Command): Promise<string>;