@neta-art/cohub-cli 2.2.9 → 2.3.0

package/dist/commands/profile.js

@@ -3,6 +3,39 @@ import { createClient } from "../client.js";
 import { json as outJson, jsonRequested, ok, error, handleHttp } from "../output.js";
 export function registerProfile(program) {
     const profileCmd = program.command("profile").description("Manage your profile");
+    profileCmd
+        .command("get <username>")
+        .description("Show a public user profile")
+        .option("--json", "Output as JSON")
+        .action(async (username, opts) => {
+        const client = createClient();
+        try {
+            const result = await client.users.getByUsername(username);
+            if (jsonRequested(opts))
+                return outJson(result);
+            const handle = result.profile.username ? `@${result.profile.username}` : result.profile.userUuid;
+            console.log(`\n  ${result.profile.displayName} (${handle})`);
+            console.log(`  Spaces: ${result.spaces.length}`);
+            console.log(`  Works:  ${result.works.length}\n`);
+            if (result.spaces.length > 0) {
+                console.log("  Spaces:");
+                for (const space of result.spaces) {
+                    console.log(`    - ${space.name} [${space.accessLabel}] ${space.spaceUrl}`);
+                }
+                console.log("");
+            }
+            if (result.works.length > 0) {
+                console.log("  Works:");
+                for (const work of result.works) {
+                    console.log(`    - ${work.title} ${work.publicUrl}`);
+                }
+                console.log("");
+            }
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
     profileCmd
         .command("update")
         .description("Update your profile")

package/dist/commands/referrals.d.ts

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

package/dist/commands/referrals.js

@@ -0,0 +1,84 @@
+import { createClient } from "../client.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+function referralUrl(code) {
+    const origin = process.env.COHUB_WEB_URL?.replace(/\/+$/, "") ?? "https://cohub.run";
+    return `${origin}/referrals/${code}`;
+}
+async function confirmRotate(opts) {
+    if (opts.yes)
+        return;
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return error("Confirmation required", "Pass --yes to replace the referral link.");
+    }
+    process.stdout.write("The current referral link will stop working. Continue? [y/N] ");
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+        break;
+    }
+    const answer = Buffer.concat(chunks).toString().trim().toLowerCase();
+    if (answer !== "y" && answer !== "yes")
+        return error("Cancelled");
+}
+export function registerReferrals(program) {
+    const command = program
+        .command("referrals")
+        .description("View and manage your referral link")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const client = createClient();
+        try {
+            const result = await client.referrals.getMine();
+            const output = { ...result, url: referralUrl(result.code) };
+            if (jsonRequested(opts))
+                return outJson(output);
+            console.log(`\nReferral link: ${output.url}`);
+            console.log(`Rewarded: ${result.summary.rewarded}`);
+            console.log(`Earned: $${result.summary.earnedUsd.toFixed(2)}\n`);
+        }
+        catch (error) {
+            handleHttp(error);
+        }
+    });
+    command
+        .command("ls")
+        .alias("list")
+        .description("List your referrals")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const client = createClient();
+        try {
+            const result = await client.referrals.getMine();
+            if (jsonRequested(opts))
+                return outJson(result);
+            table(result.items, [
+                { key: "id", label: "ID" },
+                { key: "status", label: "Status" },
+                { key: "claimedAt", label: "Claimed" },
+                { key: "rewardedAt", label: "Rewarded" },
+            ]);
+        }
+        catch (error) {
+            handleHttp(error);
+        }
+    });
+    command
+        .command("rotate")
+        .description("Replace your referral link")
+        .option("-y, --yes", "Confirm replacement")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await confirmRotate(opts);
+        const client = createClient();
+        try {
+            const result = await client.referrals.rotateCode();
+            const output = { ...result, url: referralUrl(result.code) };
+            if (jsonRequested(opts))
+                return outJson(output);
+            ok(`Referral link rotated: ${output.url}`);
+        }
+        catch (error) {
+            handleHttp(error);
+        }
+    });
+}

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");
@@ -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 ──

package/dist/index.js

@@ -10,6 +10,7 @@ import { registerModels } from "./commands/models.js";
 import { registerProfile } from "./commands/profile.js";
 import { registerSearch } from "./commands/search.js";
 import { registerReferences } from "./commands/references.js";
+import { registerReferrals } from "./commands/referrals.js";
 import { registerPrompt, registerSpaces } from "./commands/spaces.js";
 import { maybeHandleRunCommand } from "./commands/run.js";
 import { registerSandbox } from "./commands/sandbox.js";
@@ -41,6 +42,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"
@@ -67,6 +69,7 @@ registerGenerations(program);
 registerModels(program);
 registerSearch(program);
 registerReferences(program);
+registerReferrals(program);
 registerTasks(program);
 registerCronJobs(program);
 registerWorks(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "2.2.9",
+  "version": "2.3.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.12",
+    "@neta-art/generation": "^0.1.13",
     "commander": "^14.0.3",
     "sharp": "^0.34.5",
-    "@neta-art/cohub": "2.8.0"
+    "@neta-art/cohub": "2.10.0"
   },
   "publishConfig": {
     "access": "public"