@neta-art/cohub-cli 6.9.0 → 6.10.0

package/dist/commands/desktop.d.ts

@@ -1,10 +1,5 @@
-import { type DesktopSurface } from "@neta-art/cohub";
+import { resolveOpenSurface } from "@neta-art/cohub";
 import type { Command } from "commander";
-/**
- * The surface a desktop.open should request: an explicit `--as` wins, then
- * whatever the App declared at publish time. `window` is the implicit default
- * and yields `undefined` so the command stays compact.
- */
-export declare function resolveOpenSurface(requested: string | undefined, declared: unknown): DesktopSurface | undefined;
+export { resolveOpenSurface };
 export declare function registerDesktop(program: Command): void;
 export declare function registerLegacyUi(program: Command): void;

package/dist/commands/desktop.js

@@ -1,9 +1,9 @@
 import { readFileSync } from "node:fs";
-import { HttpError, } from "@neta-art/cohub";
-import { parseAppRef, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_COMMAND_MAX_TIMEOUT_MS, } from "@neta-art/cohub";
+import { HttpError, parseAppRef, resolveOpenSurface, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_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 { getAppByRef } from "../app-ref.js";
+export { resolveOpenSurface };
 const FILE_SCHEME = "file://";
 const APP_SCHEME = "app://";
 const LEGACY_WORK_SCHEME = "work://";
@@ -65,14 +65,6 @@ function parseTimeout(value) {
     }
     return parsed;
 }
-/**
- * The surface a desktop.open should request: an explicit `--as` wins, then
- * whatever the App declared at publish time. `window` is the implicit default
- * and yields `undefined` so the command stays compact.
- */
-export function resolveOpenSurface(requested, declared) {
-    return (requested ?? declared) === "overlay" ? "overlay" : undefined;
-}
 async function resolveAppTarget(client, ref) {
     const normalized = hasAppScheme(ref) ? ref.replace(/^[a-zA-Z]+:\/\//, "") : ref;
     const parsed = parseAppRef(normalized);

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

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+import { createClient } from "../client.js";
+export declare function parseBody(raw: string | undefined): unknown;
+/** `cohub spaces webhooks` — inbound HTTP triggers declared by `.cohub/hooks/<name>` with `on.event: webhook`. */
+export declare function registerSpaceWebhooks(spacesCmd: Command, deps?: {
+    createClient?: typeof createClient;
+}): void;

package/dist/commands/space-webhooks.js

@@ -0,0 +1,73 @@
+import { joinApiUrl, resolveApiBaseUrl } from "@neta-art/cohub";
+import { createClient } from "../client.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+import { resolveSpace } from "../space.js";
+export function parseBody(raw) {
+    if (raw === undefined)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return error("Invalid body", "--body must be JSON");
+    }
+}
+/** `cohub spaces webhooks` — inbound HTTP triggers declared by `.cohub/hooks/<name>` with `on.event: webhook`. */
+export function registerSpaceWebhooks(spacesCmd, deps = {}) {
+    const client = () => (deps.createClient ?? createClient)();
+    const webhooksCmd = spacesCmd
+        .command("webhooks")
+        .description("Inbound webhooks declared by .cohub/hooks/<name> (on.event: webhook)");
+    webhooksCmd
+        .command("ls")
+        .alias("list")
+        .description("List declared webhooks")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const spaceId = await resolveSpace(spacesCmd);
+        try {
+            const result = await client().space(spaceId).webhooks.list();
+            if (jsonRequested(opts))
+                return outJson(result.items);
+            table(result.items, [
+                { key: "name", label: "Name" },
+                { key: "action", label: "Action" },
+                { key: "hasSecret", label: "Secret" },
+            ]);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    webhooksCmd
+        .command("url <name>")
+        .description("Print the URL external services should POST to")
+        .option("--json", "Output as JSON")
+        .action(async (name, opts) => {
+        const spaceId = await resolveSpace(spacesCmd);
+        const sdk = client();
+        const url = joinApiUrl(resolveApiBaseUrl({}), sdk.space(spaceId).webhooks.path(name));
+        if (jsonRequested(opts))
+            return outJson({ name, url });
+        process.stdout.write(`${url}\n`);
+    });
+    webhooksCmd
+        .command("trigger <name>")
+        .description("POST a JSON body to a webhook hook (local testing)")
+        .option("--body <json>", "JSON body", "null")
+        .option("--secret <secret>", "Value for on.secret")
+        .option("--json", "Output as JSON")
+        .action(async (name, opts) => {
+        const spaceId = await resolveSpace(spacesCmd);
+        const body = parseBody(opts.body);
+        try {
+            const result = await client().space(spaceId).webhooks.trigger(name, body, { secret: opts.secret });
+            if (jsonRequested(opts))
+                return outJson(result);
+            ok(`Triggered ${result.hook} — task ${result.taskRunId}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}

package/dist/commands/spaces.js

@@ -11,6 +11,7 @@ import { registerSpaceCommerce } from "./space-commerce.js";
 import { registerSpaceActivity } from "./space-activity.js";
 import { registerSpaceInvitations } from "./space-invitations.js";
 import { registerSpaceTurns } from "./space-turns.js";
+import { registerSpaceWebhooks } from "./space-webhooks.js";
 const cliEnv = resolveCohubEnvironment();
 const defaultIdleTtlSeconds = cliEnv === "prod" ? 12 * 60 * 60 : 10 * 60;
 const SPACE_ROLES = ["host", "builder", "guest"];
@@ -659,6 +660,8 @@ export function registerSpaces(program) {
     registerMods(spacesCmd);
     // ── spaces labels ──
     registerLabels(spacesCmd);
+    // ── spaces webhooks ──
+    registerSpaceWebhooks(spacesCmd);
     // ── spaces pin / unpin (user-scope label convenience) ──
     spacesCmd
         .command("pin <id>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -15,11 +15,11 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/generation": "^0.1.25",
+    "@neta-art/generation": "^0.1.26",
     "commander": "^15.0.0",
     "pixi.js": "^8.20.1",
     "sharp": "^0.35.4",
-    "@neta-art/cohub": "8.12.0"
+    "@neta-art/cohub": "8.13.0"
   },
   "publishConfig": {
     "access": "public"