@neta-art/cohub-cli 1.17.5 → 1.19.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/spaces.js

@@ -26,6 +26,21 @@ function parseInteger(value, name, options = {}) {
 function collectOption(value, previous = []) {
     return [...previous, value];
 }
+function parseEnvOptions(values) {
+    if (!values?.length)
+        return undefined;
+    const env = {};
+    for (const value of values) {
+        const index = value.indexOf("=");
+        if (index <= 0)
+            return error("Invalid env", "Use --env KEY=value");
+        const name = value.slice(0, index).trim();
+        if (!name)
+            return error("Invalid env", "Env name is required");
+        env[name] = value.slice(index + 1);
+    }
+    return env;
+}
 function parseChoice(value, name, choices) {
     if (choices.includes(value))
         return value;
@@ -218,6 +233,7 @@ async function sendPrompt(command, words, opts) {
             provider: opts.provider,
             accessMode: opts.readOnly ? "read_only" : "full_access",
             intent: opts.steer ? "steer" : undefined,
+            env: parseEnvOptions(opts.env),
             schedule,
             labelRefs: opts.label?.length ? opts.label : undefined,
         });
@@ -249,6 +265,7 @@ export function registerPrompt(program) {
         .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("--env <key=value>", "Set an environment variable for this turn", collectOption, [])
         .option("--image <path>", "Attach an image", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(program, words, opts));
@@ -410,6 +427,7 @@ export function registerSpaces(program) {
         .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("--env <key=value>", "Set an environment variable for this turn", collectOption, [])
         .option("--image <path>", "Attach an image", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(spacesCmd, words, opts));

package/dist/commands/works.js

@@ -145,8 +145,8 @@ 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("--json", "Output as JSON")
         .action(async (slug, opts) => {
@@ -188,8 +188,8 @@ 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")

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.17.5",
+  "version": "1.19.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "UNLICENSED",
@@ -16,7 +16,7 @@
     "@neta-art/generation": "^0.1.5",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "1.28.2"
+    "@neta-art/cohub": "1.30.0"
   },
   "publishConfig": {
     "access": "public"