@neta-art/cohub 7.0.0 → 8.0.1

package/dist/chunks/http.js

@@ -1296,39 +1296,43 @@ z.object({
 	}).optional()
 }).strict();
 //#endregion
-//#region ../protocol/dist/ui-command.js
+//#region ../protocol/dist/desktop-command.js
 /**
-* Lets an agent drive the Cohub frontend that originated the work. Routing comes
+* Lets an agent drive the Cohub desktop that originated the app. Routing comes
 * from request provenance, never a caller-supplied target, so a command only
 * reaches the actor's own instances.
+*
+* The canonical command is `desktop.open`. The legacy `preview.show` shape is
+* accepted on input and normalized, so older clients keep working, but commands
+* are always stored and dispatched in the canonical form.
 */
-const UI_COMMAND_VERSION = 1;
+const DESKTOP_COMMAND_VERSION = 1;
 /** Persisted and broadcast, so every field is capped; MAX_BYTES bounds the whole. */
-const UI_COMMAND_PAYLOAD_MAX_BYTES = 32 * 1024;
-const UI_COMMAND_MAX_BYTES = 40 * 1024;
-const UI_COMMAND_LAUNCH_MAX_LENGTH = 2048;
-const UI_COMMAND_DEFAULT_TIMEOUT_MS = 600 * 1e3;
-const UI_COMMAND_MAX_TIMEOUT_MS = 720 * 60 * 1e3;
-const UI_COMMAND_SETTLEMENT_GRACE_SECONDS = 600;
+const DESKTOP_COMMAND_PAYLOAD_MAX_BYTES = 32 * 1024;
+const DESKTOP_COMMAND_MAX_BYTES = 40 * 1024;
+const DESKTOP_COMMAND_LAUNCH_MAX_LENGTH = 2048;
+const DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS = 600 * 1e3;
+const DESKTOP_COMMAND_MAX_TIMEOUT_MS = 720 * 60 * 1e3;
+const DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS = 600;
 /** Keeps pending commands reportable for the full wait window plus settlement grace. */
-const UI_COMMAND_PENDING_TTL_SECONDS = 43800;
-const UI_COMMAND_TERMINAL_TTL_SECONDS = 1800;
-const UI_COMMAND_TERMINAL_STATUSES = [
+const DESKTOP_COMMAND_PENDING_TTL_SECONDS = 43800;
+const DESKTOP_COMMAND_TERMINAL_TTL_SECONDS = 1800;
+const DESKTOP_COMMAND_TERMINAL_STATUSES = [
 	"applied",
 	"no_active_client",
-	"ui_host_unavailable",
+	"desktop_host_unavailable",
 	"rejected",
 	"unsupported",
 	"timeout"
 ];
-const isTerminalUiCommandStatus = (status) => UI_COMMAND_TERMINAL_STATUSES.includes(status);
+const isTerminalDesktopCommandStatus = (status) => DESKTOP_COMMAND_TERMINAL_STATUSES.includes(status);
 const METHOD_RE = /^[A-Za-z][A-Za-z0-9_.:-]{0,63}$/;
-const isUiSurfaceMethod = (value) => typeof value === "string" && METHOD_RE.test(value);
-const UI_COMMAND_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
-const parseUiCommandId = (value) => {
+const isDesktopCallMethod = (value) => typeof value === "string" && METHOD_RE.test(value);
+const DESKTOP_COMMAND_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const parseDesktopCommandId = (value) => {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
-	return UI_COMMAND_ID_RE.test(trimmed) ? trimmed : null;
+	return DESKTOP_COMMAND_ID_RE.test(trimmed) ? trimmed : null;
 };
 const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
 const asTrimmed = (value) => {
@@ -1346,7 +1350,7 @@ const parseLaunch = (value) => {
 		...hash ? { hash: hash.startsWith("#") ? hash : `#${hash}` } : {}
 	};
 };
-const measureUiCommandPayload = (value) => {
+const measureDesktopCommandPayload = (value) => {
 	if (value === void 0) return 0;
 	try {
 		return new TextEncoder().encode(JSON.stringify(value) ?? "").length;
@@ -1354,118 +1358,131 @@ const measureUiCommandPayload = (value) => {
 		return null;
 	}
 };
-const parseUiCommand = (input) => {
+/**
+* Parse a desktop command from untrusted input.
+*
+* Accepts both the canonical `desktop.open` shape (`target` / `call`) and the
+* legacy `preview.show` shape (`preview` / `request`); the result is always
+* canonical so every later stage handles a single form.
+*/
+const parseDesktopCommand = (input) => {
 	if (!isRecord$1(input)) return {
 		command: null,
 		error: "command must be an object"
 	};
-	if (input.type !== "preview.show") return {
+	const legacy = input.type === "preview.show";
+	if (input.type !== "desktop.open" && !legacy) return {
 		command: null,
-		error: "command.type must be one of: preview.show"
+		error: "command.type must be one of: desktop.open"
 	};
-	const preview = input.preview;
-	if (!isRecord$1(preview)) return {
+	const target = isRecord$1(input.target) ? input.target : isRecord$1(input.preview) ? input.preview : null;
+	if (!target) return {
 		command: null,
-		error: "command.preview is required"
+		error: "command.target is required"
 	};
-	if (preview.kind !== "work" && preview.kind !== "file") return {
+	const kind = target.kind === "app" || legacy && target.kind === "work" ? "app" : target.kind === "file" ? "file" : null;
+	if (!kind) return {
 		command: null,
-		error: "command.preview.kind must be one of: work, file"
+		error: "command.target.kind must be one of: app, file"
 	};
-	if (preview.kind === "file") {
-		const path = asTrimmed(preview.path);
+	if (kind === "file") {
+		const path = asTrimmed(target.path);
 		if (!path) return {
 			command: null,
-			error: "command.preview.path is required"
+			error: "command.target.path is required"
 		};
 		if (path.length > 2048 || path.startsWith("/") || path.includes("\0") || path.includes("\\") || path.split("/").some((segment) => segment === "..")) return {
 			command: null,
-			error: "command.preview.path must be a relative Space file path"
+			error: "command.target.path must be a relative Space file path"
 		};
-		const command = {
-			type: "preview.show",
-			preview: {
-				kind: "file",
-				path
-			}
+		if (input.call !== void 0 && input.call !== null) return {
+			command: null,
+			error: "command.call is only supported for app targets"
 		};
-		if (input.request !== void 0 && input.request !== null) return {
+		if (legacy && input.request !== void 0 && input.request !== null) return {
 			command: null,
-			error: "command.request is only supported for Work previews"
+			error: "command.call is only supported for app targets"
 		};
 		return {
-			command,
+			command: {
+				type: "desktop.open",
+				target: {
+					kind: "file",
+					path
+				}
+			},
 			error: null
 		};
 	}
-	const workId = asTrimmed(preview.workId);
-	if (!workId) return {
+	const appId = asTrimmed(target.appId ?? target.workId);
+	if (!appId) return {
 		command: null,
-		error: "command.preview.workId is required"
+		error: "command.target.appId is required"
 	};
-	if (!isUuid(workId)) return {
+	if (!isUuid(appId)) return {
 		command: null,
-		error: "command.preview.workId must be a Work id"
+		error: "command.target.appId must be an App id"
 	};
-	const label = asTrimmed(preview.label);
+	const label = asTrimmed(target.label);
 	if (label && label.length > 200) return {
 		command: null,
-		error: `command.preview.label exceeds 200 characters`
+		error: `command.target.label exceeds 200 characters`
 	};
-	const launch = parseLaunch(preview.launch);
+	const launch = parseLaunch(target.launch);
 	if (launch) {
 		for (const [field, value] of [["search", launch.search], ["hash", launch.hash]]) if (value && value.length > 2048) return {
 			command: null,
-			error: `command.preview.launch.${field} exceeds ${UI_COMMAND_LAUNCH_MAX_LENGTH} characters`
+			error: `command.target.launch.${field} exceeds ${DESKTOP_COMMAND_LAUNCH_MAX_LENGTH} characters`
 		};
 	}
-	let request;
-	if (input.request !== void 0 && input.request !== null) {
-		if (!isRecord$1(input.request)) return {
+	const callSource = input.call !== void 0 ? input.call : input.request;
+	let call;
+	if (callSource !== void 0 && callSource !== null) {
+		if (!isRecord$1(callSource)) return {
 			command: null,
-			error: "command.request must be an object"
+			error: "command.call must be an object"
 		};
-		const method = asTrimmed(input.request.method);
+		const method = asTrimmed(callSource.method);
 		if (!method) return {
 			command: null,
-			error: "command.request.method is required"
+			error: "command.call.method is required"
 		};
-		if (!isUiSurfaceMethod(method)) return {
+		if (!isDesktopCallMethod(method)) return {
 			command: null,
-			error: "command.request.method has an unsupported format"
+			error: "command.call.method has an unsupported format"
 		};
-		const size = measureUiCommandPayload(input.request.input);
+		const size = measureDesktopCommandPayload(callSource.input);
 		if (size === null) return {
 			command: null,
-			error: "command.request.input must be JSON-serializable"
+			error: "command.call.input must be JSON-serializable"
 		};
 		if (size > 32768) return {
 			command: null,
-			error: `command.request.input exceeds ${UI_COMMAND_PAYLOAD_MAX_BYTES} bytes`
+			error: `command.call.input exceeds ${DESKTOP_COMMAND_PAYLOAD_MAX_BYTES} bytes`
 		};
-		request = {
+		call = {
 			method,
-			...input.request.input === void 0 ? {} : { input: input.request.input }
+			...callSource.input === void 0 ? {} : { input: callSource.input }
 		};
 	}
 	const command = {
-		type: "preview.show",
-		preview: {
-			kind: "work",
-			workId,
+		type: "desktop.open",
+		target: {
+			kind: "app",
+			appId,
 			...label ? { label } : {},
 			...launch ? { launch } : {}
 		},
-		...request ? { request } : {}
+		...call ? { call } : {}
 	};
-	const totalSize = measureUiCommandPayload(command);
+	const totalSize = measureDesktopCommandPayload(command);
 	if (totalSize === null) return {
 		command: null,
 		error: "command must be JSON-serializable"
 	};
 	if (totalSize > 40960) return {
 		command: null,
-		error: `command exceeds ${UI_COMMAND_MAX_BYTES} bytes`
+		error: `command exceeds ${DESKTOP_COMMAND_MAX_BYTES} bytes`
 	};
 	return {
 		command,
@@ -3113,7 +3130,7 @@ var SpaceEventsApi = class {
 				handler(event);
 				return;
 			}
-			if (type === "work.version.published" && event.type === "work.version.published") {
+			if (type === "app.version.published" && event.type === "app.version.published") {
 				handler(event);
 				return;
 			}
@@ -4000,79 +4017,6 @@ var TasksApi = class {
 	}
 };
 //#endregion
-//#region src/apis/ui-commands.ts
-const DEFAULT_POLL_INTERVAL_MS = 300;
-const resolveTimeoutMs = (timeoutMs) => {
-	const value = timeoutMs ?? 6e5;
-	if (!Number.isFinite(value) || value <= 0 || value > 432e5) throw new RangeError(`timeoutMs must be between 1 and ${UI_COMMAND_MAX_TIMEOUT_MS} milliseconds`);
-	return value;
-};
-const sleep = (ms, signal) => new Promise((resolve, reject) => {
-	if (signal?.aborted) {
-		reject(/* @__PURE__ */ new Error("aborted"));
-		return;
-	}
-	const timer = setTimeout(() => {
-		signal?.removeEventListener("abort", onAbort);
-		resolve();
-	}, ms);
-	const onAbort = () => {
-		clearTimeout(timer);
-		reject(/* @__PURE__ */ new Error("aborted"));
-	};
-	signal?.addEventListener("abort", onAbort, { once: true });
-});
-var UiCommandsApi = class {
-	transport;
-	constructor(transport) {
-		this.transport = transport;
-	}
-	create(input) {
-		return this.transport.request("/api/ui/commands", {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(input)
-		});
-	}
-	get(commandId) {
-		return this.transport.request(`/api/ui/commands/${encodeURIComponent(commandId)}`);
-	}
-	reportResult(commandId, input) {
-		return this.transport.request(`/api/ui/commands/${encodeURIComponent(commandId)}/result`, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(input)
-		});
-	}
-	async run(input, options = {}) {
-		const { command } = await this.create(input);
-		if (isTerminalUiCommandStatus(command.status)) return command;
-		return this.wait(command.commandId, options);
-	}
-	async wait(commandId, options = {}) {
-		const timeoutMs = resolveTimeoutMs(options.timeoutMs);
-		const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
-		const deadline = Date.now() + timeoutMs;
-		let latest = (await this.get(commandId)).command;
-		while (!isTerminalUiCommandStatus(latest.status)) {
-			const remaining = deadline - Date.now();
-			if (remaining <= 0) break;
-			await sleep(Math.min(pollIntervalMs, remaining), options.signal);
-			latest = (await this.get(commandId)).command;
-		}
-		if (isTerminalUiCommandStatus(latest.status)) return latest;
-		return {
-			...latest,
-			status: "timeout",
-			error: {
-				code: "timeout",
-				message: "No Cohub frontend reported a result before the timeout."
-			},
-			settledAt: (/* @__PURE__ */ new Date()).toISOString()
-		};
-	}
-};
-//#endregion
 //#region src/apis/user.ts
 const usageDate = (value) => value instanceof Date ? value.toISOString() : value;
 var UserApi = class {
@@ -4200,131 +4144,208 @@ var ReferralsApi = class {
 	}
 };
 //#endregion
-//#region src/apis/works.ts
-var WorksApi = class {
+//#region src/apis/apps.ts
+var AppsApi = class {
 	transport;
 	constructor(transport) {
 		this.transport = transport;
 	}
 	listBySpace(spaceId) {
-		return this.transport.request(`/api/works/space/${spaceId}`);
+		return this.transport.request(`/api/apps/space/${spaceId}`);
 	}
 	get(id) {
-		return this.transport.request(`/api/works/${id}`);
+		return this.transport.request(`/api/apps/${id}`);
 	}
 	/**
-	* Loads a published work's metadata + owner info by id (public access model).
-	* Used by the standalone work auth broker page.
+	* Loads a published app's metadata + owner info by id (public access model).
+	* Used by the standalone app auth broker page.
 	*/
 	getPublicById(id) {
-		return this.transport.request(`/api/works/${id}/public`);
+		return this.transport.request(`/api/apps/${id}/public`);
 	}
-	getBySlug(username, spaceSlug, workSlug, options) {
-		return this.transport.request(`/api/works/by-slug/${encodeURIComponent(username)}/${encodeURIComponent(spaceSlug)}/${encodeURIComponent(workSlug)}`, options?.signal ? { signal: options.signal } : void 0);
+	getBySlug(username, spaceSlug, appSlug, options) {
+		return this.transport.request(`/api/apps/by-slug/${encodeURIComponent(username)}/${encodeURIComponent(spaceSlug)}/${encodeURIComponent(appSlug)}`, options?.signal ? { signal: options.signal } : void 0);
 	}
 	create(input) {
-		return this.transport.request("/api/works", {
+		return this.transport.request("/api/apps", {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
 	update(id, input) {
-		return this.transport.request(`/api/works/${id}`, {
+		return this.transport.request(`/api/apps/${id}`, {
 			method: "PATCH",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
 	delete(id) {
-		return this.transport.request(`/api/works/${id}`, { method: "DELETE" });
+		return this.transport.request(`/api/apps/${id}`, { method: "DELETE" });
 	}
-	getStats(workId) {
-		return this.transport.request(`/api/works/${workId}/stats`);
+	getStats(appId) {
+		return this.transport.request(`/api/apps/${appId}/stats`);
 	}
-	listPromotions(workId) {
-		return this.transport.request(`/api/works/${workId}/promotions`);
+	listPromotions(appId) {
+		return this.transport.request(`/api/apps/${appId}/promotions`);
 	}
-	createPromotion(workId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions`, {
+	createPromotion(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getPromotionStats(workId, promotionId) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/stats`);
+	getPromotionStats(appId, promotionId) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/stats`);
 	}
-	recordPromotionEvent(workId, promotionId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/events`, {
+	recordPromotionEvent(appId, promotionId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/events`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	recordPromotionRegistration(workId, promotionId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/registration`, {
+	recordPromotionRegistration(appId, promotionId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/registration`, {
 			method: "POST",
 			headers: input ? { "Content-Type": "application/json" } : void 0,
 			body: input ? JSON.stringify(input) : void 0
 		});
 	}
-	listVersions(workId) {
-		return this.transport.request(`/api/works/${workId}/versions`);
+	listVersions(appId) {
+		return this.transport.request(`/api/apps/${appId}/versions`);
 	}
-	publishVersion(workId, input) {
-		return this.transport.request(`/api/works/${workId}/versions`, {
+	publishVersion(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/versions`, {
 			method: "POST",
 			headers: input ? { "Content-Type": "application/json" } : void 0,
 			body: input ? JSON.stringify(input) : void 0
 		});
 	}
-	createSession(workId) {
-		return this.transport.request(`/api/works/${workId}/session`, { method: "POST" });
+	createSession(appId) {
+		return this.transport.request(`/api/apps/${appId}/session`, { method: "POST" });
+	}
+	authorize(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/authorize`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+	}
+};
+//#endregion
+//#region src/apis/desktop-commands.ts
+const DEFAULT_POLL_INTERVAL_MS = 300;
+const resolveTimeoutMs = (timeoutMs) => {
+	const value = timeoutMs ?? 6e5;
+	if (!Number.isFinite(value) || value <= 0 || value > 432e5) throw new RangeError(`timeoutMs must be between 1 and ${DESKTOP_COMMAND_MAX_TIMEOUT_MS} milliseconds`);
+	return value;
+};
+const sleep = (ms, signal) => new Promise((resolve, reject) => {
+	if (signal?.aborted) {
+		reject(/* @__PURE__ */ new Error("aborted"));
+		return;
+	}
+	const timer = setTimeout(() => {
+		signal?.removeEventListener("abort", onAbort);
+		resolve();
+	}, ms);
+	const onAbort = () => {
+		clearTimeout(timer);
+		reject(/* @__PURE__ */ new Error("aborted"));
+	};
+	signal?.addEventListener("abort", onAbort, { once: true });
+});
+var DesktopCommandsApi = class {
+	transport;
+	constructor(transport) {
+		this.transport = transport;
+	}
+	create(input) {
+		return this.transport.request("/api/desktop/commands", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+	}
+	get(commandId) {
+		return this.transport.request(`/api/desktop/commands/${encodeURIComponent(commandId)}`);
 	}
-	authorize(workId, input) {
-		return this.transport.request(`/api/works/${workId}/authorize`, {
+	reportResult(commandId, input) {
+		return this.transport.request(`/api/desktop/commands/${encodeURIComponent(commandId)}/result`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
+	async run(input, options = {}) {
+		const { command } = await this.create(input);
+		if (isTerminalDesktopCommandStatus(command.status)) return command;
+		return this.wait(command.commandId, options);
+	}
+	async wait(commandId, options = {}) {
+		const timeoutMs = resolveTimeoutMs(options.timeoutMs);
+		const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+		const deadline = Date.now() + timeoutMs;
+		let latest = (await this.get(commandId)).command;
+		while (!isTerminalDesktopCommandStatus(latest.status)) {
+			const remaining = deadline - Date.now();
+			if (remaining <= 0) break;
+			await sleep(Math.min(pollIntervalMs, remaining), options.signal);
+			latest = (await this.get(commandId)).command;
+		}
+		if (isTerminalDesktopCommandStatus(latest.status)) return latest;
+		return {
+			...latest,
+			status: "timeout",
+			error: {
+				code: "timeout",
+				message: "No Cohub desktop reported a result before the timeout."
+			},
+			settledAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
 };
+/** @deprecated Use `DesktopCommandsApi`. */
+var UiCommandsApi = class extends DesktopCommandsApi {};
 //#endregion
-//#region src/apis/work-commerce.ts
-var WorkCommerceApi = class {
+//#region src/apis/app-commerce.ts
+var AppCommerceApi = class {
 	transport;
 	constructor(transport) {
 		this.transport = transport;
 	}
-	resolveProducts(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/products/resolve`, {
+	resolveProducts(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/products/resolve`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getEntitlements(workId) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/entitlements`);
+	getEntitlements(appId) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/entitlements`);
 	}
-	consumeCredits(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/credits/consume`, {
+	consumeCredits(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/credits/consume`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	purchase(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/purchase`, {
+	purchase(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/purchase`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getOrder(workId, orderId) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/orders/${encodeURIComponent(orderId)}`);
+	getOrder(appId, orderId) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/orders/${encodeURIComponent(orderId)}`);
 	}
 };
+/** @deprecated Use `AppCommerceApi`. */
+var WorkCommerceApi = class extends AppCommerceApi {};
 //#endregion
 //#region src/http.ts
 var CohubHttpClient = class {
@@ -4344,9 +4365,21 @@ var CohubHttpClient = class {
 	cronJobs;
 	invite;
 	referrals;
-	works;
-	workCommerce;
-	ui;
+	apps;
+	appCommerce;
+	/** @deprecated Use `apps`. */
+	get works() {
+		return this.apps;
+	}
+	/** @deprecated Use `appCommerce`. */
+	get workCommerce() {
+		return this.appCommerce;
+	}
+	desktop;
+	/** @deprecated Use `desktop`. */
+	get ui() {
+		return this.desktop;
+	}
 	transport;
 	constructor(options = {}) {
 		const apiBaseUrl = resolveApiBaseUrl(options);
@@ -4367,9 +4400,9 @@ var CohubHttpClient = class {
 		this.cronJobs = new CronJobsApi(this.transport);
 		this.invite = new PublicInviteApi(this.transport);
 		this.referrals = new ReferralsApi(this.transport);
-		this.works = new WorksApi(this.transport);
-		this.workCommerce = new WorkCommerceApi(this.transport);
-		this.ui = new UiCommandsApi(this.transport);
+		this.apps = new AppsApi(this.transport);
+		this.appCommerce = new AppCommerceApi(this.transport);
+		this.desktop = new DesktopCommandsApi(this.transport);
 	}
 	space(spaceId) {
 		return new SpaceClient(spaceId, this.transport, null);
@@ -4377,4 +4410,4 @@ var CohubHttpClient = class {
 };
 const createHttpClient = (options) => new CohubHttpClient(options);
 //#endregion
-export { SessionAccessApi as $, isTerminalUiCommandStatus as A, BOARD_ANIMATION_CHANNELS as B, UI_COMMAND_DEFAULT_TIMEOUT_MS as C, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as D, UI_COMMAND_PENDING_TTL_SECONDS as E, BoardItemPatchSchema as F, BoardTrackSchema as G, BoardCompositionInputSchema as H, BoardSemanticMutationSchema as I, BOARD_ARROW_STROKE_SIZE as J, parseBoardCompositionInput as K, BoardEffectInputSchema as L, parseUiCommand as M, parseUiCommandId as N, UI_COMMAND_TERMINAL_TTL_SECONDS as O, BoardAuthoringItemSchema as P, DEFAULT_BOARD_RENDER_LIMITS as Q, BoardEffectSchema as R, ensureRealtimeConnected as S, UI_COMMAND_PAYLOAD_MAX_BYTES as T, BoardCompositionSchema as U, BOARD_ANIMATION_CHANNEL_CAPABILITIES as V, BoardProceduralClipSchema as W, BOARD_BUILTIN_CLIP_KINDS as X, BOARD_BUILTIN_CAPABILITIES as Y, BOARD_BUILTIN_EFFECT_KINDS as Z, SessionGenerationStreamClient as _, ReferralsApi as a, ModelsApi as at, SessionPatchReducer as b, UiCommandsApi as c, ChannelsApi as ct, SpaceClient as d, ReferencesApi as et, SpacePublicFilesApi as f, buildSpacePath as g, buildSpaceInvitePath as h, WorksApi as i, PromptsApi as it, isUiSurfaceMethod as j, UI_COMMAND_VERSION as k, TasksApi as l, PublicInviteApi as m, createHttpClient as n, PublicAssetsApi as nt, UsersApi as o, GenerationsApi as ot, SpacesApi as p, BoardConnectionSchema as q, WorkCommerceApi as r, SkillsApi as rt, UserApi as s, CronJobsApi as st, CohubHttpClient as t, SearchApi as tt, BoardClient as u, createSessionGenerationStreamClient as v, UI_COMMAND_MAX_TIMEOUT_MS as w, createSessionPatchReducer as x, parseAssistantMessageCommit as y, parseBoardEffectInput as z };
+export { BOARD_BUILTIN_EFFECT_KINDS as $, DESKTOP_COMMAND_TERMINAL_TTL_SECONDS as A, BoardEffectSchema as B, createSessionPatchReducer as C, DESKTOP_COMMAND_PAYLOAD_MAX_BYTES as D, DESKTOP_COMMAND_MAX_TIMEOUT_MS as E, parseDesktopCommandId as F, BoardCompositionSchema as G, BOARD_ANIMATION_CHANNELS as H, BoardAuthoringItemSchema as I, parseBoardCompositionInput as J, BoardProceduralClipSchema as K, BoardItemPatchSchema as L, isDesktopCallMethod as M, isTerminalDesktopCommandStatus as N, DESKTOP_COMMAND_PENDING_TTL_SECONDS as O, parseDesktopCommand as P, BOARD_BUILTIN_CLIP_KINDS as Q, BoardSemanticMutationSchema as R, SessionPatchReducer as S, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS as T, BOARD_ANIMATION_CHANNEL_CAPABILITIES as U, parseBoardEffectInput as V, BoardCompositionInputSchema as W, BOARD_ARROW_STROKE_SIZE as X, BoardConnectionSchema as Y, BOARD_BUILTIN_CAPABILITIES as Z, buildSpaceInvitePath as _, DesktopCommandsApi as a, SkillsApi as at, createSessionGenerationStreamClient as b, ReferralsApi as c, GenerationsApi as ct, TasksApi as d, DEFAULT_BOARD_RENDER_LIMITS as et, BoardClient as f, PublicInviteApi as g, SpacesApi as h, WorkCommerceApi as i, PublicAssetsApi as it, DESKTOP_COMMAND_VERSION as j, DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS as k, UsersApi as l, CronJobsApi as lt, SpacePublicFilesApi as m, createHttpClient as n, ReferencesApi as nt, UiCommandsApi as o, PromptsApi as ot, SpaceClient as p, BoardTrackSchema as q, AppCommerceApi as r, SearchApi as rt, AppsApi as s, ModelsApi as st, CohubHttpClient as t, SessionAccessApi as tt, UserApi as u, ChannelsApi as ut, buildSpacePath as v, ensureRealtimeConnected as w, parseAssistantMessageCommit as x, SessionGenerationStreamClient as y, BoardEffectInputSchema as z };

package/dist/chunks/transport.js

@@ -10,7 +10,8 @@ const REALTIME_DOMAINS = [
 	"space",
 	"label",
 	"room",
-	"ui"
+	"ui",
+	"desktop"
 ];
 const isRealtimeDomain = (value) => typeof value === "string" && REALTIME_DOMAINS.some((domain) => domain === value);
 /** Accepted room event names. Shared so a client can reject one before sending. */