@neta-art/cohub-cli 1.18.0 → 1.20.0

package/dist/commands/me.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerMe(program: Command): void;

package/dist/commands/me.js

@@ -0,0 +1,68 @@
+import { createClient } from "../client.js";
+import { handleHttp, json as outJson, jsonRequested, table } from "../output.js";
+function parseInteger(value, name, min) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isSafeInteger(parsed) || parsed < min) {
+        process.stderr.write(`\n  ✗ Invalid ${name}\n    ${name} must be an integer ≥ ${min}\n\n`);
+        process.exit(1);
+    }
+    return parsed;
+}
+export function registerMe(program) {
+    const meCmd = program.command("me").description("Account-level data across your spaces");
+    meCmd
+        .command("sessions")
+        .alias("list-sessions")
+        .description("List sessions you created across all spaces")
+        .option("--limit <n>", "Maximum number of sessions (default 20)")
+        .option("--cursor <cursor>", "Pagination cursor from a previous result")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const client = createClient();
+        try {
+            const result = await client.user.listSessions({
+                limit: opts.limit ? parseInteger(opts.limit, "limit", 1) : undefined,
+                cursor: opts.cursor ?? null,
+            });
+            if (jsonRequested(opts))
+                return outJson(result);
+            if (result.sessions.length === 0) {
+                console.log("  (empty)");
+                return;
+            }
+            table(result.sessions, [
+                { key: "id", label: "ID" },
+                { key: "spaceId", label: "Space" },
+                { key: "title", label: "Title" },
+                { key: "totalMessages", label: "Messages" },
+                { key: "createdAt", label: "Created" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    meCmd
+        .command("usage [days]")
+        .description("Your aggregated usage across all spaces (default: 30 days)")
+        .option("--json", "Output as JSON")
+        .action(async (days, opts) => {
+        const client = createClient();
+        try {
+            const usage = await client.user.getUsage(days ? parseInteger(days, "days", 1) : 30);
+            if (jsonRequested(opts))
+                return outJson(usage);
+            console.log("\n  Summary:");
+            table([usage.summary], [
+                { key: "totalTokens", label: "Tokens" },
+                { key: "costTotal", label: "Cost ($)" },
+                { key: "requestCount", label: "Requests" },
+                { key: "successCount", label: "Success" },
+                { key: "errorCount", label: "Errors" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}

package/dist/commands/works.js

@@ -24,6 +24,23 @@ function parseJsonObject(value, name) {
 function compactObject(input) {
     return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
 }
+function withCohubBarMeta(input) {
+    if (!input.hideCohubBar && !input.showCohubBar)
+        return input.meta;
+    const meta = input.meta ? { ...input.meta } : {};
+    const presentation = meta.presentation && typeof meta.presentation === "object" && !Array.isArray(meta.presentation)
+        ? { ...meta.presentation }
+        : {};
+    if (input.hideCohubBar)
+        presentation.hideCohubBar = true;
+    if (input.showCohubBar)
+        delete presentation.hideCohubBar;
+    if (Object.keys(presentation).length > 0)
+        meta.presentation = presentation;
+    else
+        delete meta.presentation;
+    return Object.keys(meta).length > 0 ? meta : null;
+}
 function resolveTarget(opts) {
     const targets = [
         opts.file ? { targetType: "file", targetRef: opts.file } : null,
@@ -145,17 +162,26 @@ export function registerWorks(program) {
         .option("--draft", "Create as draft")
         .option("--disabled", "Create as disabled")
         .option("--status <status>", "Work status: draft, published, disabled")
-        .option("--work-scope <scope>", "Scope granted to the work runtime", collectOption, [])
-        .option("--viewer-scope <scope>", "Scope viewers may request", collectOption, [])
+        .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")
+        .option("--hide-cohub-bar", "Hide the Cohub footer bar on the public work page")
+        .option("--show-cohub-bar", "Show the Cohub footer bar on the public work page")
         .option("--json", "Output as JSON")
         .action(async (slug, opts) => {
+        if (opts.hideCohubBar && opts.showCohubBar)
+            return error("Conflicting Cohub bar options", "Use either --hide-cohub-bar or --show-cohub-bar.");
         const target = resolveTarget(opts);
         if (!target)
             return error("Missing target", "Use one of --file, --dir, or --port.");
         const spaceId = resolveSpace(worksCmd);
         const client = createClient();
         const status = resolveStatus(opts);
+        const meta = withCohubBarMeta({
+            meta: parseJsonObject(opts.meta, "meta"),
+            hideCohubBar: opts.hideCohubBar,
+            showCohubBar: opts.showCohubBar,
+        });
         const input = {
             spaceId,
             slug,
@@ -164,7 +190,7 @@ export function registerWorks(program) {
             targetRef: target.targetRef,
             workScopes: opts.workScope,
             allowedViewerScopes: opts.viewerScope,
-            meta: parseJsonObject(opts.meta, "meta"),
+            meta,
         };
         try {
             const result = await client.works.create(input);
@@ -188,18 +214,41 @@ export function registerWorks(program) {
         .option("--disabled", "Set status to disabled")
         .option("--status <status>", "Work status: draft, published, disabled")
         .option("--publish-version", "Force publishing a new version")
-        .option("--work-scope <scope>", "Scope granted to the work runtime", collectOption, [])
-        .option("--viewer-scope <scope>", "Scope viewers may request", collectOption, [])
+        .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")
         .option("--clear-viewer-scopes", "Clear viewer-requestable scopes")
         .option("--meta <json>", "Work metadata as a JSON object")
+        .option("--hide-cohub-bar", "Hide the Cohub footer bar on the public work page")
+        .option("--show-cohub-bar", "Show the Cohub footer bar on the public work page")
         .option("--json", "Output as JSON")
         .action(async (id, opts) => {
+        if (opts.hideCohubBar && opts.showCohubBar)
+            return error("Conflicting Cohub bar options", "Use either --hide-cohub-bar or --show-cohub-bar.");
         const target = resolveTarget(opts);
         if (opts.clearWorkScopes && opts.workScope?.length)
             return error("Conflicting work scopes", "Use either --work-scope or --clear-work-scopes.");
         if (opts.clearViewerScopes && opts.viewerScope?.length)
             return error("Conflicting viewer scopes", "Use either --viewer-scope or --clear-viewer-scopes.");
+        const hasMetaUpdate = opts.meta !== undefined || opts.hideCohubBar || opts.showCohubBar;
+        const client = createClient();
+        let meta;
+        if (hasMetaUpdate) {
+            let baseMeta = opts.meta !== undefined ? parseJsonObject(opts.meta, "meta") ?? null : undefined;
+            if (baseMeta === undefined && (opts.hideCohubBar || opts.showCohubBar)) {
+                try {
+                    baseMeta = (await client.works.get(id)).work.meta;
+                }
+                catch (e) {
+                    handleHttp(e);
+                }
+            }
+            meta = withCohubBarMeta({
+                meta: baseMeta,
+                hideCohubBar: opts.hideCohubBar,
+                showCohubBar: opts.showCohubBar,
+            });
+        }
         const input = compactObject({
             slug: opts.slug,
             status: opts.status || opts.draft || opts.disabled ? resolveStatus(opts) : undefined,
@@ -208,11 +257,10 @@ export function registerWorks(program) {
             publishVersion: opts.publishVersion || undefined,
             workScopes: opts.clearWorkScopes ? [] : opts.workScope?.length ? opts.workScope : undefined,
             allowedViewerScopes: opts.clearViewerScopes ? [] : opts.viewerScope?.length ? opts.viewerScope : undefined,
-            meta: opts.meta !== undefined ? parseJsonObject(opts.meta, "meta") ?? null : 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, or --meta.");
-        const client = createClient();
+            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.");
         try {
             const result = await client.works.update(id, input);
             if (jsonRequested(opts))

package/dist/index.js

@@ -5,6 +5,7 @@ import { registerAuth } from "./commands/auth.js";
 import { registerChannels } from "./commands/channels.js";
 import { registerCronJobs } from "./commands/cron-jobs.js";
 import { registerGenerations } from "./commands/generations.js";
+import { registerMe } from "./commands/me.js";
 import { registerModels } from "./commands/models.js";
 import { registerProfile } from "./commands/profile.js";
 import { registerSearch } from "./commands/search.js";
@@ -51,6 +52,7 @@ Environment:
 `);
 registerAuth(program);
 registerProfile(program);
+registerMe(program);
 registerPrompt(program);
 registerSpaces(program);
 registerChannels(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "1.18.0",
+  "version": "1.20.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.5",
+    "@neta-art/generation": "^0.1.7",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "1.29.0"
+    "@neta-art/cohub": "1.31.0"
   },
   "publishConfig": {
     "access": "public"