@neta-art/cohub-cli 8.4.0 → 9.0.0

package/dist/commands/desktop.d.ts

@@ -1,11 +1,7 @@
 import { resolveOpenSurface } from "@neta-art/cohub";
 import type { Command } from "commander";
 export { resolveOpenSurface };
-/**
- * Optional disambiguation for file:// vs app://. Unlike ordinary
- * Space-scoped commands, an unbound directory must not fall back to Home:
- * the plain target should remain eligible for App resolution.
- */
+/** Never falls back to Home, so a plain target stays eligible for App resolution. */
 export declare function resolveOptionalSpaceId(command: Command, options?: {
     cwd?: string;
     bindingsPath?: string;

package/dist/commands/desktop.js

@@ -1,29 +1,18 @@
 import { readFileSync } from "node:fs";
-import { HttpError, parseAppRef, resolveOpenSurface, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_COMMAND_MAX_TIMEOUT_MS, } from "@neta-art/cohub";
+import { HttpError, parseAppRef, resolveOpenSurface, DESKTOP_COMMAND_ACCEPT_TIMEOUT_MS, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_COMMAND_MAX_TIMEOUT_MS, DESKTOP_COMMAND_OPEN_TIMEOUT_MS, } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok } from "../output.js";
-import { resolveBoundSpace } from "../space.js";
+import { explicitSpace, failSpaceTarget, resolveBoundSpace, resolveSpaceRef } from "../space.js";
 import { getAppByRef } from "../app-ref.js";
 export { resolveOpenSurface };
 const FILE_SCHEME = "file://";
 const APP_SCHEME = "app://";
 const LEGACY_WORK_SCHEME = "work://";
-/**
- * Optional disambiguation for file:// vs app://. Unlike ordinary
- * Space-scoped commands, an unbound directory must not fall back to Home:
- * the plain target should remain eligible for App resolution.
- */
+/** Never falls back to Home, so a plain target stays eligible for App resolution. */
 export async function resolveOptionalSpaceId(command, options = {}) {
-    let current = command;
-    while (current) {
-        const opts = current.opts();
-        if (typeof opts.space === "string" && opts.space.trim())
-            return opts.space.trim();
-        current = current.parent ?? null;
-    }
-    const fromEnvironment = process.env.COHUB_SPACE_ID?.trim();
-    if (fromEnvironment)
-        return fromEnvironment;
+    const explicit = explicitSpace(command);
+    if (explicit)
+        return resolveSpaceRef(explicit).catch(failSpaceTarget);
     return (await resolveBoundSpace(options)) ?? undefined;
 }
 function parseFilePath(value) {
@@ -66,7 +55,7 @@ function readCallInput(opts) {
 }
 function parseTimeout(value) {
     if (!value)
-        return DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS;
+        return undefined;
     const parsed = Math.floor(Number(value));
     if (!Number.isFinite(parsed) || parsed <= 0 || parsed > DESKTOP_COMMAND_MAX_TIMEOUT_MS) {
         return error("Invalid timeout", `--timeout-ms must be between 1 and ${DESKTOP_COMMAND_MAX_TIMEOUT_MS} milliseconds.`);
@@ -200,6 +189,8 @@ Notes:
     scheme is still accepted.
   - A plain target checks the explicit Space or current directory Runtime binding for a file before resolving an app; it does not fall back to Home.
   - Opening a window is idempotent; repeating it re-activates the same tab.
+  - A desktop that does not respond within ${DESKTOP_COMMAND_ACCEPT_TIMEOUT_MS / 1_000} seconds (closed, asleep, or
+    offline) fails fast with no_active_client instead of waiting out the timeout.
   - --as picks the surface: window (a preview tab) or overlay (a transparent
     layer above the workspace). Without it, an App published with
     <meta name="cohub:surface" content="overlay"> opens as an overlay.
@@ -217,7 +208,7 @@ function registerOpen(parent, deprecated) {
         .option("--command-id <id>", "Stable id so retries never dispatch twice")
         .option("--no-wait", "Dispatch the command and exit without waiting for a result")
         .option("--as <surface>", "Surface role for app targets: window (default) or overlay")
-        .option("--timeout-ms <ms>", `How long to wait for the desktop (default: ${DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS}; max: ${DESKTOP_COMMAND_MAX_TIMEOUT_MS})`)
+        .option("--timeout-ms <ms>", `How long to wait for the desktop (default: ${DESKTOP_COMMAND_OPEN_TIMEOUT_MS}, or ${DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS} with --call; max: ${DESKTOP_COMMAND_MAX_TIMEOUT_MS})`)
         .option("--json", "Output as JSON")
         .action(async (target, opts, thisCommand) => {
         if (deprecated) {

package/dist/commands/generations.js

@@ -300,7 +300,7 @@ Examples:
 `)
         .action(async (prompt, opts) => {
         try {
-            const spaceId = await resolveSpace(program);
+            const spaceId = await resolveSpace(program, { home: true });
             const sessionId = envValue("COHUB_SESSION_ID");
             const inputs = await Promise.all([
                 ...opts.image.map((value) => parseMediaInput("image", value)),

package/dist/commands/me.js

@@ -71,7 +71,7 @@ export function registerMe(program) {
             if (jsonRequested(opts))
                 return outJson(activity);
             console.log(`\n  ${formatLocalDateTime(activity.range.from)} → ${formatLocalDateTime(activity.range.to)}`);
-            table([activity.summary], [
+            table([activity.totals], [
                 { key: "totalTokens", label: "Tokens" },
                 { key: "costTotal", label: "Cost ($)" },
                 { key: "requestCount", label: "Requests" },

package/dist/commands/public.js

@@ -182,7 +182,7 @@ function publicUrlPrefix(destination, entry) {
 }
 async function uploadPublic(command, source, destination, opts, deps) {
     const client = deps.createClient?.() ?? createClient();
-    const spaceId = await resolveSpace(command);
+    const spaceId = await resolveSpace(command, { home: true });
     try {
         const upload = await collectPublicUpload(source, destination);
         const plan = await client.space(spaceId).publicFiles.createUpload({
@@ -247,7 +247,7 @@ async function uploadPublic(command, source, destination, opts, deps) {
 async function listPublic(command, path, opts, deps) {
     const client = deps.createClient?.() ?? createClient();
     try {
-        const publicFiles = client.space(await resolveSpace(command)).publicFiles;
+        const publicFiles = client.space(await resolveSpace(command, { home: true })).publicFiles;
         const entries = [];
         let cursor;
         do {
@@ -274,7 +274,7 @@ async function listPublic(command, path, opts, deps) {
 async function printPublicUrl(command, path, deps) {
     const client = deps.createClient?.() ?? createClient();
     try {
-        const result = await client.space(await resolveSpace(command)).publicFiles.url(path);
+        const result = await client.space(await resolveSpace(command, { home: true })).publicFiles.url(path);
         console.log(result.url);
     }
     catch (exception) {

package/dist/commands/references.js

@@ -14,6 +14,7 @@ const REFERENCE_KINDS = new Set([
     "mod",
     "mention",
     "tool_call",
+    "turn_trigger",
     "agent_tool_file_read",
     "agent_tool_file_write",
     "agent_tool_file_edit",
@@ -53,6 +54,7 @@ function clampNumber(value, fallback, min, max) {
 const KINDS_HELP = `Kinds:
   structural:  session_fork, space_fork, checkpoint_fork, mod
   content:     mention, tool_call
+  causality:   turn_trigger
   file access: agent_tool_file_read, agent_tool_file_write, agent_tool_file_edit,
                agent_tool_file_ls, agent_tool_file_find, agent_tool_file_grep`;
 export function registerReferences(program) {
@@ -75,6 +77,7 @@ ${KINDS_HELP}
 
 Examples:
   cohub references query turn:<uuid> --kinds agent_tool_file_read,agent_tool_file_write
+  cohub references query turn:<uuid> --direction out --kinds turn_trigger
   cohub references query session:<uuid> --json
   cohub references query checkpoint:<uuid> --direction out
   cohub references query space:<uuid> --direction in --kinds mention,tool_call

package/dist/commands/referrals.js

@@ -1,8 +1,8 @@
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+import { webUrl } from "../web.js";
 function referralUrl(code) {
-    const origin = process.env.COHUB_WEB_URL?.replace(/\/+$/, "") ?? "https://cohub.live";
-    return `${origin}/referrals/${code}`;
+    return webUrl(`/referrals/${code}`);
 }
 async function confirmRotate(opts) {
     if (opts.yes)

package/dist/commands/run.js

@@ -110,8 +110,8 @@ export async function parseRunCliOptions(argv, spaceOptions = {}) {
 export function printRunHelp() {
     process.stdout.write(`
 Usage:
-  cohub [-s <spaceId>] run [options] -- <shell command>
-  cohub [-s <spaceId>] run --command <shell command>
+  cohub [-s <space>] run [options] -- <shell command>
+  cohub [-s <space>] run --command <shell command>
 
 Options:
   -c, --command <command>  Shell command to execute in the space workspace
@@ -125,7 +125,7 @@ Examples:
   cohub -s <spaceId> run -- git status -sb
 
 Notes:
-  - Without -s or COHUB_SPACE_ID, the command uses the current directory Runtime binding, then Home.
+  - Without -s or COHUB_SPACE_ID, the command uses the current directory Runtime binding; it never falls back to Home.
   - Use --command for commands that contain leading flags, or use -- before the shell command.
   - The command runs in /workspace.
 `);

package/dist/commands/runtime.d.ts

@@ -1,3 +1,3 @@
 import type { Command } from "commander";
-export { resolveLocalSpaceName, parseRuntimeHarnesses } from "../runtime/launch.js";
+export { resolveLocalSpaceName, parseRuntimeDisplay, parseRuntimeHarnesses } from "../runtime/launch.js";
 export declare function registerRuntime(program: Command): void;

package/dist/commands/runtime.js

@@ -12,7 +12,7 @@ import { installPiExtension, piExtensionState } from "../runtime/native/install.
 import { controlRuntimeInstance, requestRuntimeInstance, runtimeInstanceDirectory } from "../runtime/instance.js";
 import { atLeastLevel, diagnosticLevels, formatDiagnostic, formatImportProgress, formatNativeSync, printRuntimeSummary } from "../runtime/presentation.js";
 import { readRuntimeDiagnosticEvents, RuntimeDiagnosticReader, runtimeDiagnosticsDirectory, serializeDiagnosticError } from "../runtime/diagnostics.js";
-export { resolveLocalSpaceName, parseRuntimeHarnesses } from "../runtime/launch.js";
+export { resolveLocalSpaceName, parseRuntimeDisplay, parseRuntimeHarnesses } from "../runtime/launch.js";
 const reportFailure = (cause) => {
     process.stderr.write(`Runtime failed: ${serializeDiagnosticError(cause).message}\n`);
     process.exitCode = 1;
@@ -34,13 +34,14 @@ export function registerRuntime(program) {
     const runtime = program.command("runtime").description("Connect a local workspace");
     runtime.command("up [dir]")
         .description("Connect local Harnesses and files")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("-n, --new", "Create a new Space")
         .option("--name <name>", "New Space name")
         .option("-d, --detach", "Run in the background")
         .option("--harness <name>", "Pi or Codex; repeatable", (value, previous) => [...previous, value], [])
         .option("--pi <path>", "Pi executable")
         .option("--codex <path>", "Codex executable")
+        .option("--display [screen]", "Share a screen: auto (this computer), or xvfb[:WIDTHxHEIGHT] for a virtual one")
         .option("-y, --yes", "Accept defaults and authorize local execution and native sync")
         .option("--verbose", "Show diagnostic details")
         .option("--json", "JSON output")
@@ -54,7 +55,7 @@ export function registerRuntime(program) {
     });
     runtime.command("attach")
         .description("Connect native harnesses to Cohub: install the Pi extension")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("--harness <name>", "Pi; repeatable", (value, previous) => [...previous, value], [])
         .option("--json", "JSON output")
         .action(async (options) => {
@@ -81,7 +82,7 @@ export function registerRuntime(program) {
     });
     runtime.command("detach")
         .description("Pause native sync; keep all data")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("--harness <name>", "Pi or Codex; repeatable", (value, previous) => [...previous, value], [])
         .option("--json", "JSON output")
         .action(async (options) => {
@@ -110,7 +111,7 @@ export function registerRuntime(program) {
     });
     runtime.command("import [dir]")
         .description("Import earlier local conversations, newest first")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("--harness <name>", "Filter by harness; repeatable", (value, previous) => [...previous, value], [])
         .option("--session <id>", "Filter by native session ID")
         .option("--concurrency <count>", `Conversations read in parallel, 1 to ${MAX_IMPORT_CONCURRENCY}`, String(DEFAULT_IMPORT_CONCURRENCY))
@@ -207,7 +208,7 @@ export function registerRuntime(program) {
         }
     });
     runtime.command("status").description("Local and server status")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("--json", "JSON output")
         .action(async (options) => {
         try {
@@ -232,6 +233,9 @@ export function registerRuntime(program) {
                 else
                     process.stdout.write(`Local process  Not running\nSpace  ${spaceId}\nLogs  ${result.diagnosticsPath}\n`);
                 process.stdout.write(`Server  ${remote.error ? `Unknown — ${remote.error}` : remote.value?.online ? "Harness connected" : "Offline"}\nArchives  ${pendingLocalArchives} pending · ${failedLocalArchives} failed\n`);
+                const displays = remote.value?.displays ?? [];
+                if (displays.length)
+                    process.stdout.write(`Displays  ${displays.map((display) => `${display.name || display.id} ${display.width}x${display.height}${display.needs?.length ? ` (needs ${display.needs.join(", ")})` : display.input ? "" : " (view only)"}`).join(" · ")}\n`);
                 process.stdout.write(formatNativeSync(nativeSync.config, local?.native, nativeSync.error));
             }
         }
@@ -240,7 +244,7 @@ export function registerRuntime(program) {
         }
     });
     runtime.command("down").description("Stop this local Runtime; retain all data")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("-y, --yes", "Stop even with unconfirmed executions")
         .option("--json", "JSON output")
         .action(async (options) => {
@@ -278,7 +282,7 @@ export function registerRuntime(program) {
         }
     });
     runtime.command("logs").description("Read local Runtime diagnostics")
-        .option("-s, --space <id>", "Target Space")
+        .option("-s, --space <space>", "Target Space: ID, slug, or username/slug")
         .option("-l, --limit <count>", "Number of events", "100")
         .option("--level <level>", "Minimum level: debug, info, warn, error", "info")
         .option("-f, --follow", "Keep watching")

package/dist/commands/search.js

@@ -4,7 +4,8 @@ import { formatLocalDateTime, table, json as outJson, jsonRequested, error, hand
 const DEFAULT_LIMIT = 20;
 const MAX_TITLE_LENGTH = 72;
 const MAX_CONTEXT_LENGTH = 42;
-const SEARCH_TYPES = new Set(["turn", "session", "space", "label"]);
+const MAX_MATCH_LENGTH = 60;
+const SEARCH_TYPES = new Set(["chat", "space", "label"]);
 function clampLimit(value) {
     const parsed = Number(value ?? DEFAULT_LIMIT);
     if (!Number.isFinite(parsed))
@@ -17,7 +18,14 @@ function contextFor(item) {
         return `@${owner.username}`;
     if (owner?.displayName)
         return owner.displayName;
-    return item.href;
+    if (item.type === "label")
+        return item.labelRef ?? "";
+    return item.spaceName ?? "";
+}
+function matchFor(item) {
+    if (item.hit)
+        return item.hit.excerpt;
+    return item.matchedField;
 }
 function parseTypes(value) {
     const types = value
@@ -41,9 +49,9 @@ function parseSearchInput(opts) {
 function rowsFor(items) {
     return items.map((item) => ({
         type: item.type,
-        title: truncateText(item.title, MAX_TITLE_LENGTH),
+        title: truncateText(item.title || "New chat", MAX_TITLE_LENGTH),
         context: truncateText(contextFor(item), MAX_CONTEXT_LENGTH),
-        match: item.matchedField,
+        match: truncateText(matchFor(item), MAX_MATCH_LENGTH),
         updated: item.updatedAt ? formatLocalDateTime(item.updatedAt).slice(0, 10) : "",
         href: item.href,
     }));
@@ -51,10 +59,10 @@ function rowsFor(items) {
 export function registerSearch(program) {
     program
         .command("search")
-        .description("Search spaces, chats, turns, and label items")
+        .description("Search spaces, chats, and label items")
         .argument("[query]", "Search query")
         .option("--limit <n>", "Maximum results, 1-50", String(DEFAULT_LIMIT))
-        .option("--types <types>", "Comma-separated result types: turn,session,space,label")
+        .option("--types <types>", "Comma-separated result types: chat,space,label")
         .option("--space-id <id>", "Limit search to a space")
         .option("--label-ref <ref>", "Search items under an exact label ref")
         .option("--json", "Output as JSON")
@@ -63,7 +71,7 @@ export function registerSearch(program) {
 Examples:
   cohub search "release notes"
   cohub search "failing tests" --limit 10
-  cohub search "bug" --types turn,session --space-id <spaceId>
+  cohub search "bug" --types chat --space-id <spaceId>
   cohub search --types label --label-ref bug
   cohub search "login" --types label --label-ref bug
   cohub search "design review" --json

package/dist/commands/space-activity.js

@@ -63,13 +63,11 @@ export function toAppRankingRows(apps) {
         id: app.appId,
     }));
 }
-function hasCost(activity) {
-    return activity.summary.costTotal !== 0;
-}
 export function printActivityReport(activity) {
-    const showCost = hasCost(activity);
+    const { totals } = activity;
+    const showCost = totals.costTotal !== 0;
     console.log(`\n  Summary (last ${activity.days} days):`);
-    table([activity.summary], [
+    table([totals], [
         { key: "totalTokens", label: "Tokens", format: formatNumber },
         { key: "requestCount", label: "Requests", format: formatNumber },
         ...(showCost ? [{ key: "costTotal", label: "Cost", format: formatCost }] : []),

package/dist/commands/space-displays.d.ts

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