@neta-art/cohub-cli 10.1.0 → 10.2.0

package/dist/command-input.d.ts

@@ -0,0 +1,4 @@
+export declare function collectOption(value: string, previous?: string[]): string[];
+export declare function readPromptContent(words: string[], options?: {
+    allowEmpty?: boolean;
+}): Promise<string>;

package/dist/command-input.js

@@ -0,0 +1,16 @@
+import { error } from "./output.js";
+export function collectOption(value, previous = []) {
+    return [...previous, value];
+}
+export async function readPromptContent(words, options = {}) {
+    let content = words.join(" ");
+    if (!content && !process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        content = Buffer.concat(chunks).toString().trim();
+    }
+    if (!content && !options.allowEmpty)
+        return error("No content", "Pass as argument or pipe via stdin");
+    return content;
+}

package/dist/commands/app-commerce.js

@@ -1,9 +1,7 @@
 import { resolveExecutionAppId, } from "@neta-art/cohub";
 import { createClient } from "../client.js";
+import { collectOption } from "../command-input.js";
 import { error, formatLocalDateTime, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
-function collectOption(value, previous = []) {
-    return [...previous, value];
-}
 function requireText(value, label, flag) {
     const text = value?.trim();
     if (text)

package/dist/commands/decision.d.ts

@@ -0,0 +1,4 @@
+import type { DecisionStateImage } from "@neta-art/cohub";
+import type { Command } from "commander";
+export declare function mergeDecisionState(state: unknown, text: string, images: DecisionStateImage[]): unknown;
+export declare function registerDecisionCommand(parent: Command): void;

package/dist/commands/decision.js

@@ -0,0 +1,113 @@
+import { readFile } from "node:fs/promises";
+import { uploadChatImageAsset } from "../avatar.js";
+import { createClient } from "../client.js";
+import { collectOption, readPromptContent } from "../command-input.js";
+import { error, handleHttp, json as outJson, jsonRequested, table } from "../output.js";
+import { resolveSpace } from "../space.js";
+const REMOTE_URL = /^https?:\/\//i;
+async function readJsonObject(source, label) {
+    const text = source.trim().startsWith("{")
+        ? source
+        : await readFile(source, "utf-8").catch(() => error(`Cannot read ${label}`, source));
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return error(`Invalid ${label}`, "Expected a JSON object or a path to a JSON file");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return error(`Invalid ${label}`, "Expected a JSON object");
+    }
+    return value;
+}
+export function mergeDecisionState(state, text, images) {
+    if (!text && images.length === 0)
+        return state;
+    if (state !== undefined && typeof state !== "string" && !Array.isArray(state)) {
+        throw new Error("Cannot combine a JSON object state with text or --image; use a text/image array in --input instead.");
+    }
+    const parts = [
+        ...(Array.isArray(state) ? state : typeof state === "string" ? [state] : []),
+        ...(text ? [text] : []),
+        ...images,
+    ];
+    return parts.length === 1 && typeof parts[0] === "string" ? parts[0] : parts;
+}
+function formatAnswer(answer) {
+    if (answer.type === "noul")
+        return (answer.noul ?? 0).toFixed(2);
+    if (answer.type === "choice")
+        return answer.choice ?? "";
+    const top = Object.entries(answer.probabilities ?? {}).sort(([, a], [, b]) => b - a)[0]?.[0];
+    const label = top === undefined ? undefined : answer.legend?.[top];
+    return `${(answer.score ?? 0).toFixed(2)}${label ? ` ${label}` : ""}`;
+}
+function printResult(result) {
+    table(Object.entries(result.answers).map(([key, answer]) => ({
+        question: key,
+        type: answer.type,
+        answer: formatAnswer(answer),
+        confidence: answer.confidence,
+    })), [
+        { key: "question", label: "QUESTION" },
+        { key: "type", label: "TYPE" },
+        { key: "answer", label: "ANSWER" },
+        { key: "confidence", label: "CONFIDENCE", format: (value) => (typeof value === "number" ? value.toFixed(2) : "") },
+    ]);
+    const cost = result.usage.cost?.total;
+    process.stderr.write(`\n  ${result.provider}/${result.model}${typeof cost === "number" ? `  cost: $${cost}` : ""}\n`);
+}
+async function runDecisionCommand(command, words, opts) {
+    const base = opts.input ? await readJsonObject(opts.input, "input") : {};
+    const questions = opts.questions ? await readJsonObject(opts.questions, "questions") : base.questions;
+    if (!questions)
+        return error("Questions required", "Pass --questions or --input");
+    const spaceId = await resolveSpace(command, { home: true });
+    const client = createClient();
+    try {
+        const images = opts.image ?? [];
+        const text = words.length > 0 || base.state === undefined
+            ? await readPromptContent(words, { allowEmpty: images.length > 0 })
+            : "";
+        const imageParts = images.map((url) => ({ type: "image_url", image_url: { url } }));
+        const state = mergeDecisionState(base.state, text, imageParts);
+        await Promise.all(imageParts.map(async (part) => {
+            if (!REMOTE_URL.test(part.image_url.url)) {
+                part.image_url.url = (await uploadChatImageAsset({ client, spaceId, path: part.image_url.url })).publicUrl;
+            }
+        }));
+        const input = {
+            ...base,
+            provider: opts.provider ?? base.provider,
+            model: opts.model ?? base.model,
+            state,
+            questions,
+        };
+        const result = await client.space(spaceId).decision(input);
+        if (jsonRequested(opts))
+            return outJson(result);
+        printResult(result);
+    }
+    catch (e) {
+        handleHttp(e);
+    }
+}
+export function registerDecisionCommand(parent) {
+    parent
+        .command("decision [state...]")
+        .description("Answer yes/no, choice and score questions about text or images")
+        .option("-q, --questions <json|path>", "Questions as inline JSON or a JSON file")
+        .option("--input <path>", "Full request JSON file (state, questions, model)")
+        .option("--image <path-or-url>", "Attach an image to the state", collectOption, [])
+        .option("-m, --model <model>", "Decision model ID")
+        .option("-p, --provider <provider>", "Provider name")
+        .option("--json", "Output as JSON")
+        .addHelpText("after", `
+Examples:
+  cohub decision "I was charged twice" -q '{"refund":{"type":"noul","instructions":"Refund?"}}'
+  cat ticket.txt | cohub decision -q questions.json --json
+  cohub decision "Duplicate charge?" --image receipt.png -q questions.json
+  cohub decision --input request.json`)
+        .action((words, opts) => runDecisionCommand(parent, words, opts));
+}

package/dist/commands/spaces.js

@@ -3,10 +3,12 @@ import { basename, dirname, relative, resolve, sep } from "node:path";
 import { readSentTurns, readSessionTurnOrigin, resolveCohubEnvironment } from "@neta-art/cohub";
 import { uploadAvatarAsset, uploadChatImageAsset } from "../avatar.js";
 import { createClient } from "../client.js";
+import { collectOption, readPromptContent } from "../command-input.js";
 import { table, json as outJson, jsonRequested, ok, error, handleHttp, formatEpochMs, truncateText } from "../output.js";
 import { SESSION_STATUS_COLUMN } from "../session-status.js";
 import { resolveSpace } from "../space.js";
 import { uploadLocalFiles } from "../space-files/upload.js";
+import { registerDecisionCommand } from "./decision.js";
 import { registerSpaceCommerce } from "./space-commerce.js";
 import { registerSpaceFileTransfer } from "./space-files.js";
 import { registerSpaceActivity } from "./space-activity.js";
@@ -33,9 +35,6 @@ function parseInteger(value, name, options = {}) {
         return error(`Invalid ${name}`, `${name} must be at most ${options.max}`);
     return parsed;
 }
-function collectOption(value, previous = []) {
-    return [...previous, value];
-}
 function parseEnvOptions(values) {
     if (!values?.length)
         return undefined;
@@ -181,18 +180,6 @@ async function confirmRestart(opts) {
     if (answer !== "y" && answer !== "yes")
         return error("Cancelled");
 }
-async function readPromptContent(words, options = {}) {
-    let content = words.join(" ");
-    if (!content && !process.stdin.isTTY) {
-        const chunks = [];
-        for await (const chunk of process.stdin)
-            chunks.push(chunk);
-        content = Buffer.concat(chunks).toString().trim();
-    }
-    if (!content && !options.allowEmpty)
-        return error("No content", "Pass as argument or pipe via stdin");
-    return content;
-}
 async function sendPrompt(command, words, opts) {
     const content = await readPromptContent(words, { allowEmpty: Boolean(opts.image?.length) });
     const scheduleFlags = [opts.delayMs, opts.at, opts.cron].filter((value) => value !== undefined);
@@ -379,6 +366,7 @@ export function registerPrompt(program) {
         .option("--thinking-level <level>", "Thinking level: off|minimal|low|medium|high|xhigh")
         .option("--json", "Output as JSON")
         .action((words, opts) => runCompletionCommand(program, words, opts));
+    registerDecisionCommand(program);
 }
 export function registerSpaceCreate(spacesCmd, dependencies = {}) {
     const getClient = dependencies.createClient ?? createClient;
@@ -699,6 +687,7 @@ export function registerSpaces(program) {
         .option("--thinking-level <level>", "Thinking level: off|minimal|low|medium|high|xhigh")
         .option("--json", "Output as JSON")
         .action((words, opts) => runCompletionCommand(spacesCmd, words, opts));
+    registerDecisionCommand(spacesCmd);
     // ── spaces files ──
     registerFiles(spacesCmd);
     registerSpaceDisplays(spacesCmd);

package/dist/index.js

@@ -54,6 +54,7 @@ Common commands:
   cohub spaces ls
   cohub prompt "Fix the failing tests"
   cohub completion "Summarize AGENTS.md" --system-prompt AGENTS.md --stream
+  cohub decision "I was charged twice" -q questions.json
   cohub run -- git status
   cohub runtime up ./my-project
   cohub runtime logs --follow
@@ -74,7 +75,7 @@ Common commands:
 Target space:
   -s <space>, then COHUB_SPACE_ID, then the current directory Runtime binding.
   <space> is an ID, a slug you own such as home, or username/slug.
-  prompt, completion, generate, apps, and public fall back to your Home Space;
+  prompt, completion, decision, generate, apps, and public fall back to your Home Space;
   other Space commands need a target.
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "10.1.0",
+  "version": "10.2.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "engines": {
@@ -18,8 +18,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/cohub": "11.1.0",
-    "@neta-art/generation": "^0.1.33",
+    "@neta-art/cohub": "11.2.0",
+    "@neta-art/generation": "^0.1.35",
     "commander": "^15.0.0",
     "sharp": "^0.35.4",
     "ws": "^8.21.3"