@neta-art/cohub-cli 1.13.1 → 1.15.0

package/dist/commands/generations.js

@@ -171,7 +171,7 @@ function envValue(name) {
     const value = process.env[name]?.trim();
     return value || undefined;
 }
-function parseMetadata(value) {
+function parseMeta(value) {
     if (!value)
         return undefined;
     let parsed;
@@ -179,25 +179,25 @@ function parseMetadata(value) {
         parsed = JSON.parse(value);
     }
     catch {
-        return error("Invalid metadata", "--metadata must be a JSON object");
+        return error("Invalid meta", "--meta must be a JSON object");
     }
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        return error("Invalid metadata", "--metadata must be a JSON object");
+        return error("Invalid meta", "--meta must be a JSON object");
     }
     return parsed;
 }
-function mergeCohubMetadata(metadata) {
+function mergeCohubMeta(meta) {
     const sessionId = envValue("COHUB_SESSION_ID");
     const turnId = envValue("COHUB_TURN_ID");
     const toolCallId = envValue("COHUB_TOOL_CALL_ID");
     if (!sessionId && !turnId && !toolCallId)
-        return metadata;
-    const existingCohub = metadata?.cohub;
+        return meta;
+    const existingCohub = meta?.cohub;
     const cohub = existingCohub && typeof existingCohub === "object" && !Array.isArray(existingCohub)
         ? existingCohub
         : {};
     return {
-        ...(metadata ?? {}),
+        ...(meta ?? {}),
         cohub: {
             ...cohub,
             ...(sessionId ? { sessionId } : {}),
@@ -217,7 +217,7 @@ export function registerGenerations(program) {
         .option("--audio <path-or-url>", "Audio input file path or URL; repeatable", collect, [])
         .option("--param <key=value>", "Generation parameter; repeatable, values may be JSON/number/boolean", collect, [])
         .option("--parameters <json>", "Generation parameters as a JSON object")
-        .option("--metadata <json>", "Metadata as a JSON object")
+        .option("--meta <json>", "Meta as a JSON object")
         .option("-o, --output <path>", "Save generated output to a file or directory")
         .option("--async", "Queue the generation task and return immediately")
         .option("--timeout-ms <ms>", "Maximum time to wait in synchronous mode")
@@ -250,7 +250,7 @@ Examples:
                     return error("Generation settings", policyError.message);
                 throw policyError;
             }
-            const metadata = mergeCohubMetadata(parseMetadata(opts.metadata));
+            const meta = mergeCohubMeta(parseMeta(opts.meta));
             const client = createClient();
             const created = await client.generations.create({
                 spaceId,
@@ -259,7 +259,7 @@ Examples:
                 model: opts.model,
                 content,
                 parameters,
-                metadata,
+                meta,
             });
             if (opts.async) {
                 if (jsonRequested(opts))

package/dist/commands/search.js

@@ -3,7 +3,7 @@ import { table, json as outJson, jsonRequested, error, handleHttp } from "../out
 const DEFAULT_LIMIT = 20;
 const MAX_TITLE_LENGTH = 72;
 const MAX_CONTEXT_LENGTH = 42;
-const SEARCH_TYPES = new Set(["turn", "session", "space"]);
+const SEARCH_TYPES = new Set(["turn", "session", "space", "label"]);
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 function clampLimit(value) {
     const parsed = Number(value ?? DEFAULT_LIMIT);
@@ -42,7 +42,7 @@ function parseSearchInput(opts) {
     const spaceId = opts.spaceId?.trim();
     if (spaceId && !UUID_PATTERN.test(spaceId))
         throw new Error("Invalid space id");
-    return { types, spaceId: spaceId || undefined };
+    return { types, spaceId: spaceId || undefined, labelRef: opts.labelRef?.trim() || undefined };
 }
 function rowsFor(items) {
     return items.map((item) => ({
@@ -57,11 +57,12 @@ function rowsFor(items) {
 export function registerSearch(program) {
     program
         .command("search")
-        .description("Search spaces, chats, and turns")
-        .argument("<query>", "Search query")
+        .description("Search spaces, chats, turns, and label items")
+        .argument("[query]", "Search query")
         .option("--limit <n>", "Maximum results, 1-50", String(DEFAULT_LIMIT))
-        .option("--types <types>", "Comma-separated result types: turn,session,space")
+        .option("--types <types>", "Comma-separated result types: turn,session,space,label")
         .option("--space-id <id>", "Limit search to a space")
+        .option("--label-ref <ref>", "Search items under an exact label ref")
         .option("--json", "Output as JSON")
         .addHelpText("after", `
 
@@ -69,17 +70,23 @@ Examples:
   cohub search "release notes"
   cohub search "failing tests" --limit 10
   cohub search "bug" --types turn,session --space-id <spaceId>
+  cohub search --types label --label-ref bug
+  cohub search "login" --types label --label-ref bug
   cohub search "design review" --json
 `)
         .action(async (query, opts) => {
         const client = createClient();
         try {
             const input = parseSearchInput(opts);
+            const q = query ?? "";
+            if (!q.trim() && !input.labelRef)
+                return error("Search query is required unless --label-ref is provided.");
             const result = await client.search.query({
-                q: query,
+                q,
                 limit: clampLimit(opts.limit),
                 types: input.types,
                 spaceId: input.spaceId,
+                labelRef: input.labelRef,
             });
             if (jsonRequested(opts))
                 return outJson(result);

package/dist/commands/spaces.js

@@ -1417,4 +1417,52 @@ function registerCheckpoints(spacesCmd) {
             handleHttp(e);
         }
     });
+    cpCmd
+        .command("ls-tree <checkpointId> [path]")
+        .description("List checkpoint tree")
+        .option("--json", "Output as JSON")
+        .action(async (checkpointId, path, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const tree = await client.space(spaceId).checkpoints(checkpointId).files.list(path ?? "");
+            if (jsonRequested(opts))
+                return outJson(tree);
+            if (tree.entries.length === 0) {
+                console.log("  (empty)");
+                return;
+            }
+            table(tree.entries, [
+                { key: "name", label: "Name" },
+                { key: "type", label: "Type" },
+                { key: "size", label: "Size" },
+                { key: "mimeType", label: "MIME" },
+                { key: "mtimeMs", label: "Modified" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    cpCmd
+        .command("show <checkpointId> <path>")
+        .description("Show checkpoint file content")
+        .option("--json", "Output as JSON")
+        .action(async (checkpointId, path, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            const file = await client.space(spaceId).checkpoints(checkpointId).files.read(path);
+            if (jsonRequested(opts))
+                return outJson(file);
+            if (file.delivery === "url" && file.url) {
+                console.log(file.url);
+                return;
+            }
+            console.log(file.content);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "1.13.1",
+  "version": "1.15.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "UNLICENSED",
@@ -13,10 +13,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@neta-art/generation": "^0.1.2",
+    "@neta-art/generation": "^0.1.3",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "1.23.1"
+    "@neta-art/cohub": "1.25.0"
   },
   "publishConfig": {
     "access": "public"