@neta-art/cohub-cli 3.10.2 → 3.11.0

package/README.md

@@ -329,17 +329,21 @@ through `client.work.realtime` in the SDK rather than as CLI commands.
 
 ## Drive the Cohub UI
 
-Show a Work preview in the Cohub tab that started the current work, and call
+Show a file or Work preview in the Cohub tab that started the current work, and call
 methods the Work exposes.
 
 ```bash
-cohub ui preview <workId|url|cohub://works/...|username/space/work>
-cohub ui preview <work> --call selection.get
+cohub ui preview <workId|url|cohub://works/...|username/space/work|file://path>
+cohub ui preview file://src/main.ts
+cohub ui preview work://alice/studio/launch
+cohub ui preview <work-or-file> --call selection.get
 cohub ui preview <work> --call board.focus --data '{"nodeId":"n1"}'
 cohub ui preview <work> --call report.build --input payload.json --json
 ```
 
-`ui preview` accepts the same Work references as `works get`. Showing a preview is
+`ui preview` accepts `file://` Space-relative paths, `work://` Work references, and
+legacy bare targets. A bare target checks the current Space for a file first, then
+falls back to the same Work references as `works get`. Showing a preview is
 idempotent: repeating it re-activates the same tab and refreshes any launch state
 carried by the reference. With `--call`, the command waits for the Work to announce readiness, invokes the method,
 and waits for the Work to complete the same UI command with `client.ui.reportResult()`.

package/dist/commands/ui.js

@@ -1,8 +1,38 @@
 import { readFileSync } from "node:fs";
+import { HttpError, } from "@neta-art/cohub";
 import { parseWorkRef, UI_COMMAND_DEFAULT_TIMEOUT_MS, UI_COMMAND_MAX_TIMEOUT_MS, } from "@neta-art/cohub";
 import { createClient } from "../client.js";
 import { error, handleHttp, json as outJson, jsonRequested, ok } from "../output.js";
 import { getWorkByRef } from "../work-ref.js";
+const FILE_SCHEME = "file://";
+const WORK_SCHEME = "work://";
+function optionalSpaceId(command) {
+    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;
+    }
+    return process.env.COHUB_SPACE_ID?.trim() || undefined;
+}
+function parseFilePath(value) {
+    const path = value.slice(FILE_SCHEME.length).trim();
+    if (!path ||
+        path.startsWith("/") ||
+        path.includes("\0") ||
+        path.split("/").some((segment) => segment === "..") ||
+        path.includes("\\")) {
+        return error("Invalid file path", "Use a relative Space path after file://.");
+    }
+    return path;
+}
+function hasFileScheme(value) {
+    return value.toLowerCase().startsWith(FILE_SCHEME);
+}
+function hasWorkScheme(value) {
+    return value.toLowerCase().startsWith(WORK_SCHEME);
+}
 function readCallInput(opts) {
     if (opts.data !== undefined && opts.input !== undefined) {
         return error("Conflicting input", "Use either --data or --input, not both.");
@@ -33,9 +63,11 @@ function parseTimeout(value) {
     return parsed;
 }
 async function resolveWorkTarget(client, ref) {
-    const parsed = parseWorkRef(ref);
-    const detail = await getWorkByRef(client, ref);
+    const normalized = hasWorkScheme(ref) ? ref.slice(WORK_SCHEME.length) : ref;
+    const parsed = parseWorkRef(normalized);
+    const detail = await getWorkByRef(client, normalized);
     return {
+        kind: "work",
         workId: detail.work.id,
         label: detail.work.slug,
         launch: {
@@ -44,6 +76,24 @@ async function resolveWorkTarget(client, ref) {
         },
     };
 }
+async function resolvePreviewTarget(client, command, value) {
+    if (hasFileScheme(value))
+        return { kind: "file", path: parseFilePath(value) };
+    if (hasWorkScheme(value))
+        return resolveWorkTarget(client, value);
+    const spaceId = optionalSpaceId(command);
+    if (spaceId) {
+        try {
+            await client.space(spaceId).files.read(value);
+            return { kind: "file", path: value };
+        }
+        catch (cause) {
+            if (!(cause instanceof HttpError) || cause.status !== 404)
+                throw cause;
+        }
+    }
+    return resolveWorkTarget(client, value);
+}
 function reportDispatch(record) {
     if (record.status !== "pending") {
         reportOutcome(record, Boolean(record.command.request));
@@ -53,7 +103,7 @@ function reportDispatch(record) {
 }
 function reportOutcome(record, called) {
     if (record.status === "applied") {
-        ok(called ? "Work preview shown and method called" : "Work preview shown");
+        ok(called ? "Work preview shown and method called" : "Preview shown");
         if (record.result !== undefined) {
             console.log(typeof record.result === "string" ? record.result : JSON.stringify(record.result, null, 2));
         }
@@ -70,15 +120,17 @@ Commands reach only the frontend instance that originated the current chat,
 resolved from request provenance. Nothing else can be targeted.
 
 Examples:
-  cohub ui preview <work-id>
+  cohub ui preview <work-or-file>
+  cohub ui preview file://src/main.ts
+  cohub ui preview work://alice/studio/launch
   cohub ui preview alice/studio/launch
   cohub ui preview https://cohub.live/alice/studio/w/launch?view=timeline
   cohub ui preview <work-id> --call selection.get
   cohub ui preview <work-id> --call board.focus --data '{"nodeId":"n1"}'
 `);
     const preview = ui
-        .command("preview <work>")
-        .description("Show a Work preview tab, optionally calling a method it exposes")
+        .command("preview <work-or-file>")
+        .description("Show a file or Work preview tab, optionally calling a Work method")
         .option("--call <method>", "Method the Work registered via client.work.surface.handle()")
         .option("--data <json>", "Inline JSON input for --call")
         .option("-i, --input <file>", "JSON input file for --call; use - for stdin")
@@ -98,19 +150,24 @@ Examples:
         const timeoutMs = parseTimeout(opts.timeoutMs);
         const client = createClient();
         try {
-            const target = await resolveWorkTarget(client, work);
+            const target = await resolvePreviewTarget(client, preview, work);
+            if (target.kind === "file" && opts.call) {
+                return error("Unsupported option", "--call only applies to Work previews.");
+            }
             const request = opts.call
                 ? { method: opts.call, ...(callInput === undefined ? {} : { input: callInput }) }
                 : undefined;
             const input = {
                 command: {
                     type: "preview.show",
-                    preview: {
-                        kind: "work",
-                        workId: target.workId,
-                        label: target.label,
-                        ...(target.launch.search || target.launch.hash ? { launch: target.launch } : {}),
-                    },
+                    preview: target.kind === "file"
+                        ? target
+                        : {
+                            kind: "work",
+                            workId: target.workId,
+                            label: target.label,
+                            ...(target.launch.search || target.launch.hash ? { launch: target.launch } : {}),
+                        },
                     ...(request ? { request } : {}),
                 },
                 ...(opts.client ? { targetClientId: opts.client } : {}),
@@ -133,6 +190,8 @@ Examples:
     });
     preview.addHelpText("after", `
 Notes:
+  - Use file:// and work:// to make the target explicit.
+  - A plain target checks the current Space for a file before resolving a Work.
   - Showing a preview is idempotent; repeating it re-activates the same tab.
   - --call waits for the Work to announce readiness, then invokes the method.
   - Which methods exist is up to the Work author.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "3.10.2",
+  "version": "3.11.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,7 +19,7 @@
     "commander": "^15.0.0",
     "pixi.js": "^8.19.0",
     "sharp": "^0.35.3",
-    "@neta-art/cohub": "5.8.2"
+    "@neta-art/cohub": "5.9.0"
   },
   "publishConfig": {
     "access": "public"