@neta-art/cohub-cli 9.1.2 → 10.1.0

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import { readFileSync } from "node:fs";
+import { registerEndpointOptions } from "./endpoint-options.js";
 import { registerAuth } from "./commands/auth.js";
 import { registerBoards } from "./commands/boards.js";
 import { registerChannels } from "./commands/channels.js";
@@ -21,6 +22,7 @@ import { registerRuntime } from "./commands/runtime.js";
 import { registerTasks } from "./commands/tasks.js";
 import { registerDesktop, registerLegacyUi } from "./commands/desktop.js";
 import { registerApps } from "./commands/apps.js";
+import { registerRooms } from "./commands/rooms.js";
 import { formatUnknownCommandError, resolveHelpPath } from "./help-path.js";
 const VERSION = (() => {
     try {
@@ -31,7 +33,7 @@ const VERSION = (() => {
         return "1.0.0";
     }
 })();
-const program = new Command("cohub");
+const program = registerEndpointOptions(new Command("cohub"));
 program
     .name("cohub")
     .summary("Work with Cohub from your terminal")
@@ -63,6 +65,7 @@ Common commands:
   cohub -s <space-id> public upload ./dist demo
   cohub -s <space-id> apps publish demo --file dist/index.html
   cohub desktop open <app-id> --call selection.get
+  cohub rooms join <invite>
   cohub -s <space-id> spaces commerce products list
   cohub models ls
   cohub models ls --model-type multimodal
@@ -77,6 +80,9 @@ Target space:
 Environment:
   COHUB_SPACE_ID         Target Space when -s is omitted
   COHUB_EXECUTION_TOKEN  Use this token instead of the stored Logto session
+  COHUB_BASE_URL         Override the API base URL
+  COHUB_WS_URL           Override the realtime WebSocket URL
+  COHUB_WEB_URL          Override the web URL used in links
   ENV=dev                Use the development Cohub environment
   HTTPS_PROXY            Honored for API and uploads (also HTTP_PROXY, NO_PROXY)
   Runtime logs            ~/.local/state/cohub/runtime/<space-id>/diagnostics
@@ -100,6 +106,7 @@ registerReferrals(program);
 registerTasks(program);
 registerCronJobs(program);
 registerApps(program);
+registerRooms(program);
 registerDesktop(program);
 registerLegacyUi(program);
 const argv = process.argv.slice(2);

package/dist/runtime/model-catalog.d.ts

@@ -9,6 +9,6 @@ type Model = RuntimeCapabilities["models"][number];
  * to the picker's rule, and Cohub always sends the chosen level explicitly.
  */
 export declare function piModelCatalog(entries: unknown[], state: JsonRecord): Model[];
-/** Codex's built-in catalog is not authoritative for an arbitrary custom provider. */
+/** Use Codex's picker-visible model/list for every provider, including custom providers. */
 export declare function codexModelCatalog(configResponse: JsonRecord, entries: unknown[]): Model[];
 export {};

package/dist/runtime/model-catalog.js

@@ -45,14 +45,12 @@ function codexThinking(model, configuredEffort) {
         ...(defaultThinkingLevel ? { defaultThinkingLevel } : {}),
     };
 }
-/** Codex's built-in catalog is not authoritative for an arbitrary custom provider. */
+/** Use Codex's picker-visible model/list for every provider, including custom providers. */
 export function codexModelCatalog(configResponse, entries) {
     const config = record(configResponse.config);
     const provider = typeof config.model_provider === "string" ? config.model_provider : "openai";
     const configuredModel = typeof config.model === "string" ? config.model : null;
-    const customCatalog = typeof config.model_catalog_json === "string";
-    const catalog = provider !== "openai" && !customCatalog ? [] : entries;
-    const models = catalog.flatMap((value) => {
+    const models = entries.flatMap((value) => {
         const model = record(value);
         const id = typeof model.model === "string" ? model.model : typeof model.id === "string" ? model.id : null;
         if (!id || model.hidden)

package/dist/runtime/supervisor.js

@@ -102,10 +102,10 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
             config.capabilities ?? discoverHarnesses(config.harnesses, config.executables, config.root),
         ]);
         signal.throwIfAborted();
-        const url = new URL(resolveWebsocketUrl({ url: process.env.COHUB_WS_URL }));
-        url.pathname = "/runtime/relay";
+        const url = new URL(resolveWebsocketUrl());
+        url.pathname = url.pathname.replace(/\/ws$/, "/runtime/relay");
         const relay = new URL(url);
-        relay.pathname = "/sandbox/relay";
+        relay.pathname = relay.pathname.replace(/\/runtime\/relay$/, "/sandbox/relay");
         const runBridge = async () => {
             let attempts = 0;
             while (!signal.aborted) {

package/dist/safe-remote-image.d.ts

@@ -25,4 +25,8 @@ export declare function downloadPublicImage(input: string, options?: RemoteImage
     bytes: Uint8Array;
     mimeType: string;
 }>;
+export declare function downloadPublicAudio(input: string, options?: RemoteImageDownloadOptions): Promise<{
+    bytes: Uint8Array;
+    mimeType: string;
+}>;
 export {};

package/dist/safe-remote-image.js

@@ -13,6 +13,11 @@ const IMAGE_MIME_TYPES = new Set([
     "image/png",
     "image/webp",
 ]);
+const AUDIO_MIME_TYPES = new Set([
+    "audio/mpeg", "audio/mp3", "audio/mp4", "audio/aac", "audio/ogg",
+    "audio/wav", "audio/x-wav", "audio/wave", "audio/flac", "audio/x-flac",
+    "audio/webm", "audio/opus", "application/ogg",
+]);
 const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308]);
 async function defaultLookup(hostname) {
     const records = await dns.lookup(hostname, { all: true, verbatim: true });
@@ -48,7 +53,7 @@ function requestPinned(url, addresses, timeoutMs, maxBytes) {
         const client = url.protocol === "https:" ? https : http;
         const request = client.request(url, {
             agent: false,
-            headers: { Accept: "image/avif,image/webp,image/png,image/jpeg,image/gif" },
+            headers: { Accept: "image/*,audio/*,application/ogg" },
             lookup: pinnedLookup(addresses),
         }, (response) => {
             const status = response.statusCode ?? 0;
@@ -61,7 +66,7 @@ function requestPinned(url, addresses, timeoutMs, maxBytes) {
             const declaredLength = Number(headers.get("content-length") ?? 0);
             if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {
                 response.destroy();
-                reject(new Error(`Image exceeds the ${maxBytes} byte download limit`));
+                reject(new Error(`Media exceeds the ${maxBytes} byte download limit`));
                 return;
             }
             const chunks = [];
@@ -69,7 +74,7 @@ function requestPinned(url, addresses, timeoutMs, maxBytes) {
             response.on("data", (chunk) => {
                 total += chunk.byteLength;
                 if (total > maxBytes) {
-                    response.destroy(new Error(`Image exceeds the ${maxBytes} byte download limit`));
+                    response.destroy(new Error(`Media exceeds the ${maxBytes} byte download limit`));
                     return;
                 }
                 chunks.push(chunk);
@@ -86,7 +91,7 @@ function requestPinned(url, addresses, timeoutMs, maxBytes) {
             });
         });
         request.setTimeout(timeoutMs, () => {
-            request.destroy(new Error(`Image download timed out after ${timeoutMs}ms`));
+            request.destroy(new Error(`Media download timed out after ${timeoutMs}ms`));
         });
         request.once("error", reject);
         request.end();
@@ -95,7 +100,7 @@ function requestPinned(url, addresses, timeoutMs, maxBytes) {
 function remainingMs(deadline) {
     const remaining = deadline - Date.now();
     if (remaining <= 0)
-        throw new Error("Image download timed out");
+        throw new Error("Media download timed out");
     return remaining;
 }
 async function withDeadline(promise, deadline) {
@@ -105,7 +110,7 @@ async function withDeadline(promise, deadline) {
         return await Promise.race([
             promise,
             new Promise((_, reject) => {
-                timer = setTimeout(() => reject(new Error(`Image download timed out after ${timeoutMs}ms`)), timeoutMs);
+                timer = setTimeout(() => reject(new Error(`Media download timed out after ${timeoutMs}ms`)), timeoutMs);
             }),
         ]);
     }
@@ -117,7 +122,7 @@ async function withDeadline(promise, deadline) {
 async function resolvePublicUrl(value, lookup, deadline) {
     const normalized = normalizeBoardRemoteUrl(value);
     if (!normalized)
-        throw new Error("Image URL must be a public HTTP(S) URL");
+        throw new Error("Media URL must be a public HTTP(S) URL");
     const url = new URL(normalized);
     const hostname = url.hostname.replace(/^\[|\]$/g, "");
     const addresses = isIP(hostname)
@@ -126,11 +131,21 @@ async function resolvePublicUrl(value, lookup, deadline) {
     const [first, ...rest] = addresses;
     if (!first ||
         addresses.some((entry) => !isPublicBoardRemoteAddress(entry.address))) {
-        throw new Error("Image URL resolves to a private address");
+        throw new Error("Media URL resolves to a private address");
     }
     return { url, addresses: [first, ...rest] };
 }
-export async function downloadPublicImage(input, options = {}) {
+export function downloadPublicImage(input, options = {}) {
+    return downloadPublicMedia(input, IMAGE_MIME_TYPES, options);
+}
+export function downloadPublicAudio(input, options = {}) {
+    return downloadPublicMedia(input, AUDIO_MIME_TYPES, {
+        maxBytes: 64 * 1024 * 1024,
+        timeoutMs: 30_000,
+        ...options,
+    });
+}
+async function downloadPublicMedia(input, mimeTypes, options) {
     const lookup = options.lookup ?? defaultLookup;
     const requester = options.requester ?? requestPinned;
     const maxBytes = options.maxBytes ?? REMOTE_IMAGE_MAX_BYTES;
@@ -142,9 +157,9 @@ export async function downloadPublicImage(input, options = {}) {
         if (REDIRECT_STATUSES.has(response.status)) {
             const location = response.headers.get("location");
             if (!location)
-                throw new Error("Image redirect is missing a location");
+                throw new Error("Media redirect is missing a location");
             if (redirect === MAX_REDIRECTS)
-                throw new Error("Too many image redirects");
+                throw new Error("Too many media redirects");
             current = new URL(location, url).toString();
             continue;
         }
@@ -152,17 +167,17 @@ export async function downloadPublicImage(input, options = {}) {
             throw new Error(`HTTP ${response.status}`);
         }
         if (response.bytes.byteLength > maxBytes) {
-            throw new Error(`Image exceeds the ${maxBytes} byte download limit`);
+            throw new Error(`Media exceeds the ${maxBytes} byte download limit`);
         }
         const mimeType = response.headers
             .get("content-type")
             ?.split(";", 1)[0]
             ?.trim()
             .toLowerCase();
-        if (!mimeType || !IMAGE_MIME_TYPES.has(mimeType)) {
-            throw new Error("Remote background must be a supported raster image");
+        if (!mimeType || !mimeTypes.has(mimeType)) {
+            throw new Error("Remote resource has an unsupported media type");
         }
         return { bytes: response.bytes, mimeType };
     }
-    throw new Error("Too many image redirects");
+    throw new Error("Too many media redirects");
 }

package/dist/space.d.ts

@@ -11,6 +11,7 @@ export declare class SpaceTargetError extends Error {
  */
 export declare function identityKeyFrom(input: {
     env: string;
+    baseUrl?: string;
     executionToken?: string | null;
     idToken?: string | null;
     accessToken?: string | null;

package/dist/space.js

@@ -1,7 +1,7 @@
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { HOME_SPACE_SLUG, parseSpaceRef, resolveCohubEnvironment } from "@neta-art/cohub";
+import { COHUB_ENVIRONMENTS, HOME_SPACE_SLUG, normalizeBaseUrl, parseSpaceRef, resolveApiBaseUrl, resolveCohubEnvironment } from "@neta-art/cohub";
 import { readAuthSession } from "./auth.js";
 import { createClient } from "./client.js";
 import { getRuntimeSpaceBinding } from "./runtime/space-binding.js";
@@ -40,17 +40,21 @@ function jwtClaim(token, key) {
  * Execution grants identify the actor as `actorUserId`, not `sub`.
  */
 export function identityKeyFrom(input) {
+    const baseUrl = input.baseUrl ? normalizeBaseUrl(input.baseUrl) : "";
+    const defaultBaseUrl = COHUB_ENVIRONMENTS[input.env === "dev" ? "dev" : "prod"].apiBaseUrl;
+    const namespace = baseUrl && baseUrl !== defaultBaseUrl ? `${input.env}:${baseUrl}` : input.env;
     if (input.executionToken) {
         const actor = jwtClaim(input.executionToken, "actorUserId") ?? jwtClaim(input.executionToken, "sub");
-        return actor ? `${input.env}:${actor}` : null;
+        return actor ? `${namespace}:${actor}` : null;
     }
     const sub = jwtClaim(input.idToken, "sub") ?? jwtClaim(input.accessToken, "sub");
-    return sub ? `${input.env}:${sub}` : null;
+    return sub ? `${namespace}:${sub}` : null;
 }
 export function currentIdentityKey() {
     const session = readAuthSession();
     return identityKeyFrom({
         env: resolveCohubEnvironment(),
+        baseUrl: resolveApiBaseUrl(),
         executionToken: process.env.COHUB_EXECUTION_TOKEN?.trim(),
         idToken: session?.idToken,
         accessToken: session?.accessToken,
@@ -81,10 +85,10 @@ function writeHomeSpaceCache(key, spaceId) {
         // Cache is best-effort; never fail the command over it.
     }
 }
-let homeSpacePromise = null;
+const homeSpaces = new Map();
 const spaceRefs = new Map();
 export function clearHomeSpaceCache() {
-    homeSpacePromise = null;
+    homeSpaces.clear();
     spaceRefs.clear();
     try {
         rmSync(CACHE_PATH, { force: true });
@@ -107,17 +111,21 @@ export function explicitSpace(program) {
 }
 /** Cached per identity and memoized per process. */
 export function resolveHomeSpace() {
-    homeSpacePromise ??= (async () => {
-        const key = currentIdentityKey();
-        const cached = key ? readHomeSpaceCache(CACHE_PATH, key) : null;
-        if (cached)
-            return cached;
-        const space = await createClient().spaces.ensureHome();
-        if (key)
-            writeHomeSpaceCache(key, space.id);
-        return space.id;
-    })();
-    return homeSpacePromise;
+    const key = currentIdentityKey();
+    const memoKey = key ?? resolveApiBaseUrl();
+    let resolved = homeSpaces.get(memoKey);
+    if (!resolved)
+        resolved = (async () => {
+            const cached = key ? readHomeSpaceCache(CACHE_PATH, key) : null;
+            if (cached)
+                return cached;
+            const space = await createClient().spaces.ensureHome();
+            if (key)
+                writeHomeSpaceCache(key, space.id);
+            return space.id;
+        })();
+    homeSpaces.set(memoKey, resolved);
+    return resolved;
 }
 async function lookupSpaceRef(value) {
     const ref = parseSpaceRef(value);
@@ -141,10 +149,10 @@ async function lookupSpaceRef(value) {
     }
 }
 export function resolveSpaceRef(value) {
-    const key = value.trim();
+    const key = `${currentIdentityKey() ?? resolveApiBaseUrl()}:${value.trim()}`;
     let resolved = spaceRefs.get(key);
     if (!resolved) {
-        resolved = lookupSpaceRef(key);
+        resolved = lookupSpaceRef(value.trim());
         spaceRefs.set(key, resolved);
     }
     return resolved;

package/dist/web.js

@@ -1,6 +1,4 @@
-import { resolveCohubEnvironment } from "@neta-art/cohub";
+import { resolveWebBaseUrl } from "@neta-art/cohub";
 export function webUrl(path) {
-    const origin = process.env.COHUB_WEB_URL?.replace(/\/+$/, "") ??
-        `https://${resolveCohubEnvironment() === "prod" ? "" : "dev."}cohub.live`;
-    return `${origin}${path}`;
+    return `${resolveWebBaseUrl()}${path}`;
 }

package/package.json

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