@neta-art/cohub-cli 1.20.6 → 2.0.0

package/README.md

@@ -149,6 +149,16 @@ cohub generate "restyle this image" \
   --param size=1024x1024 \
   --json
 
+cohub generate "smoothly transition from the first frame to the last frame" \
+  --model seedance-2-0-fast \
+  --image first_frame=https://example.com/first.png \
+  --image last_frame=https://example.com/last.png
+
+cohub generate "keep the character identity from all reference images" \
+  --model seedance-2-0-fast \
+  --image reference_image=https://example.com/reference-1.png \
+  --image reference_image=https://example.com/reference-2.png
+
 cohub generate "a calm lake" \
   --model <model> \
   --async
@@ -160,10 +170,16 @@ Supported inputs:
 
 ```bash
 --image <path-or-url>
+--image first_frame=<path-or-url>
+--image last_frame=<path-or-url>
+--image reference_image=<path-or-url>
 --video <path-or-url>
+--video reference_video=<path-or-url>
 --audio <path-or-url>
 ```
 
+Role-qualified media values add `meta.role` to that content block. Repeat `--image reference_image=...` for multiple reference images. Seedance role-qualified media should use public URL inputs. Do not mix first/last frame roles with reference roles in one request.
+
 Pass generation parameters with `--param key=value` or `--parameters '<json>'`.
 
 ## Files
@@ -191,7 +207,7 @@ cohub works get <workId> --json
 cohub -s <spaceId> works publish demo --file dist/index.html
 cohub -s <spaceId> works publish site --dir dist
 cohub -s <spaceId> works publish app --port 3000
-cohub works update <workId> --publish-version
+cohub works publish-version <workId>
 cohub works versions <workId> --json
 cohub works rm <workId> --yes
 ```

package/dist/commands/generations.js

@@ -4,6 +4,14 @@ import { GenerationPolicyError, assertGenerationRequestAllowedByPolicy, parseGen
 import { createClient } from "../client.js";
 import { resolveSpace } from "../space.js";
 import { json as outJson, jsonRequested, ok, error, handleHttp, spinner } from "../output.js";
+const frameMediaRoles = new Set(["first_frame", "last_frame"]);
+const referenceMediaRoles = new Set(["reference_image", "reference_video"]);
+const rolesByMediaType = {
+    image: new Set([...frameMediaRoles, "reference_image"]),
+    video: new Set(["reference_video"]),
+    audio: new Set(),
+};
+const mediaRoles = new Set([...frameMediaRoles, ...referenceMediaRoles]);
 const mimeByExt = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -45,12 +53,47 @@ function parseParams(param, parameters) {
     }
     return Object.keys(result).length > 0 ? result : undefined;
 }
-async function contentFromPathOrUrl(type, value) {
-    if (/^https?:\/\//.test(value))
-        return { type, source: { type: "url", url: value } };
+async function pathExists(path) {
+    return Boolean(await stat(path).catch(() => null));
+}
+async function parseMediaInput(type, rawValue) {
+    const separator = rawValue.indexOf("=");
+    if (separator <= 0)
+        return { value: rawValue };
+    const role = rawValue.slice(0, separator).trim();
+    if (!mediaRoles.has(role))
+        return { value: rawValue };
+    if (await pathExists(rawValue))
+        return { value: rawValue };
+    if (!rolesByMediaType[type].has(role)) {
+        return error("Invalid media role", `${role} cannot be used with --${type}`);
+    }
+    const value = rawValue.slice(separator + 1).trim();
+    if (!value)
+        return error("Invalid media input", `--${type} ${role}= requires a path or URL`);
+    return { value, role };
+}
+async function contentFromPathOrUrl(type, rawValue) {
+    const { value, role } = await parseMediaInput(type, rawValue);
+    const meta = role ? { role } : undefined;
+    if (/^https?:\/\//.test(value)) {
+        return { type, source: { type: "url", url: value }, ...(meta ? { meta } : {}) };
+    }
     const data = await readFile(value);
     const mediaType = mimeByExt[extname(value).toLowerCase()] ?? "application/octet-stream";
-    return { type, source: { type: "base64", mediaType, data: data.toString("base64") } };
+    return {
+        type,
+        source: { type: "base64", mediaType, data: data.toString("base64") },
+        ...(meta ? { meta } : {}),
+    };
+}
+function validateMediaRoleModes(content) {
+    const roles = content.map(metaRole).filter((role) => Boolean(role));
+    const hasFrameRole = roles.some((role) => frameMediaRoles.has(role));
+    const hasReferenceRole = roles.some((role) => referenceMediaRoles.has(role));
+    if (hasFrameRole && hasReferenceRole) {
+        error("Invalid media role mix", "Use first_frame/last_frame or reference_image/reference_video, not both.");
+    }
 }
 async function saveOutputs(output, outputPath) {
     const outputs = output.filter((block) => block.type === "text" || block.type === "image" || block.type === "video" || block.type === "audio");
@@ -212,8 +255,8 @@ export function registerGenerations(program) {
         .description("Generate multimodal outputs")
         .argument("<prompt>", "Prompt text")
         .requiredOption("-m, --model <model>", "Multimodal model ID from `cohub models ls --model-type multimodal`")
-        .option("--image <path-or-url>", "Image input file path or URL; repeatable", collect, [])
-        .option("--video <path-or-url>", "Video input file path or URL; repeatable", collect, [])
+        .option("--image <path-or-url>", "Image input file path or URL; prefix with first_frame=, last_frame=, or reference_image= when needed; repeatable", collect, [])
+        .option("--video <path-or-url>", "Video input file path or URL; prefix with reference_video= when needed; repeatable", collect, [])
         .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")
@@ -228,6 +271,8 @@ Examples:
   cohub models ls --model-type multimodal
   cohub -s <space-id> generate "A calm lake at sunrise" -m <model> -o lake.png
   COHUB_SPACE_ID=<space-id> cohub generate "Restyle this image" -m <model> --image input.png
+  cohub -s <space-id> generate "Smooth transition" -m seedance-2-0-fast --image first_frame=https://example.com/first.png --image last_frame=https://example.com/last.png
+  cohub -s <space-id> generate "Use these references" -m seedance-2-0-fast --image reference_image=https://example.com/a.png --image reference_image=https://example.com/b.png
   cohub -s <space-id> generate "A calm lake" -m <model> --async
 `)
         .action(async (prompt, opts) => {
@@ -237,6 +282,7 @@ Examples:
             content.push(...await Promise.all(opts.image.map((value) => contentFromPathOrUrl("image", value))));
             content.push(...await Promise.all(opts.video.map((value) => contentFromPathOrUrl("video", value))));
             content.push(...await Promise.all(opts.audio.map((value) => contentFromPathOrUrl("audio", value))));
+            validateMediaRoleModes(content);
             const parameters = parseParams(opts.param, opts.parameters);
             try {
                 assertGenerationRequestAllowedByPolicy({

package/dist/commands/models.js

@@ -17,6 +17,7 @@ function printSection(title, lines) {
 }
 function formatContentSpec(spec) {
     const details = [];
+    const roles = spec.roles;
     details.push(spec.required === false ? "optional" : "required");
     if (typeof spec.min === "number")
         details.push(`min ${spec.min}`);
@@ -24,6 +25,8 @@ function formatContentSpec(spec) {
         details.push(`max ${spec.max}`);
     if (spec.sources?.length)
         details.push(`sources: ${spec.sources.join(", ")}`);
+    if (roles?.length)
+        details.push(`roles: ${roles.join(", ")}`);
     if (spec.merge)
         details.push(`merge: ${spec.merge}`);
     if (spec.description)

package/dist/commands/works.js

@@ -1,7 +1,9 @@
+import { HttpError } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
 import { resolveSpace } from "../space.js";
-const WORK_STATUSES = ["draft", "published", "disabled"];
+const WORK_STATUSES = ["published", "disabled"];
+const WORK_VISIBILITIES = ["public", "space"];
 const collectOption = (value, previous = []) => [...previous, value];
 function parseChoice(value, name, choices) {
     if (choices.includes(value))
@@ -54,16 +56,20 @@ function resolveTarget(opts) {
     return targets[0] ?? null;
 }
 function resolveStatus(opts) {
-    const values = [opts.status, opts.draft ? "draft" : undefined, opts.disabled ? "disabled" : undefined].filter(Boolean);
+    const values = [opts.status, opts.disabled ? "disabled" : undefined].filter(Boolean);
     if (values.length > 1)
-        return error("Conflicting status", "Use only one of --status, --draft, or --disabled");
+        return error("Conflicting status", "Use only one of --status or --disabled");
     return values[0] ? parseChoice(values[0], "status", WORK_STATUSES) : "published";
 }
+function resolveVisibility(value) {
+    return value ? parseChoice(value, "visibility", WORK_VISIBILITIES) : undefined;
+}
 function printWork(work) {
     table([work], [
         { key: "id", label: "ID" },
         { key: "slug", label: "Slug" },
         { key: "status", label: "Status" },
+        { key: "visibility", label: "Visibility" },
         { key: "targetType", label: "Target" },
         { key: "targetRef", label: "Ref" },
         { key: "latestVersion", label: "Version" },
@@ -93,6 +99,19 @@ async function confirmDelete(opts) {
     if (answer !== "y" && answer !== "yes")
         return error("Cancelled");
 }
+async function publishWorkVersion(id, opts) {
+    const client = createClient();
+    try {
+        const result = await client.works.publishVersion(id);
+        if (jsonRequested(opts))
+            return outJson(result);
+        ok(`Work version updated: v${result.version.version}`);
+        printWork(result.work);
+    }
+    catch (e) {
+        handleHttp(e);
+    }
+}
 export function registerWorks(program) {
     const worksCmd = program.command("works").description("Work management");
     worksCmd
@@ -111,6 +130,7 @@ export function registerWorks(program) {
                 { key: "id", label: "ID" },
                 { key: "slug", label: "Slug" },
                 { key: "status", label: "Status" },
+                { key: "visibility", label: "Visibility" },
                 { key: "targetType", label: "Target" },
                 { key: "targetRef", label: "Ref" },
                 { key: "latestVersion", label: "Version" },
@@ -167,9 +187,9 @@ export function registerWorks(program) {
         .option("--file <path>", "Publish a HTML file")
         .option("--dir <path>", "Publish a directory site")
         .option("--port <port>", "Publish a public sandbox port")
-        .option("--draft", "Create as draft")
         .option("--disabled", "Create as disabled")
-        .option("--status <status>", "Work status: draft, published, disabled")
+        .option("--status <status>", "Work status: published, disabled")
+        .option("--visibility <visibility>", "Work visibility: public, space")
         .option("--work-scope <scope>", "Scope granted to the work runtime (space.view, session.view, file.view, taskrun.view)", collectOption, [])
         .option("--viewer-scope <scope>", "Scope viewers may request (session.prompt.readonly, session.prompt.fullaccess, generation.create, user.space.list, user.session.list, user.usage.read)", collectOption, [])
         .option("--meta <json>", "Work metadata as a JSON object")
@@ -194,6 +214,7 @@ export function registerWorks(program) {
             spaceId,
             slug,
             status,
+            visibility: resolveVisibility(opts.visibility),
             targetType: target.targetType,
             targetRef: target.targetRef,
             workScopes: opts.workScope,
@@ -208,20 +229,44 @@ export function registerWorks(program) {
             printWork(result.work);
         }
         catch (e) {
-            handleHttp(e);
+            if (!(e instanceof HttpError) || e.status !== 409)
+                handleHttp(e);
+            try {
+                const { works } = await client.works.listBySpace(spaceId);
+                const existingWork = works.find((work) => work.slug === slug);
+                if (!existingWork)
+                    return handleHttp(e);
+                const { work } = await client.works.update(existingWork.id, {
+                    status: status === "published" && existingWork.status !== "published" ? existingWork.status : status,
+                    visibility: resolveVisibility(opts.visibility),
+                    targetType: target.targetType,
+                    targetRef: target.targetRef,
+                    workScopes: opts.workScope,
+                    allowedViewerScopes: opts.viewerScope,
+                    meta,
+                });
+                const publishedVersion = status === "published" ? await client.works.publishVersion(work.id) : null;
+                const result = publishedVersion ?? { work };
+                if (jsonRequested(opts))
+                    return outJson(result);
+                ok(status === "published" && publishedVersion ? `Work version updated: v${publishedVersion.version.version}` : `Work updated: ${work.id}`);
+                printWork(result.work);
+            }
+            catch (fallbackError) {
+                handleHttp(fallbackError);
+            }
         }
     });
     worksCmd
         .command("update <id>")
-        .description("Update work settings or publish a new version")
+        .description("Update work settings")
         .option("--slug <slug>", "New work slug")
         .option("--file <path>", "Use a HTML file target")
         .option("--dir <path>", "Use a directory site target")
         .option("--port <port>", "Use a public sandbox port target")
-        .option("--draft", "Set status to draft")
         .option("--disabled", "Set status to disabled")
-        .option("--status <status>", "Work status: draft, published, disabled")
-        .option("--publish-version", "Force publishing a new version")
+        .option("--status <status>", "Work status: published, disabled")
+        .option("--visibility <visibility>", "Work visibility: public, space")
         .option("--work-scope <scope>", "Scope granted to the work runtime (space.view, session.view, file.view, taskrun.view)", collectOption, [])
         .option("--viewer-scope <scope>", "Scope viewers may request (session.prompt.readonly, session.prompt.fullaccess, generation.create, user.space.list, user.session.list, user.usage.read)", collectOption, [])
         .option("--clear-work-scopes", "Clear work runtime scopes")
@@ -257,29 +302,45 @@ export function registerWorks(program) {
                 showCohubBar: opts.showCohubBar,
             });
         }
+        const nextStatus = opts.status || opts.disabled ? resolveStatus(opts) : undefined;
+        const currentWork = nextStatus === "published" ? (await client.works.get(id)).work : null;
         const input = compactObject({
             slug: opts.slug,
-            status: opts.status || opts.draft || opts.disabled ? resolveStatus(opts) : undefined,
+            status: nextStatus === "published" && currentWork?.status !== "published" ? currentWork?.status : nextStatus,
+            visibility: resolveVisibility(opts.visibility),
             targetType: target?.targetType,
             targetRef: target?.targetRef,
-            publishVersion: opts.publishVersion || undefined,
             workScopes: opts.clearWorkScopes ? [] : opts.workScope?.length ? opts.workScope : undefined,
             allowedViewerScopes: opts.clearViewerScopes ? [] : opts.viewerScope?.length ? opts.viewerScope : undefined,
             meta,
         });
         if (Object.keys(input).length === 0)
-            return error("Nothing to update", "Pass --slug, --file, --dir, --port, --status, --publish-version, --work-scope, --viewer-scope, --clear-work-scopes, --clear-viewer-scopes, --meta, --hide-cohub-bar, or --show-cohub-bar.");
+            return error("Nothing to update", "Pass --slug, --file, --dir, --port, --status, --visibility, --work-scope, --viewer-scope, --clear-work-scopes, --clear-viewer-scopes, --meta, --hide-cohub-bar, or --show-cohub-bar.");
         try {
-            const result = await client.works.update(id, input);
+            const updated = await client.works.update(id, input);
+            const publishedVersion = nextStatus === "published" && currentWork?.status !== "published"
+                ? await client.works.publishVersion(updated.work.id)
+                : null;
+            const result = publishedVersion ?? updated;
             if (jsonRequested(opts))
                 return outJson(result);
-            ok("Work updated");
+            ok(publishedVersion ? `Work published: v${publishedVersion.version.version}` : "Work updated");
             printWork(result.work);
         }
         catch (e) {
             handleHttp(e);
         }
     });
+    worksCmd
+        .command("publish-version <id>")
+        .description("Publish or update the current work version")
+        .option("--json", "Output as JSON")
+        .action(publishWorkVersion);
+    worksCmd
+        .command("release <id>", { hidden: true })
+        .description("Deprecated alias for publish-version")
+        .option("--json", "Output as JSON")
+        .action(publishWorkVersion);
     worksCmd
         .command("versions <id>")
         .description("List work versions")
@@ -293,10 +354,9 @@ export function registerWorks(program) {
             table(result.versions, [
                 { key: "version", label: "Version" },
                 { key: "id", label: "ID" },
-                { key: "status", label: "Status" },
                 { key: "targetType", label: "Target" },
                 { key: "targetRef", label: "Ref" },
-                { key: "publishedAt", label: "Published" },
+                { key: "createdAt", label: "Created" },
             ]);
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "1.20.6",
+  "version": "2.0.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.9",
+    "@neta-art/generation": "^0.1.10",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "1.34.0"
+    "@neta-art/cohub": "2.0.0"
   },
   "publishConfig": {
     "access": "public"