@neta-art/cohub-cli 2.2.8 → 2.2.10

package/dist/commands/generations.js

@@ -333,6 +333,17 @@ Examples:
             if (jsonRequested(opts))
                 return outJson(savedPaths.length > 0 ? { ...result, taskRunId: created.taskRunId, savedPaths } : { ...result, taskRunId: created.taskRunId });
             printGeneration(result.output);
+            if (result.requestId || result.cost !== undefined || result.billing) {
+                const details = [
+                    result.requestId ? `request ID: ${result.requestId}` : null,
+                    result.cost !== undefined ? `cost: ${result.cost}` : null,
+                    result.billing
+                        ? `billing: ${result.billing.status}${result.billing.amountUsd > 0 ? ` ${result.billing.amountUsd}` : ""}${result.billing.reason ? ` (${result.billing.reason})` : ""}`
+                        : null,
+                ].filter(Boolean).join(", ");
+                if (details)
+                    process.stderr.write(`  ${details}\n`);
+            }
             if (savedPaths.length > 0)
                 ok(`Saved to ${savedPaths.join(", ")}`);
         }

package/dist/commands/spaces.js

@@ -252,6 +252,85 @@ async function sendPrompt(command, words, opts) {
         handleHttp(e);
     }
 }
+async function runCompletionCommand(command, words, opts) {
+    const spaceId = resolveSpace(command);
+    const content = words.join(" ").trim();
+    if (!content && process.stdin.isTTY) {
+        return error("Message required", "Pass content args or pipe via stdin");
+    }
+    let text = content;
+    if (!text && !process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        text = Buffer.concat(chunks).toString().trim();
+    }
+    if (!text)
+        return error("Message required", "Pass content args or pipe via stdin");
+    const temperature = opts.temperature !== undefined ? Number(opts.temperature) : undefined;
+    if (temperature !== undefined && !Number.isFinite(temperature)) {
+        return error("Invalid temperature", "--temperature must be a number");
+    }
+    const maxTokens = opts.maxTokens !== undefined ? Number(opts.maxTokens) : undefined;
+    if (maxTokens !== undefined && (!Number.isFinite(maxTokens) || maxTokens <= 0)) {
+        return error("Invalid max tokens", "--max-tokens must be a positive number");
+    }
+    const thinkingLevel = opts.thinkingLevel?.trim() || undefined;
+    if (thinkingLevel
+        && !new Set(["off", "minimal", "low", "medium", "high", "xhigh"]).has(thinkingLevel)) {
+        return error("Invalid thinking level", "Use off|minimal|low|medium|high|xhigh");
+    }
+    const client = createClient();
+    const input = {
+        provider: opts.provider,
+        model: opts.model,
+        systemPromptPath: opts.systemPrompt,
+        messages: [{ role: "user", content: [{ type: "text", text }] }],
+        temperature,
+        maxTokens,
+        thinkingLevel: thinkingLevel,
+    };
+    try {
+        if (opts.stream) {
+            const iterator = client.space(spaceId).streamCompletion(input);
+            let step = await iterator.next();
+            let finalResult = null;
+            while (!step.done) {
+                const event = step.value;
+                if (event.type === "delta") {
+                    if (!jsonRequested(opts))
+                        process.stdout.write(event.text);
+                }
+                else if (event.type === "thinking_delta" && !jsonRequested(opts)) {
+                    process.stderr.write(event.text);
+                }
+                step = await iterator.next();
+            }
+            finalResult = step.value;
+            if (jsonRequested(opts))
+                return outJson(finalResult);
+            process.stdout.write("\n");
+            if (finalResult.usage?.totalTokens != null) {
+                process.stderr.write(`  tokens: ${finalResult.usage.totalTokens}\n`);
+            }
+            return;
+        }
+        const result = await client.space(spaceId).completion(input);
+        if (jsonRequested(opts))
+            return outJson(result);
+        const textOut = result.message.content
+            .filter((block) => block.type === "text")
+            .map((block) => block.text)
+            .join("");
+        console.log(textOut);
+        if (result.usage?.totalTokens != null) {
+            process.stderr.write(`\n  tokens: ${result.usage.totalTokens}\n`);
+        }
+    }
+    catch (e) {
+        handleHttp(e);
+    }
+}
 export function registerPrompt(program) {
     program
         .command("prompt [content...]")
@@ -272,6 +351,18 @@ export function registerPrompt(program) {
         .option("--image <path>", "Attach an image", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(program, words, opts));
+    program
+        .command("completion [content...]")
+        .description("Raw LLM completion with full message control")
+        .option("-m, --model <model>", "Model name")
+        .option("-p, --provider <provider>", "Provider name")
+        .option("--system-prompt <path>", "Space-relative system prompt markdown path")
+        .option("--stream", "Stream tokens via SSE")
+        .option("--temperature <n>", "Sampling temperature")
+        .option("--max-tokens <n>", "Maximum output tokens")
+        .option("--thinking-level <level>", "Thinking level: off|minimal|low|medium|high|xhigh")
+        .option("--json", "Output as JSON")
+        .action((words, opts) => runCompletionCommand(program, words, opts));
 }
 export function registerSpaces(program) {
     const spacesCmd = program.command("spaces").description("Space management");
@@ -436,7 +527,7 @@ export function registerSpaces(program) {
                 const result = await client.space(id).updateConfig({ sandbox: { ...(autoDestroy ? { autoDestroy } : {}), ...(spec ? { spec } : {}) } });
                 if (jsonRequested(opts))
                     return outJson(result);
-                ok(`Space config updated${autoDestroy ? ` — sandbox auto destroy: ${formatAutoDestroy(autoDestroy)}` : ""}${spec ? ` — sandbox spec: ${spec}` : ""}`);
+                ok(`Space config updated${autoDestroy ? ` — sandbox auto destroy: ${formatAutoDestroy(autoDestroy)}` : ""}${spec ? ` — sandbox spec: ${spec}` : ""}${result.sandbox?.pendingRestart ? " — restart the sandbox to apply" : ""}`);
                 return;
             }
             const result = await client.space(id).getConfig();
@@ -476,6 +567,19 @@ export function registerSpaces(program) {
         .option("--image <path>", "Attach an image", collectOption, [])
         .option("--json", "Output as JSON")
         .action((words, opts) => sendPrompt(spacesCmd, words, opts));
+    // ── spaces completion ──
+    spacesCmd
+        .command("completion [content...]")
+        .description("Raw LLM completion with full message control")
+        .option("-m, --model <model>", "Model name")
+        .option("-p, --provider <provider>", "Provider name")
+        .option("--system-prompt <path>", "Space-relative system prompt markdown path")
+        .option("--stream", "Stream tokens via SSE")
+        .option("--temperature <n>", "Sampling temperature")
+        .option("--max-tokens <n>", "Maximum output tokens")
+        .option("--thinking-level <level>", "Thinking level: off|minimal|low|medium|high|xhigh")
+        .option("--json", "Output as JSON")
+        .action((words, opts) => runCompletionCommand(spacesCmd, words, opts));
     // ── spaces files ──
     registerFiles(spacesCmd);
     // ── spaces sessions ──
@@ -839,7 +943,73 @@ function registerMods(spacesCmd) {
         }
     });
 }
-// ── File operations ──
+function formatDiffBytes(value) {
+    if (value === null || value === undefined)
+        return "—";
+    if (value < 1024)
+        return `${value} B`;
+    if (value < 1024 * 1024)
+        return `${(value / 1024).toFixed(value >= 10 * 1024 ? 0 : 1)} KB`;
+    return `${(value / (1024 * 1024)).toFixed(1)} MB`;
+}
+function printDiffFile(file) {
+    if (file.kind !== "text") {
+        const size = file.oldSize !== undefined || file.newSize !== undefined
+            ? `  (${formatDiffBytes(file.oldSize)} → ${formatDiffBytes(file.newSize)})`
+            : "";
+        console.log(`${file.status ?? "?"}  ${file.path}  (${file.kind})${size}`);
+        return;
+    }
+    if (file.lines.length === 0) {
+        console.log(`${file.status ?? "?"}  ${file.path}  (no textual changes)`);
+        return;
+    }
+    for (const line of file.lines) {
+        if (line.type === "add")
+            console.log(`+${line.text}`);
+        else if (line.type === "del")
+            console.log(`-${line.text}`);
+        else if (line.type === "hunk")
+            console.log(line.text);
+        else if (line.type === "meta")
+            continue;
+        else
+            console.log(` ${line.text}`);
+    }
+    if (file.truncated)
+        console.log("  … truncated");
+}
+function printDiffSummary(summary, options) {
+    if (summary.files.length === 0) {
+        console.log(options?.emptyLabel ?? "  (no changes)");
+        return;
+    }
+    if (summary.stats) {
+        const parts = [`${summary.stats.changedFileCount} file(s)`];
+        if (summary.stats.additions > 0)
+            parts.push(`+${summary.stats.additions}`);
+        if (summary.stats.deletions > 0)
+            parts.push(`-${summary.stats.deletions}`);
+        console.log(`  ${parts.join(" · ")}`);
+    }
+    table(summary.files.map((file) => ({
+        status: file.status,
+        path: file.oldPath ? `${file.oldPath} → ${file.path}` : file.path,
+        plus: file.additions ?? (file.binary || file.asset ? "-" : "0"),
+        minus: file.deletions ?? (file.binary || file.asset ? "-" : "0"),
+    })), [
+        { key: "status", label: "St" },
+        { key: "path", label: "Path" },
+        { key: "plus", label: "+" },
+        { key: "minus", label: "-" },
+    ]);
+    if (options?.footer)
+        console.log(options.footer);
+    else if (summary.incomplete)
+        console.log("  … partial scan");
+    else if (summary.truncated)
+        console.log("  … truncated");
+}
 function registerFiles(spacesCmd) {
     const filesCmd = spacesCmd
         .command("files")
@@ -969,6 +1139,37 @@ function registerFiles(spacesCmd) {
             handleHttp(e);
         }
     });
+    filesCmd
+        .command("diff [path]")
+        .description("Show pending workspace changes vs last checkpoint")
+        .option("--json", "Output as JSON")
+        .action(async (path, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            if (path) {
+                const file = await client.space(spaceId).files.diffFile(path);
+                if (jsonRequested(opts))
+                    return outJson(file);
+                printDiffFile(file);
+                return;
+            }
+            const summary = await client.space(spaceId).files.diff();
+            if (jsonRequested(opts))
+                return outJson(summary);
+            printDiffSummary(summary, {
+                emptyLabel: "  (no pending changes)",
+                footer: summary.incomplete
+                    ? "  … partial scan"
+                    : summary.truncated
+                        ? "  … truncated"
+                        : null,
+            });
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
 }
 function registerSessions(spacesCmd) {
     const sessionsCmd = spacesCmd
@@ -1585,4 +1786,32 @@ function registerCheckpoints(spacesCmd) {
             handleHttp(e);
         }
     });
+    cpCmd
+        .command("diff <checkpointId> [path]")
+        .description("Show checkpoint diff vs parent (or --base)")
+        .option("--base <checkpointId>", "Compare against another checkpoint")
+        .option("--json", "Output as JSON")
+        .action(async (checkpointId, path, opts) => {
+        const spaceId = resolveSpace(spacesCmd);
+        const client = createClient();
+        try {
+            if (path) {
+                const file = await client.space(spaceId).checkpoints(checkpointId).diff.file(path, { base: opts.base ?? null });
+                if (jsonRequested(opts))
+                    return outJson(file);
+                printDiffFile(file);
+                return;
+            }
+            const summary = await client.space(spaceId).checkpoints(checkpointId).diff.summary({ base: opts.base ?? null });
+            if (jsonRequested(opts))
+                return outJson(summary);
+            printDiffSummary(summary, {
+                emptyLabel: "  (no changes)",
+                footer: summary.truncated ? "  … truncated" : null,
+            });
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
 }

package/dist/index.js

@@ -41,6 +41,7 @@ Common commands:
   cohub profile avatar ./avatar.png
   cohub spaces ls
   cohub -s <space-id> prompt "Fix the failing tests"
+  cohub -s <space-id> completion "Summarize AGENTS.md" --system-prompt AGENTS.md --stream
   cohub -s <space-id> run -- git status
   cohub sandbox up ./my-project
   cohub search "release notes"

package/dist/output.js

@@ -1,4 +1,5 @@
 import process from "node:process";
+import { extractBillingPayload } from "@neta-art/cohub";
 function colWidth(rows, key, label) {
     const maxVal = rows.reduce((m, r) => {
         const v = r[key] ?? "";
@@ -55,8 +56,6 @@ function errorMessageFromBody(body) {
     const errorBody = body;
     if (typeof errorBody.message === "string" && errorBody.message.trim())
         return errorBody.message;
-    if (typeof errorBody.error?.message === "string" && errorBody.error.message.trim())
-        return errorBody.error.message;
     return null;
 }
 function debugErrorMetaFromBody(body) {
@@ -64,7 +63,7 @@ function debugErrorMetaFromBody(body) {
         return [];
     const errorBody = body;
     const items = [];
-    const code = typeof errorBody.code === "string" ? errorBody.code : typeof errorBody.error?.code === "string" ? errorBody.error.code : null;
+    const code = typeof errorBody.code === "string" ? errorBody.code : null;
     if (code)
         items.push(code);
     if (typeof errorBody.requestId === "string")
@@ -101,6 +100,14 @@ export function handleHttp(e) {
     }
     const status = e.status;
     const body = e.body;
+    if (status === 402) {
+        const conversion = extractBillingPayload(body)?.conversion;
+        if (conversion) {
+            return error(conversion.title || "Upgrade required", [conversion.message, "Manage billing at your Cohub account settings."]
+                .filter(Boolean)
+                .join(" · "));
+        }
+    }
     const presentation = errorPresentationFromHttpError(e);
     const message = presentation?.message ?? errorMessageFromBody(body) ?? (e instanceof Error ? e.message : String(e));
     const fetchDetail = fetchFailureDetail(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.2.8",
+  "version": "2.2.10",
   "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.10",
+    "@neta-art/generation": "^0.1.12",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "2.7.1"
+    "@neta-art/cohub": "2.9.0"
   },
   "publishConfig": {
     "access": "public"