@neta-art/cohub-cli 1.11.1 → 1.12.0

package/dist/commands/generations.js

@@ -57,23 +57,22 @@ async function saveOutputs(output, outputPath) {
     if (outputs.length === 0)
         return [];
     const info = await stat(outputPath).catch(() => null);
-    const isDir = info?.isDirectory() ?? (!extname(outputPath) && outputs.length > 1);
-    if (outputs.length > 1 && !isDir)
-        throw new Error("--output must be a directory when generation returns multiple outputs");
-    if (isDir)
-        await mkdir(outputPath, { recursive: true });
+    const isSingleFile = outputs.length === 1 && !(info?.isDirectory() ?? false);
+    const targetPath = isSingleFile ? outputPath : await resolveOutputDirectory(outputPath, info);
+    if (isSingleFile)
+        await mkdir(dirname(targetPath), { recursive: true });
     else
-        await mkdir(dirname(outputPath), { recursive: true });
+        await mkdir(targetPath, { recursive: true });
     const savedPaths = [];
     for (const [i, block] of outputs.entries()) {
         if (block.type === "text") {
-            const target = isDir ? join(outputPath, `generation-${i + 1}.txt`) : outputPath;
+            const target = isSingleFile ? targetPath : join(targetPath, `generation-${i + 1}.txt`);
             await writeFile(target, block.text, "utf-8");
             savedPaths.push(target);
             continue;
         }
         const source = block.source;
-        const target = isDir ? join(outputPath, outputName(block, source.type === "url" ? source.url : undefined, i)) : outputPath;
+        const target = isSingleFile ? targetPath : join(targetPath, outputName(block, source.type === "url" ? source.url : undefined, i));
         if (source.type === "url") {
             const response = await fetch(source.url);
             if (!response.ok)
@@ -88,6 +87,20 @@ async function saveOutputs(output, outputPath) {
     }
     return savedPaths;
 }
+async function resolveOutputDirectory(outputPath, info) {
+    if (info?.isDirectory() || (!info && !extname(outputPath)))
+        return outputPath;
+    const ext = extname(outputPath);
+    const stem = ext ? basename(outputPath, ext) : basename(outputPath);
+    const parent = dirname(outputPath);
+    const base = join(parent, `${stem}-outputs`);
+    for (let i = 0;; i += 1) {
+        const candidate = i === 0 ? base : `${base}-${i + 1}`;
+        const candidateInfo = await stat(candidate).catch(() => null);
+        if (!candidateInfo || candidateInfo.isDirectory())
+            return candidate;
+    }
+}
 function outputName(block, url, index) {
     const fromUrl = url ? basename(new URL(url).pathname) : "";
     const label = slugOutputLabel(block);

package/dist/commands/spaces.js

@@ -10,6 +10,7 @@ import { resolveSpace } from "../space.js";
 const cliEnv = resolveCohubEnvironment();
 const defaultIdleTtlSeconds = cliEnv === "prod" ? 12 * 60 * 60 : 10 * 60;
 const SPACE_ROLES = ["host", "builder", "guest"];
+const LABEL_RESOURCE_TYPES = ["session", "checkpoint", "file"];
 function parseInteger(value, name, options = {}) {
     if (!/^-?\d+$/.test(value.trim()))
         return error(`Invalid ${name}`, `${name} must be an integer`);
@@ -22,6 +23,9 @@ function parseInteger(value, name, options = {}) {
         return error(`Invalid ${name}`, `${name} must be at most ${options.max}`);
     return parsed;
 }
+function collectOption(value, previous = []) {
+    return [...previous, value];
+}
 function parseChoice(value, name, choices) {
     if (choices.includes(value))
         return value;
@@ -189,6 +193,7 @@ async function sendPrompt(command, words, opts) {
             provider: opts.provider,
             accessMode: opts.readOnly ? "read_only" : "full_access",
             schedule,
+            labelRefs: opts.label?.length ? opts.label : undefined,
         });
         if (jsonRequested(opts))
             return outJson(result);
@@ -215,6 +220,7 @@ export function registerPrompt(program) {
         .option("--at <iso>", "Send once at an ISO 8601 time with timezone")
         .option("--cron <expression>", "Repeat using a 5-field cron expression")
         .option("--timezone <tz>", "IANA timezone for --cron, e.g. Asia/Shanghai")
+        .option("--label <ref>", "Attach a label, e.g. Bug or Area/Frontend", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(program, words, opts));
 }
@@ -373,6 +379,7 @@ export function registerSpaces(program) {
         .option("--at <iso>", "Send once at an ISO 8601 time with timezone")
         .option("--cron <expression>", "Repeat using a 5-field cron expression")
         .option("--timezone <tz>", "IANA timezone for --cron, e.g. Asia/Shanghai")
+        .option("--label <ref>", "Attach a label, e.g. Bug or Area/Frontend", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(spacesCmd, words, opts));
     // ── spaces files ──
@@ -387,6 +394,8 @@ export function registerSpaces(program) {
     registerCheckpoints(spacesCmd);
     // ── spaces mods ──
     registerMods(spacesCmd);
+    // ── spaces labels ──
+    registerLabels(spacesCmd);
     // ── spaces usage ──
     spacesCmd
         .command("usage [days]")
@@ -413,6 +422,197 @@ export function registerSpaces(program) {
         }
     });
 }
+function flattenLabels(items, prefix = "") {
+    return items.flatMap((label) => {
+        const path = prefix ? `${prefix}/${label.name}` : label.name;
+        return [{ ...label, path }, ...flattenLabels(label.children ?? [], path)];
+    });
+}
+function parseLabelResourceType(value) {
+    return parseChoice(value, "resource type", LABEL_RESOURCE_TYPES);
+}
+function parseLabelRefs(value) {
+    if (!value?.trim())
+        return [];
+    return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function registerLabels(spacesCmd) {
+    const labelsCmd = spacesCmd
+        .command("labels")
+        .description("Manage labels")
+        .hook("preAction", () => { resolveSpace(spacesCmd); });
+    labelsCmd
+        .command("ls")
+        .alias("list")
+        .description("List labels")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.list();
+            if (jsonRequested(opts))
+                return outJson(result);
+            table(flattenLabels(result.labels), [
+                { key: "path", label: "Label" },
+                { key: "rank", label: "Rank" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("create <labelRef>")
+        .description("Create a label")
+        .option("--json", "Output as JSON")
+        .action(async (labelRef, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.create(labelRef);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok("Label created");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("update <labelRef>")
+        .description("Update a label")
+        .option("--name <name>", "Label name")
+        .option("--parent <ref>", "Parent label; use null for root")
+        .option("--rank <n>", "Sort rank")
+        .option("--json", "Output as JSON")
+        .action(async (labelRef, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.update(labelRef, {
+                name: opts.name,
+                parentRef: opts.parent === undefined ? undefined : opts.parent === "null" ? null : opts.parent,
+                rank: opts.rank === undefined ? undefined : parseInteger(opts.rank, "rank", { min: -1_000_000, max: 1_000_000 }),
+            });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok("Label updated");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("rm <labelRef>")
+        .alias("delete")
+        .description("Delete a label")
+        .action(async (labelRef) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            await client.space(spaceId).labels.delete(labelRef);
+            ok("Label deleted");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("reorder <labelRefs...>")
+        .description("Reorder labels")
+        .option("--json", "Output as JSON")
+        .action(async (labelRefs, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.reorder(labelRefs);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok("Labels reordered");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("items <labelRef>")
+        .description("List label items")
+        .option("--limit <n>", "Page size")
+        .option("--cursor <cursor>", "Page cursor")
+        .option("--json", "Output as JSON")
+        .action(async (labelRef, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.listItems(labelRef, {
+                limit: opts.limit ? parseInteger(opts.limit, "limit", { min: 1 }) : undefined,
+                cursor: opts.cursor,
+            });
+            if (jsonRequested(opts))
+                return outJson(result);
+            table(result.items, [
+                { key: "id", label: "ID" },
+                { key: "resourceType", label: "Type" },
+                { key: "resourceRef", label: "Resource" },
+                { key: "rank", label: "Rank" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("attach <labelRef> <resourceType> <resourceRef>")
+        .description("Attach a label")
+        .option("--json", "Output as JSON")
+        .action(async (labelRef, resourceType, resourceRef, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const result = await client.space(spaceId).labels.attach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok("Label attached");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("detach <labelRef> <resourceType> <resourceRef>")
+        .description("Detach a label")
+        .action(async (labelRef, resourceType, resourceRef) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            await client.space(spaceId).labels.detach(labelRef, { resourceType: parseLabelResourceType(resourceType), resourceRef });
+            ok("Label detached");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    labelsCmd
+        .command("set <resourceType> <resourceRef> [labelRefs...]")
+        .description("Set resource labels")
+        .option("--labels <refs>", "Comma-separated label refs")
+        .option("--json", "Output as JSON")
+        .action(async (resourceType, resourceRef, labelRefs, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const refs = [...parseLabelRefs(opts.labels), ...labelRefs];
+            const result = await client.space(spaceId).labels.setResourceLabels(parseLabelResourceType(resourceType), resourceRef, refs);
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok("Resource labels updated");
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}
 function registerMods(spacesCmd) {
     const modsCmd = spacesCmd
         .command("mods")
@@ -652,7 +852,6 @@ function registerFiles(spacesCmd) {
         }
     });
 }
-// ── Session operations ──
 function registerSessions(spacesCmd) {
     const sessionsCmd = spacesCmd
         .command("sessions")
@@ -688,12 +887,17 @@ function registerSessions(spacesCmd) {
     sessionsCmd
         .command("create [title]")
         .description("Create a session")
+        .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 client = createClient();
         try {
-            const result = await client.space(spaceId).sessions.create({ title });
+            const result = await client.space(spaceId).sessions.create({
+                title,
+                source: "cli",
+                labelRefs: opts.label?.length ? opts.label : undefined,
+            });
             if (jsonRequested(opts))
                 return outJson(result);
             ok(`Session created: ${result.session.id}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,7 +16,7 @@
     "@neta-art/generation": "^0.1.2",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "1.20.0"
+    "@neta-art/cohub": "1.21.0"
   },
   "publishConfig": {
     "access": "public"