@neta-art/cohub-cli 3.5.1 → 3.5.2

package/README.md

@@ -63,6 +63,7 @@ cohub spaces get <spaceId> --json
 cohub -s <spaceId> spaces get
 COHUB_SPACE_ID=<spaceId> cohub spaces get
 cohub spaces create --name "<name>" --description "<description>" --json
+cohub spaces create --name "<name>" --checkpoint <checkpointId> --json
 cohub spaces update <spaceId> --slug <space-slug>
 cohub spaces rename <spaceId> "<new name>"
 cohub -s <spaceId> spaces invites create --role builder --days 7
@@ -291,6 +292,9 @@ cohub works resolve <workSlug> --owner <username> --space-slug <spaceSlug>
 
 Use `--json` for machine-readable output. The resolve command requires both `--owner` and `--space-slug` so missing public profile data fails with a clear message.
 
+Realtime rooms use a published Work's runtime identity, so they are available
+through `client.work.realtime` in the SDK rather than as CLI commands.
+
 ## Saves
 
 ```bash

package/dist/commands/sandbox.d.ts

@@ -1,2 +1,3 @@
 import type { Command } from "commander";
+export declare const resolveLocalSpaceName: (rootDir: string, requestedName?: string) => string;
 export declare function registerSandbox(program: Command): void;

package/dist/commands/sandbox.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
 import { stat } from "node:fs/promises";
 import { createInterface } from "node:readline";
-import { resolve } from "node:path";
+import { basename, resolve } from "node:path";
 import { resolveCohubEnvironment, resolveWebsocketUrl } from "@neta-art/cohub";
 import { requireAccessToken } from "../auth.js";
 import { createClient } from "../client.js";
@@ -28,6 +28,7 @@ const confirm = async (question) => {
     }
 };
 const webBaseUrl = () => resolveCohubEnvironment() === "prod" ? "https://cohub.run" : "https://dev.cohub.run";
+export const resolveLocalSpaceName = (rootDir, requestedName) => requestedName?.trim() || basename(rootDir) || "local-space";
 // Consent copy is deliberately explicit: a local sandbox runs agent-issued
 // shell commands as the current OS user. File RPCs are fenced to the folder,
 // but shell commands are NOT — they can read/write anything the user can
@@ -97,7 +98,7 @@ export function registerSandbox(program) {
                     return error("Aborted", "No space was created");
             }
             const created = await client.spaces.create({
-                name: opts.name,
+                name: resolveLocalSpaceName(rootDir, opts.name),
                 config: { sandbox: { provider: "local" } },
             });
             spaceId = created.space.id;

package/dist/commands/spaces.d.ts

@@ -1,3 +1,17 @@
+import type { CohubHttpClient, CreateSpaceInput } from "@neta-art/cohub";
 import type { Command } from "commander";
+export type SpaceCreateOptions = {
+    name: string;
+    description?: string;
+    checkpoint?: string;
+    autoDestroy?: string;
+    idleTtl?: string;
+    spec?: string;
+    json?: boolean;
+};
+export declare function buildSpaceCreateInput(opts: SpaceCreateOptions): CreateSpaceInput;
 export declare function registerPrompt(program: Command): void;
+export declare function registerSpaceCreate(spacesCmd: Command, dependencies?: {
+    createClient?: () => CohubHttpClient;
+}): Command;
 export declare function registerSpaces(program: Command): void;

package/dist/commands/spaces.js

@@ -67,6 +67,31 @@ const parseAutoDestroy = (opts) => {
     return { mode: "idle", ttlSeconds };
 };
 const parseSandboxSpec = (value) => value ? parseChoice(value, "sandbox spec", SANDBOX_SPEC_IDS) : undefined;
+export function buildSpaceCreateInput(opts) {
+    const autoDestroy = parseAutoDestroy(opts);
+    const spec = parseSandboxSpec(opts.spec);
+    const checkpointId = opts.checkpoint?.trim();
+    if (opts.checkpoint !== undefined && !checkpointId) {
+        return error("Invalid checkpoint", "Checkpoint ID is required");
+    }
+    return {
+        name: opts.name,
+        description: opts.description,
+        ...(checkpointId
+            ? { bootstrapSource: { type: "checkpoint", checkpointId } }
+            : {}),
+        ...((autoDestroy || spec)
+            ? {
+                config: {
+                    sandbox: {
+                        ...(autoDestroy ? { autoDestroy } : {}),
+                        ...(spec ? { spec } : {}),
+                    },
+                },
+            }
+            : {}),
+    };
+}
 const formatAutoDestroy = (policy) => {
     if (!policy)
         return `${cliEnv === "prod" ? "12h" : "10m"} (default)`;
@@ -376,6 +401,36 @@ export function registerPrompt(program) {
         .option("--json", "Output as JSON")
         .action((words, opts) => runCompletionCommand(program, words, opts));
 }
+export function registerSpaceCreate(spacesCmd, dependencies = {}) {
+    const getClient = dependencies.createClient ?? createClient;
+    return spacesCmd
+        .command("create")
+        .description("Create a new space")
+        .requiredOption("-n, --name <name>", "Space name")
+        .option("-d, --description <desc>", "Space description")
+        .option("--checkpoint <id>", "Create from a checkpoint")
+        .option("--auto-destroy <mode>", "Sandbox auto destroy mode: idle or never")
+        .option("--idle-ttl <seconds>", "Idle auto destroy TTL in seconds, max 2592000 (30d)")
+        .option("--spec <spec>", "Sandbox spec: standard, boost, or ultra")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const client = getClient();
+        try {
+            const result = await client.spaces.create(buildSpaceCreateInput(opts));
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Space created: ${result.space.id}`);
+            table([{ ...result.space, taskRunId: result.taskRunId }], [
+                { key: "id", label: "ID" },
+                { key: "name", label: "Name" },
+                { key: "taskRunId", label: "Task" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}
 export function registerSpaces(program) {
     const spacesCmd = program.command("spaces").description("Space management");
     registerSpaceInvitations(spacesCmd);
@@ -441,38 +496,7 @@ export function registerSpaces(program) {
         }
     });
     // ── spaces create ──
-    spacesCmd
-        .command("create")
-        .description("Create a new space")
-        .option("-n, --name <name>", "Space name")
-        .option("-d, --description <desc>", "Space description")
-        .option("--auto-destroy <mode>", "Sandbox auto destroy mode: idle or never")
-        .option("--idle-ttl <seconds>", "Idle auto destroy TTL in seconds, max 2592000 (30d)")
-        .option("--spec <spec>", "Sandbox spec: standard, boost, or ultra")
-        .option("--json", "Output as JSON")
-        .action(async (opts) => {
-        const client = createClient();
-        try {
-            const autoDestroy = parseAutoDestroy(opts);
-            const spec = parseSandboxSpec(opts.spec);
-            const result = await client.spaces.create({
-                name: opts.name,
-                description: opts.description,
-                ...((autoDestroy || spec) ? { config: { sandbox: { ...(autoDestroy ? { autoDestroy } : {}), ...(spec ? { spec } : {}) } } } : {}),
-            });
-            if (jsonRequested(opts))
-                return outJson(result);
-            ok(`Space created: ${result.space.id}`);
-            table([result.space], [
-                { key: "id", label: "ID" },
-                { key: "name", label: "Name" },
-                { key: "taskRunId", label: "Task" },
-            ]);
-        }
-        catch (e) {
-            handleHttp(e);
-        }
-    });
+    registerSpaceCreate(spacesCmd);
     // ── spaces update ──
     spacesCmd
         .command("update <id>")

package/dist/commands/tasks.d.ts

@@ -1,2 +1,8 @@
 import type { Command } from "commander";
-export declare function registerTasks(program: Command): void;
+import { createClient } from "../client.js";
+type TasksClient = ReturnType<typeof createClient>;
+type RegisterTasksDependencies = {
+    createClient?: () => TasksClient;
+};
+export declare function registerTasks(program: Command, dependencies?: RegisterTasksDependencies): void;
+export {};

package/dist/commands/tasks.js

@@ -1,6 +1,7 @@
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, handleHttp } from "../output.js";
-export function registerTasks(program) {
+export function registerTasks(program, dependencies = {}) {
+    const getClient = dependencies.createClient ?? createClient;
     const cmd = program.command("tasks", { hidden: true }).description("Task runs");
     cmd
         .command("ls")
@@ -15,16 +16,17 @@ export function registerTasks(program) {
         .option("--cursor <cursor>", "Page cursor")
         .option("--json", "Output as JSON")
         .action(async (opts) => {
-        const client = createClient();
+        const client = getClient();
         try {
             const limit = opts.limit ? Number(opts.limit) : 50;
             if (!Number.isFinite(limit) || limit < 1)
                 throw new Error("limit must be a positive number");
             const filters = { limit: Math.floor(limit) };
+            const spaceId = opts.space ?? program.opts().space;
             if (opts.cronJob)
                 filters.cronJobId = opts.cronJob;
-            if (opts.space)
-                filters.spaceId = opts.space;
+            if (spaceId)
+                filters.spaceId = spaceId;
             if (opts.session)
                 filters.sessionId = opts.session;
             if (opts.type)
@@ -58,7 +60,7 @@ export function registerTasks(program) {
         .description("Task run details")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
-        const client = createClient();
+        const client = getClient();
         try {
             const result = await client.tasks.get(id);
             if (jsonRequested(opts))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "3.5.1",
+  "version": "3.5.2",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,7 +19,7 @@
     "commander": "^15.0.0",
     "pixi.js": "^8.19.0",
     "sharp": "^0.35.3",
-    "@neta-art/cohub": "4.9.0"
+    "@neta-art/cohub": "5.0.0"
   },
   "publishConfig": {
     "access": "public"