Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
feat(spaces): New UI on by default for Beta (0.8.1), saved only as an explicit choice (CUA-1514) (#5108)
ddupont3eb7c09ce3cd
diff --git a/apps/cua-spaces-desktop/src/bridge/settings.ts b/apps/cua-spaces-desktop/src/bridge/settings.tsindex fa89989494..b67eece485 100644--- a/apps/cua-spaces-desktop/src/bridge/settings.ts+++ b/apps/cua-spaces-desktop/src/bridge/settings.ts@@ -69,8 +69,8 @@ export function settingsPage(model: AppModel, parts: HostParts) {return model.native.appSettingsWithStorage(page, parts.storage.section, model.settings.experiments);}-/** The SwiftUI app's "New UI (preview)": this app is the web UI, so its switch (and its note) is not offered here. */-export const WEB_UI_ROWS = new Set(["experiment:web_ui", "experiment:web_ui-note"]);+/** The SwiftUI app's New UI switch ("Use classic UI", and the older `experiment:web_ui`): this app is the web UI, so it (and its note) is not offered here. */+export const WEB_UI_ROWS = new Set(["experiment:classic_ui", "experiment:classic_ui-note", "experiment:web_ui", "experiment:web_ui-note"]);export function experimentsPage(model: AppModel) {const page = model.native.appExperimentsPage(model.settings.experiments);diff --git a/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi-ffi.ts b/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi-ffi.tsindex f73f101a5d..8f88c16034 100644--- a/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi-ffi.ts+++ b/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi-ffi.ts@@ -1282,6 +1282,16 @@ const DEFINITIONS = {ret: FfiType.RustBuffer,hasRustCallStatus: true,},+ "uniffi_cua_spaces_ffi_fn_func_app_settings_choose_experiment": {+ args: [FfiType.RustBuffer, FfiType.RustBuffer, FfiType.RustBuffer],+ ret: FfiType.RustBuffer,+ hasRustCallStatus: true,+ },+ "uniffi_cua_spaces_ffi_fn_func_app_settings_first_launch_channel": {+ args: [FfiType.RustBuffer, FfiType.RustBuffer],+ ret: FfiType.RustBuffer,+ hasRustCallStatus: true,+ },"uniffi_cua_spaces_ffi_fn_func_app_settings_input_from_json": {args: [FfiType.RustBuffer],ret: FfiType.RustBuffer,@@ -1297,6 +1307,11 @@ const DEFINITIONS = {ret: FfiType.RustBuffer,hasRustCallStatus: true,},+ "uniffi_cua_spaces_ffi_fn_func_app_settings_resolve_new_ui": {+ args: [FfiType.RustBuffer, FfiType.RustBuffer],+ ret: FfiType.RustBuffer,+ hasRustCallStatus: true,+ },"uniffi_cua_spaces_ffi_fn_func_app_settings_save": {args: [FfiType.RustBuffer, FfiType.RustBuffer],ret: FfiType.Void,@@ -2927,6 +2942,16 @@ const DEFINITIONS = {ret: FfiType.UInt16,hasRustCallStatus: false,},+ "uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment": {+ args: [],+ ret: FfiType.UInt16,+ hasRustCallStatus: false,+ },+ "uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel": {+ args: [],+ ret: FfiType.UInt16,+ hasRustCallStatus: false,+ },"uniffi_cua_spaces_ffi_checksum_func_app_settings_input_from_json": {args: [],ret: FfiType.UInt16,@@ -2942,6 +2967,11 @@ const DEFINITIONS = {ret: FfiType.UInt16,hasRustCallStatus: false,},+ "uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui": {+ args: [],+ ret: FfiType.UInt16,+ hasRustCallStatus: false,+ },"uniffi_cua_spaces_ffi_checksum_func_app_settings_save": {args: [],ret: FfiType.UInt16,@@ -4052,9 +4082,12 @@ interface NativeModuleInterface {uniffi_cua_spaces_ffi_fn_func_app_sensitive_group_sdk(group: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_sent_file(report: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_sent_files_from_json(json: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;+ uniffi_cua_spaces_ffi_fn_func_app_settings_choose_experiment(settings: Uint8Array, row: Uint8Array, option: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;+ uniffi_cua_spaces_ffi_fn_func_app_settings_first_launch_channel(channel: Uint8Array, version: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_settings_input_from_json(json: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_settings_load(path: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_settings_page(input: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;+ uniffi_cua_spaces_ffi_fn_func_app_settings_resolve_new_ui(settings: Uint8Array, version: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_settings_save(path: Uint8Array, settings: Uint8Array, uniffi_out_err: UniffiRustCallStatus): void;uniffi_cua_spaces_ffi_fn_func_app_settings_with_storage(page: Uint8Array, storage: Uint8Array, experiments: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;uniffi_cua_spaces_ffi_fn_func_app_share_action_from_json(json: Uint8Array, uniffi_out_err: UniffiRustCallStatus): Uint8Array;@@ -4381,9 +4414,12 @@ interface NativeModuleInterface {uniffi_cua_spaces_ffi_checksum_func_app_sensitive_group_sdk(): number;uniffi_cua_spaces_ffi_checksum_func_app_sent_file(): number;uniffi_cua_spaces_ffi_checksum_func_app_sent_files_from_json(): number;+ uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment(): number;+ uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel(): number;uniffi_cua_spaces_ffi_checksum_func_app_settings_input_from_json(): number;uniffi_cua_spaces_ffi_checksum_func_app_settings_load(): number;uniffi_cua_spaces_ffi_checksum_func_app_settings_page(): number;+ uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui(): number;uniffi_cua_spaces_ffi_checksum_func_app_settings_save(): number;uniffi_cua_spaces_ffi_checksum_func_app_settings_with_storage(): number;uniffi_cua_spaces_ffi_checksum_func_app_share_action_from_json(): number;diff --git a/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi.ts b/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi.tsindex e42430227a..2409c16199 100644--- a/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi.ts+++ b/apps/cua-spaces-desktop/src/native/generated/cua_spaces_ffi.ts@@ -3750,6 +3750,51 @@ export function appSentFilesFromJson(json: string): Array<AppSentFileInfo> /*thr));}+/**+ * The settings after a Settings, Experiments row's choice (the switches,+ * and the New UI's "Use classic UI" saved as the user's choice).+ */+export function appSettingsChooseExperiment(settings: AppSettings, row: string, option: string): AppSettings {+ return ((__rb: Uint8Array) => {+ try {+ return FfiConverterTypeAppSettings.lift(__rb);+ } finally {+ nativeModule().rustbuffer_free(__rb);+ }+ })(uniffiCaller.rustCall(+ /*caller:*/ (callStatus) => {+ return nativeModule().uniffi_cua_spaces_ffi_fn_func_app_settings_choose_experiment(+ FfiConverterTypeAppSettings.lower(settings, nativeModule().rustbuffer_alloc),+ FfiConverterString.lower(row, nativeModule().rustbuffer_alloc),+ FfiConverterString.lower(option, nativeModule().rustbuffer_alloc),+ callStatus);+ },+ /*liftString:*/ FfiConverterString.lift.bind(FfiConverterString),+ ));+ }++/**+ * The update channel of an install's first launch, from the file's+ * `channel`: Beta for a prerelease, else unchanged.+ */+export function appSettingsFirstLaunchChannel(channel: AppUpdateChannel, version: string): AppUpdateChannel {+ return ((__rb: Uint8Array) => {+ try {+ return FfiConverterTypeAppUpdateChannel.lift(__rb);+ } finally {+ nativeModule().rustbuffer_free(__rb);+ }+ })(uniffiCaller.rustCall(+ /*caller:*/ (callStatus) => {+ return nativeModule().uniffi_cua_spaces_ffi_fn_func_app_settings_first_launch_channel(+ FfiConverterTypeAppUpdateChannel.lower(channel, nativeModule().rustbuffer_alloc),+ FfiConverterString.lower(version, nativeModule().rustbuffer_alloc),+ callStatus);+ },+ /*liftString:*/ FfiConverterString.lift.bind(FfiConverterString),+ ));+ }+/*** The Settings page's input from JSON (parity flows).*/@@ -3811,6 +3856,29 @@ export function appSettingsPage(input: AppSettingsInput): AppSettingsPage {));}+/**+ * The settings with the New UI as a launch of `version` shows it: the+ * user's choice, else the default for the update channel and version+ * (again after the channel changes).+ */+export function appSettingsResolveNewUi(settings: AppSettings, version: string): AppSettings {+ return ((__rb: Uint8Array) => {+ try {+ return FfiConverterTypeAppSettings.lift(__rb);+ } finally {+ nativeModule().rustbuffer_free(__rb);+ }+ })(uniffiCaller.rustCall(+ /*caller:*/ (callStatus) => {+ return nativeModule().uniffi_cua_spaces_ffi_fn_func_app_settings_resolve_new_ui(+ FfiConverterTypeAppSettings.lower(settings, nativeModule().rustbuffer_alloc),+ FfiConverterString.lower(version, nativeModule().rustbuffer_alloc),+ callStatus);+ },+ /*liftString:*/ FfiConverterString.lift.bind(FfiConverterString),+ ));+ }+/*** Writes the settings file.*/@@ -11251,7 +11319,8 @@ export type AppExperiments = {*/sharing: boolean,/**- * The shared web UI, previewed in its own window.+ * The New UI (the shared web UI) is the main window: the user's choice+ * or, without one, [`new_ui_default`] ([`crate::settings::resolve_new_ui`]).*/webUi: boolean}@@ -31768,9 +31837,19 @@ export type AppSettings = {launchAtLogin?: boolean,/*** Settings, Experiments: every switch off unless turned on- * ([`crate::experiments`]).+ * ([`crate::experiments`]). Its `webUi` is the New UI as this launch+ * shows it ([`resolve_new_ui`]); the file keeps only [`Self::new_ui`]'s+ * "on" there, the value older builds read.*/experiments: AppExperiments,+ /**+ * The New UI as the user chose it (Settings, Experiments, "Use classic+ * UI"); `None`: never chosen, so+ * [`crate::experiments::new_ui_default`] decides. An older build's+ * saved `webUi: true` reads as `Some(true)`; its `false` was only the+ * saved default, so it reads as never chosen ([`load`]).+ */+ newUi?: boolean,/*** Keyvault copies (import ids) the user dismissed from the notch: it no* longer shows them, nothing is revoked or wiped@@ -31827,6 +31906,7 @@ const FfiConverterTypeAppSettings = (() => {updateChannel: FfiConverterTypeAppUpdateChannel.read(from),launchAtLogin: FfiConverterOptionalBoolean.read(from),experiments: FfiConverterTypeAppExperiments.read(from),+ newUi: FfiConverterOptionalBoolean.read(from),dismissedAccess: FfiConverterSequenceString.read(from),keyvaultSiteIcons: FfiConverterBool.read(from),teleportChoices: FfiConverterSequenceTypeAppRememberedChoice.read(from),@@ -31844,6 +31924,7 @@ const FfiConverterTypeAppSettings = (() => {FfiConverterTypeAppUpdateChannel.write(value.updateChannel, into);FfiConverterOptionalBoolean.write(value.launchAtLogin, into);FfiConverterTypeAppExperiments.write(value.experiments, into);+ FfiConverterOptionalBoolean.write(value.newUi, into);FfiConverterSequenceString.write(value.dismissedAccess, into);FfiConverterBool.write(value.keyvaultSiteIcons, into);FfiConverterSequenceTypeAppRememberedChoice.write(value.teleportChoices, into);@@ -31860,6 +31941,7 @@ const FfiConverterTypeAppSettings = (() => {FfiConverterTypeAppUpdateChannel.allocationSize(value.updateChannel) +FfiConverterOptionalBoolean.allocationSize(value.launchAtLogin) +FfiConverterTypeAppExperiments.allocationSize(value.experiments) ++ FfiConverterOptionalBoolean.allocationSize(value.newUi) +FfiConverterSequenceString.allocationSize(value.dismissedAccess) +FfiConverterBool.allocationSize(value.keyvaultSiteIcons) +FfiConverterSequenceTypeAppRememberedChoice.allocationSize(value.teleportChoices) +@@ -58969,6 +59051,12 @@ function uniffiEnsureInitialized() {if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_sent_files_from_json() !== 3362) {throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_sent_files_from_json");}+ if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment() !== 8693) {+ throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment");+ }+ if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel() !== 11279) {+ throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel");+ }if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_input_from_json() !== 15437) {throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_input_from_json");}@@ -58978,6 +59066,9 @@ function uniffiEnsureInitialized() {if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_page() !== 454) {throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_page");}+ if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui() !== 48081) {+ throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui");+ }if (nativeModule().uniffi_cua_spaces_ffi_checksum_func_app_settings_save() !== 30129) {throw new UniffiInternalError.ApiChecksumMismatch("uniffi_cua_spaces_ffi_checksum_func_app_settings_save");}diff --git a/apps/cua-spaces-desktop/test/host-bridge.test.ts b/apps/cua-spaces-desktop/test/host-bridge.test.tsindex 83c4fd182f..732f8504e9 100644--- a/apps/cua-spaces-desktop/test/host-bridge.test.ts+++ b/apps/cua-spaces-desktop/test/host-bridge.test.ts@@ -513,12 +513,14 @@ describe.skipIf(!built)("This machine, Devices and Settings on the app core", ()expect(settingsEvents).toBeGreaterThan(0);});- it("offers every experiment but the New UI preview, which this app is", async () => {+ it("offers every experiment but the New UI switch (Use classic UI), which this app is", async () => {const s = (await call("settings.get")) as { experiments: { sections: { rows: { id: string }[] }[] } };const rows = s.experiments.sections.flatMap((x) => x.rows.map((r) => r.id));expect(rows).toEqual(expect.arrayContaining(["experiment:cua_volume", "experiment:your_cloud", "experiment:sharing"]));expect(rows).not.toContain("experiment:web_ui");+ expect(rows).not.toContain("experiment:classic_ui");expect(await code("settings.choose", { row: "experiment:web_ui", option: "off" })).toBe("unsupported");+ expect(await code("settings.choose", { row: "experiment:classic_ui", option: "on" })).toBe("unsupported");});it("New Space's \u201cUse built-in Lume\u201d and \u201cUse built-in runtime\u201d change the Runtimes rows", async () => {diff --git a/apps/cua-spaces-macos/README.md b/apps/cua-spaces-macos/README.mdindex f0d9829ede..026112316d 100644--- a/apps/cua-spaces-macos/README.md+++ b/apps/cua-spaces-macos/README.md@@ -73,9 +73,9 @@ run (with a throwaway `HOME`). State lives under `$HOME/Library/Application Supp`CuaSpacesMac --check-launch-only` loads the app's libraries, prints its version and exits(`scripts/check-launch.sh`; release builds too).-## New UI (preview)+## New UI-Settings, Experiments, "New UI (preview)" (`web_ui`, off by default) makes+The New UI (the `web_ui` experiment) makes`WebUIWindowController` (`Sources/CuaSpacesMacKit/WebHost`) the main window: a`WKWebView` with the shared React UI (`apps/cua-spaces-web`) in a windowwithout a title bar. Turning it on puts that window where the native one was@@ -87,6 +87,15 @@ Started and the app's notifications; the native window, opened any other way(the Window menu), gives way to it. The notch, the menu bar extra, Touch ID, the updater and video staynative; a Space's desktop opens in its native window.+It is on by default on the Beta update channel (the setting Sparkle uses)+from the 0.8.1 betas, and on every channel from 0.8.1 (0.8.0 shipped without it)+(`experiments::new_ui_default`). Settings, Experiments, "Use classic UI"+(`experiment:classic_ui`) is the way back; it saves the user's choice+(`AppSettings.new_ui`), which later launches keep. Only a choice is saved:+an older build's saved `webUi: false` was its default, so it reads as no+choice, and a saved `true` is kept (`settings::load`). A beta's first launch+starts on the Beta channel (`settings::first_launch_channel`).+- Release: `scripts/build-app.sh` copies the web build (`apps/cua-spaces-web/dist`,or `CUA_WEBUI_DIST`) to `Contents/Resources/WebUI`, served at`cua-spaces://app/`. Without it the window shows how to add it.diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppEnvironment.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppEnvironment.swiftindex 73fe578021..2498d1155b 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppEnvironment.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppEnvironment.swift@@ -120,7 +120,10 @@ public enum AppEnvironment {devices: devices,presence: fixtures ? FixturePresence() : LivePresence(),loginItem: fixtures ? fixtureLoginItem(env["CUA_SPACES_LOGIN_ITEM"]) : MainAppLoginItem(),- startup: startup)+ startup: startup,+ // Fixtures (UI tests, captures) keep the classic UI+ // unless they turn the New UI on.+ appVersion: fixtures ? nil : info.version)if !fixtures {LiveLocalNetworkPermission().request()// Signed out is nil (setup signs in first); anything else (no@@ -165,10 +168,7 @@ public enum AppEnvironment {: SparkleUpdater.start(channels: appAboutAllowedChannels(channel: channel))model.updates = UpdatesModel(updater: updater, channel: channel)model.updates.telemetry = telemetry- model.updates.saveChannel = { [weak model] channel in- model?.settings.updateChannel = channel- model?.saveSettings()- }+ model.updates.saveChannel = { [weak model] channel in model?.setUpdateChannel(channel) }// End-to-end runs: check now, with no window unless one is found.if env["CUA_SPACES_UPDATE_CHECK"] == "background", let sparkle = updater as? SparkleUpdater {sparkle.checkInBackground()diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swiftindex 11e1b0dbac..d7306e3467 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift@@ -147,6 +147,10 @@ public final class AppModel {public let dropTargets = SidebarDropTargets()public var settings: AppSettingslet settingsPath: String+ /// The running app's version: with it, the New UI's default follows+ /// the update channel and the version (`appSettingsResolveNewUi`);+ /// without it (tests, fixtures), the New UI is on only by choice.+ let appVersion: String?/// Settings → About and the updater (none until `AppEnvironment`/// starts one).public var updates = UpdatesModel(updater: nil)@@ -157,7 +161,7 @@ public final class AppModel {telemetry: TelemetryRunning? = nil, agentSetup: AgentSetupRunning? = nil,billing: BillingRunning? = nil, devices: DevicesRunning? = nil,presence: PresenceChecking = LivePresence(), loginItem: LoginItemControlling? = nil,- startup: StartupModel? = nil) {+ startup: StartupModel? = nil, appVersion: String? = nil) {self.backend = backendself.startup = startup ?? StartupModel()self.devices = DevicesModel(devices: devices, presence: presence)@@ -177,7 +181,9 @@ public final class AppModel {self.keyvault = keyvaultself.onboarding = onboardingself.settingsPath = settingsPath- let settings = appSettingsLoad(path: settingsPath)+ self.appVersion = appVersion+ var settings = appSettingsLoad(path: settingsPath)+ if let appVersion { settings = appSettingsResolveNewUi(settings: settings, version: appVersion) }self.settings = settingsself.wizard = WizardModel(env: AppWizardEnv(defaultLocation: settings.defaultLocation, cloudAvailable: false,@@ -1208,14 +1214,33 @@ public final class AppModel {/// A switch in Settings, Experiments: saved, recorded, and followed by/// the first run and an open New Space. Off hides; nothing is undone.+ /// The New UI's switch ("Use classic UI") also saves the user's choice,+ /// which later launches keep whatever the default becomes.public func chooseExperiment(row: String, option: String) {let before = settings.experiments- let after = appExperimentsChoose(experiments: before, row: row, option: option)- let signals = appTelemetryExperimentsChanged(before: before, after: after)- guard !signals.isEmpty else { return }- settings.experiments = after+ let next = appSettingsChooseExperiment(settings: settings, row: row, option: option)+ guard next != settings else { return }+ settings = next+ let after = next.experimentssaveSettings()- telemetry?.record(signals)+ telemetry?.record(appTelemetryExperimentsChanged(before: before, after: after))+ applyExperiments(before: before, after: after)+ }++ /// Settings → About's channel, saved; with no choice of the user's, the+ /// New UI follows the channel's default at once.+ public func setUpdateChannel(_ channel: AppUpdateChannel) {+ settings.updateChannel = channel+ let before = settings.experiments+ if let appVersion { settings = appSettingsResolveNewUi(settings: settings, version: appVersion) }+ saveSettings()+ if settings.experiments != before { applyExperiments(before: before, after: settings.experiments) }+ }++ /// What follows a change of the switches: the first run, an open New+ /// Space, and the New UI's window in place of the native one (or back).+ private func applyExperiments(before: AppExperiments, after: AppExperiments) {+ guard before != after else { return }onboarding.send(.experimentsLoaded(experiments: after))// New UI on: its window takes the native one's place; off: the reverse.if !before.webUi, after.webUi { openWebUI?() }diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/UpdateRefresh.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/UpdateRefresh.swiftindex e34e91a66d..08044089dd 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/UpdateRefresh.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/UpdateRefresh.swift@@ -110,6 +110,10 @@ public struct UpdateRefresh: Sendable {let plan = appAboutAfterLaunch(input: AppLaunchInput(lastSeen: settings.lastSeenVersion, version: version, build: build, onboarded: onboarded))if let save = plan.save {+ // An install's first launch: a beta's starts on the Beta channel.+ if settings.lastSeenVersion == nil {+ settings.updateChannel = appSettingsFirstLaunchChannel(channel: settings.updateChannel, version: version)+ }settings.lastSeenVersion = savetry? appSettingsSave(path: settingsPath, settings: settings)}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swiftindex 3082a0104e..013063959b 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swift@@ -242,4 +242,105 @@ struct MainUIRouteTests {m.chooseExperiment(row: "experiment:web_ui", option: "off")#expect(calls == ["open", "close"])}++ /// An app at `version` over the settings file `json` in a fresh+ /// directory (nil: none, a fresh install).+ func launched(_ json: String?, version: String, dir: URL? = nil) -> AppModel {+ let dir = dir ?? FileManager.default.temporaryDirectory.appendingPathComponent("cua-newui-\(UUID().uuidString)")+ try? FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)+ let path = dir.appendingPathComponent("settings.json").path+ if let json { FileManager.default.createFile(atPath: path, contents: Data(json.utf8)) }+ return AppModel(backend: FixtureSpacesBackend(), keyvault: KeyvaultModel(client: nil),+ onboarding: OnboardingModel(statePath: dir.appendingPathComponent("onboarding.json").path),+ settingsPath: path, telemetry: FixtureTelemetry(), appVersion: version)+ }++ /// The New UI by default: an upgraded install's saved `webUi: false`+ /// was never a choice, so Beta from the 0.8.1 betas opens the New UI; a+ /// saved `true` is kept; Stable keeps classic until 0.8.1 (0.8.0 shipped+ /// without the default).+ @Test func theNewUIIsTheDefaultOnBetaAndAnOlderSavedOffIsNotAChoice() {+ let old = #"{"updateChannel":"beta","experiments":{"cuaVolume":true,"webUi":false}}"#+ #expect(launched(old, version: "0.8.1-beta.1").settings.experiments.webUi)+ #expect(!launched(old, version: "0.8.0").settings.experiments.webUi)+ #expect(launched(old, version: "0.8.1-beta.1").settings.newUi == nil)+ let stable = #"{"updateChannel":"stable","experiments":{"webUi":false}}"#+ #expect(!launched(stable, version: "0.8.1-beta.1").settings.experiments.webUi)+ #expect(!launched(stable, version: "0.7.2").settings.experiments.webUi)+ #expect(!launched(stable, version: "0.8.0").settings.experiments.webUi)+ #expect(launched(stable, version: "0.8.1").settings.experiments.webUi)+ let chosen = #"{"updateChannel":"stable","experiments":{"webUi":true}}"#+ #expect(launched(chosen, version: "0.7.2").settings.newUi == true)+ #expect(launched(chosen, version: "0.7.2").settings.experiments.webUi)+ // A fresh install (no file): Stable until the first launch records Beta.+ #expect(!launched(nil, version: "0.8.1-beta.1").settings.experiments.webUi)+ }++ /// "Use classic UI" swaps the windows in place, is saved as a choice,+ /// and later launches (and later versions) keep it.+ @Test func useClassicUIIsAChoiceLaterLaunchesKeep() {+ let dir = FileManager.default.temporaryDirectory.appendingPathComponent("cua-newui-\(UUID().uuidString)")+ let m = launched(#"{"updateChannel":"beta"}"#, version: "0.8.1-beta.1", dir: dir)+ #expect(m.settings.experiments.webUi)+ var calls: [String] = []+ m.openWebUI = { calls.append("open") }+ m.closeWebUI = { calls.append("close") }+ let classic = m.experimentsPage.sections.flatMap(\.rows).first { $0.id == "experiment:classic_ui" }+ #expect(classic?.label == "Use classic UI")+ #expect(classic?.options.first { $0.active }?.id == "off")+ m.chooseExperiment(row: "experiment:classic_ui", option: "on")+ #expect(calls == ["close"])+ #expect(!m.settings.experiments.webUi)+ #expect(appSettingsLoad(path: m.settingsPath).newUi == false, "saved as a choice")+ for version in ["0.8.1-beta.1", "0.8.1-beta.2", "0.8.1"] {+ #expect(!launched(nil, version: version, dir: dir).settings.experiments.webUi, "\(version)")+ }+ // And back: the New UI, chosen.+ let again = launched(nil, version: "0.8.1-beta.2", dir: dir)+ again.openWebUI = { calls.append("open") }+ again.chooseExperiment(row: "experiment:classic_ui", option: "off")+ #expect(calls == ["close", "open"])+ #expect(appSettingsLoad(path: again.settingsPath).newUi == true)+ }++ /// Settings → About's channel moves the default (and the window) when+ /// the user never chose; a choice stays put.+ @Test func switchingChannelMovesTheDefaultNotAChoice() {+ let m = launched(#"{"updateChannel":"beta"}"#, version: "0.8.1-beta.1")+ var calls: [String] = []+ m.openWebUI = { calls.append("open") }+ m.closeWebUI = { calls.append("close") }+ m.setUpdateChannel(.stable)+ #expect(!m.settings.experiments.webUi)+ #expect(appSettingsLoad(path: m.settingsPath).updateChannel == .stable)+ m.setUpdateChannel(.beta)+ #expect(m.settings.experiments.webUi)+ #expect(calls == ["close", "open"])+ m.chooseExperiment(row: "experiment:classic_ui", option: "on")+ calls = []+ m.setUpdateChannel(.stable)+ m.setUpdateChannel(.beta)+ #expect(!m.settings.experiments.webUi)+ #expect(calls.isEmpty)+ }++ /// A prerelease's first launch starts on the Beta channel (and so+ /// with the New UI); a release's on Stable; a later launch keeps the channel.+ @Test func aBetasFirstLaunchIsOnBeta() {+ let dir = FileManager.default.temporaryDirectory.appendingPathComponent("cua-newui-\(UUID().uuidString)")+ try? FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)+ let path = dir.appendingPathComponent("settings.json").path+ UpdateRefresh.record(settingsPath: path, version: "0.8.1-beta.1", build: "1", onboarded: false)+ #expect(appSettingsLoad(path: path).updateChannel == .beta)+ #expect(launched(nil, version: "0.8.1-beta.1", dir: dir).settings.experiments.webUi)+ // A later launch keeps the channel the user set.+ var s = appSettingsLoad(path: path)+ s.updateChannel = .stable+ try? appSettingsSave(path: path, settings: s)+ UpdateRefresh.record(settingsPath: path, version: "0.8.1-beta.2", build: "2", onboarded: true)+ #expect(appSettingsLoad(path: path).updateChannel == .stable)+ let release = FileManager.default.temporaryDirectory.appendingPathComponent("cua-newui-\(UUID().uuidString)/settings.json").path+ UpdateRefresh.record(settingsPath: release, version: "0.7.2", build: "1", onboarded: false)+ #expect(appSettingsLoad(path: release).updateChannel == .stable)+ }}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swiftindex d4683540f4..be2ae231e3 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift@@ -402,8 +402,11 @@ struct ViewModelTests {let model = makeModel(telemetry: telemetry)let toggles = model.experimentsPage.sections.flatMap(\.rows).filter { $0.kind == .toggle }#expect(toggles.map(\.id) == ["experiment:cua_volume", "experiment:your_cloud", "experiment:sharing",- "experiment:web_ui"])- #expect(toggles.allSatisfy { $0.options.first { $0.id == "off" }?.active == true })+ "experiment:classic_ui"])+ // Off, the New UI shows as "Use classic UI" on (tests run with no app version: no default).+ #expect(toggles.allSatisfy { r in+ r.options.first { $0.id == (r.id == "experiment:classic_ui" ? "on" : "off") }?.active == true+ })#expect(!model.settingsPageWithStorage.sections.map(\.id).contains("storage"))model.chooseExperiment(row: "experiment:cua_volume", option: "on")#expect(model.settingsPageWithStorage.sections.map(\.id).prefix(3) == ["account", "general", "storage"])diff --git a/apps/cua-spaces-web/src/__tests__/electron-parity-lows.test.tsx b/apps/cua-spaces-web/src/__tests__/electron-parity-lows.test.tsxindex 0d9b0d7d86..7b0fb2a7b4 100644--- a/apps/cua-spaces-web/src/__tests__/electron-parity-lows.test.tsx+++ b/apps/cua-spaces-web/src/__tests__/electron-parity-lows.test.tsx@@ -45,14 +45,14 @@ async function mount(path: string, mode: DataAdapter["mode"] = "demo") {const q = (sel: string) => document.querySelector<HTMLElement>(sel);describe.skipIf(!wasmBuilt)("Electron parity, the small things", () => {- it("has no New UI (preview) switch in Electron (it is that UI); the SwiftUI host keeps it", { timeout: 20_000 }, async () => {+ it("has no Use classic UI switch in Electron (it is only the New UI); the SwiftUI host keeps it", { timeout: 20_000 }, async () => {await mount("/settings/experiments", "electron");await waitFor(() => expect(q("[data-settings-section]")).not.toBeNull(), { timeout: 8000 });- expect(q('[data-setting-row="experiment:web_ui"]')).toBeNull();+ expect(q('[data-setting-row="experiment:classic_ui"]')).toBeNull();expect(document.querySelectorAll("[data-setting-row^='experiment:']").length).toBeGreaterThan(0);cleanup();await mount("/settings/experiments", "demo");- await waitFor(() => expect(q('[data-setting-row="experiment:web_ui"]')).not.toBeNull(), { timeout: 8000 });+ await waitFor(() => expect(q('[data-setting-row="experiment:classic_ui"]')).not.toBeNull(), { timeout: 8000 });});it("opens and closes New Space's image list from its Show images button", { timeout: 20_000 }, async () => {diff --git a/apps/cua-spaces-web/src/routes/settings/experiments.tsx b/apps/cua-spaces-web/src/routes/settings/experiments.tsxindex 3ce8fa631e..f72d87c99d 100644--- a/apps/cua-spaces-web/src/routes/settings/experiments.tsx+++ b/apps/cua-spaces-web/src/routes/settings/experiments.tsx@@ -9,12 +9,12 @@ import { toastError } from "@/components/ui/toast";export const Route = createFileRoute("/settings/experiments")({ component: ExperimentsPage });-/** "New UI (preview)" opens the SwiftUI app's web window: the Electron app is that UI, so it has no such switch. */-const WEB_UI_ROWS = new Set(["experiment:web_ui", "experiment:web_ui-note"]);+/** "Use classic UI" switches the SwiftUI app between its native window and this UI: the Electron app is only this UI, so it has no such switch. */+const WEB_UI_ROWS = new Set(["experiment:classic_ui", "experiment:classic_ui-note", "experiment:web_ui", "experiment:web_ui-note"]);/**- * Settings, Experiments: one switch per experiment with its one line, all- * off until turned on (`experiments::page`). Off only hides an experiment's+ * Settings, Experiments: one switch per experiment with its one line+ * (`experiments::page`), and "Use classic UI" on the Mac. Off only hides an experiment's* entry points; nothing set up is undone.*/function ExperimentsPage() {diff --git a/docs/content/docs/cua-sdk/reference/index.mdx b/docs/content/docs/cua-sdk/reference/index.mdxindex 9917a12d18..44cdbea335 100644--- a/docs/content/docs/cua-sdk/reference/index.mdx+++ b/docs/content/docs/cua-sdk/reference/index.mdx@@ -142,4 +142,4 @@ Pages marked *Cua Spaces app export* document the APIs the Cua Spaces apps are b291 items, 385 methods. The [Types](/cua-sdk/reference/types) page lists them.-The Cua Spaces app export adds 756 items and 38 methods.+The Cua Spaces app export adds 759 items and 38 methods.diff --git a/docs/content/docs/cua-sdk/reference/spaces/agents-app-core.mdx b/docs/content/docs/cua-sdk/reference/spaces/agents-app-core.mdxindex e2fc3fcf9b..ea2b5aaf50 100644--- a/docs/content/docs/cua-sdk/reference/spaces/agents-app-core.mdx+++ b/docs/content/docs/cua-sdk/reference/spaces/agents-app-core.mdx@@ -1022,6 +1022,6 @@ pub fn app_notifications_view(feed: Vec<AppNotificationInput>, now_ms: u64) -> A## All items-47 items, across this page and its subpages, grouped by page. Methods are listed on their object.+47 items, across this page and its subpages, grouped by page (each item's section is on its page). Methods are listed on their object.**App core: agents, drive, notifications**: [`app_agent_rows`](#app_agent_rows), [`app_agent_status_label`](#app_agent_status_label), [`app_agent_subtitle`](#app_agent_subtitle), [`app_agents_action_from_json`](#app_agents_action_from_json), [`app_agents_initial`](#app_agents_initial), [`app_agents_input_from_json`](#app_agents_input_from_json), [`app_agents_reduce`](#app_agents_reduce), [`app_agents_view`](#app_agents_view), [`app_drive_action_from_json`](#app_drive_action_from_json), [`app_drive_initial`](#app_drive_initial), [`app_drive_input_from_json`](#app_drive_input_from_json), [`app_drive_reduce`](#app_drive_reduce), [`app_drive_view`](#app_drive_view), [`app_notifications_from_json`](#app_notifications_from_json), [`app_notifications_plan`](#app_notifications_plan), [`app_notifications_view`](#app_notifications_view), [`AppAccessAuditInput`](#appaccessauditinput-record), [`AppAgentDetailView`](#appagentdetailview-record), [`AppAgentRowView`](#appagentrowview-record), [`AppAgentsAction`](#appagentsaction-enum), [`AppAgentsInput`](#appagentsinput-record), [`AppAgentsRequest`](#appagentsrequest-enum), [`AppAgentsState`](#appagentsstate-record), [`AppAgentsView`](#appagentsview-record), [`AppAgentTab`](#appagenttab-enum), [`AppComputerGrantInput`](#appcomputergrantinput-record), [`AppDriveAction`](#appdriveaction-enum), [`AppDriveEntryInput`](#appdriveentryinput-record), [`AppDriveGrantInput`](#appdrivegrantinput-record), [`AppDriveInput`](#appdriveinput-record), [`AppDriveRequest`](#appdriverequest-enum), [`AppDriveRequestInput`](#appdriverequestinput-record), [`AppDriveState`](#appdrivestate-record), [`AppDriveView`](#appdriveview-record), [`AppFileVersionInput`](#appfileversioninput-record), [`AppFileView`](#appfileview-record), [`AppLineView`](#applineview-record), [`AppNotificationInput`](#appnotificationinput-record), [`AppNotificationsPlan`](#appnotificationsplan-record), [`AppNotificationsView`](#appnotificationsview-record), [`AppOpenFileInput`](#appopenfileinput-record), [`AppPersistentAgentInput`](#apppersistentagentinput-record), [`AppRoutineForm`](#approutineform-record), [`AppRoutineInput`](#approutineinput-record), [`AppRoutineScheduleKind`](#approutineschedulekind-enum), [`AppSystemNote`](#appsystemnote-record), [`AppTabView`](#apptabview-record)diff --git a/docs/content/docs/cua-sdk/reference/spaces/app-core/experiments.mdx b/docs/content/docs/cua-sdk/reference/spaces/app-core/experiments.mdxindex 348df0dc2b..fce3a76a4d 100644--- a/docs/content/docs/cua-sdk/reference/spaces/app-core/experiments.mdx+++ b/docs/content/docs/cua-sdk/reference/spaces/app-core/experiments.mdx@@ -17,7 +17,7 @@ import { Tab, Tabs } from 'fumadocs-ui/components/tabs';These APIs are part of the Cua Spaces app export for building Spaces UIs. They are source-available under FSL-1.1-MIT and ship for Swift only (`import CuaSpacesFFI`); the Rust tab shows the `cua-spaces-ffi` crate they come from. The open source SDK packages for Python, TypeScript and Kotlin do not include them.</Callout>-`app_experiments_page` derives the Experiments tab from the saved `AppExperiments`; `app_experiments_choose` applies a switch. Off only hides a feature: a mounted Volume, a connected cloud and existing shares stay as they are.+`app_experiments_page` derives the Experiments tab from the saved `AppExperiments`; `app_settings_choose_experiment` applies a switch and saves the New UI choice ("Use classic UI"). `app_settings_resolve_new_ui` applies the New UI default for the update channel and version. Off only hides a feature: a mounted Volume, a connected cloud and existing shares stay as they are.## `app_experiments_from_json`@@ -76,6 +76,95 @@ pub fn app_settings_with_storage(page: AppSettingsPage, storage: AppSettingsSect**Returns** [`AppSettingsPage`](/cua-sdk/reference/spaces/app-core/window#appsettingspage-record)+## `app_settings_resolve_new_ui`++The settings with the New UI as a launch of `version` shows it: the+user's choice, else the default for the update channel and version+(again after the channel changes).++<Tabs items={['Swift', 'Rust']} groupId="sdk-lang" persist>+<Tab value="Swift">++```swift+func appSettingsResolveNewUi(settings: AppSettings, version: String) -> AppSettings+```++</Tab>+<Tab value="Rust">++```rust+pub fn app_settings_resolve_new_ui(settings: AppSettings, version: String) -> AppSettings+```++</Tab>+</Tabs>++| Parameter | Type | Default |+| --- | --- | --- |+| `settings` | [`AppSettings`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appsettings-record) | required |+| `version` | `String` | required |++**Returns** [`AppSettings`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appsettings-record)++## `app_settings_first_launch_channel`++The update channel of an install's first launch, from the file's+`channel`: Beta for a prerelease, else unchanged.++<Tabs items={['Swift', 'Rust']} groupId="sdk-lang" persist>+<Tab value="Swift">++```swift+func appSettingsFirstLaunchChannel(channel: AppUpdateChannel, version: String) -> AppUpdateChannel+```++</Tab>+<Tab value="Rust">++```rust+pub fn app_settings_first_launch_channel(channel: AppUpdateChannel, version: String) -> AppUpdateChannel+```++</Tab>+</Tabs>++| Parameter | Type | Default |+| --- | --- | --- |+| `channel` | [`AppUpdateChannel`](/cua-sdk/reference/spaces/app-core/about#appupdatechannel-enum) | required |+| `version` | `String` | required |++**Returns** [`AppUpdateChannel`](/cua-sdk/reference/spaces/app-core/about#appupdatechannel-enum)++## `app_settings_choose_experiment`++The settings after a Settings, Experiments row's choice (the switches,+and the New UI's "Use classic UI" saved as the user's choice).++<Tabs items={['Swift', 'Rust']} groupId="sdk-lang" persist>+<Tab value="Swift">++```swift+func appSettingsChooseExperiment(settings: AppSettings, row: String, option: String) -> AppSettings+```++</Tab>+<Tab value="Rust">++```rust+pub fn app_settings_choose_experiment(settings: AppSettings, row: String, option: String) -> AppSettings+```++</Tab>+</Tabs>++| Parameter | Type | Default |+| --- | --- | --- |+| `settings` | [`AppSettings`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appsettings-record) | required |+| `row` | `String` | required |+| `option` | `String` | required |++**Returns** [`AppSettings`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appsettings-record)+## `app_telemetry_experiments_changed`The events of a change in Settings, Experiments (call with the switches@@ -141,7 +230,7 @@ Returned by [`app_experiments_choose`](#app_experiments_choose), [`app_experimen| `cua_volume` / `cuaVolume` | `bool` | | Cua Volume in the first run and Settings, Storage. || `your_cloud` / `yourCloud` | `bool` | | Your own clouds in the New Space wizard. || `sharing` | `bool` | | Sharing a Space with other accounts. |-| `web_ui` / `webUi` | `bool` | | The shared web UI, previewed in its own window. |+| `web_ui` / `webUi` | `bool` | | The New UI (the shared web UI) is the main window: the user's choice or, without one, `new_ui_default` (`crate.settings.resolve_new_ui`). |## `app_experiments_choose`diff --git a/docs/content/docs/cua-sdk/reference/spaces/app-core/index.mdx b/docs/content/docs/cua-sdk/reference/spaces/app-core/index.mdxindex b53a82f8fa..92f06deaf2 100644--- a/docs/content/docs/cua-sdk/reference/spaces/app-core/index.mdx+++ b/docs/content/docs/cua-sdk/reference/spaces/app-core/index.mdx@@ -45,62 +45,62 @@ pub fn cua_spaces_register()## All items-627 items, across this page and its subpages, grouped by page. Methods are listed on their object.+630 items, across this page and its subpages, grouped by page (each item's section is on its page). Methods are listed on their object.-**About, updates and launch**: [`app_about_after_launch`](/cua-sdk/reference/spaces/app-core/about#app_about_after_launch), [`app_about_allowed_channels`](/cua-sdk/reference/spaces/app-core/about#app_about_allowed_channels), [`app_about_input_from_json`](/cua-sdk/reference/spaces/app-core/about#app_about_input_from_json), [`app_about_refresh_notice`](/cua-sdk/reference/spaces/app-core/about#app_about_refresh_notice), [`app_about_restart_daemon`](/cua-sdk/reference/spaces/app-core/about#app_about_restart_daemon), [`app_about_view`](/cua-sdk/reference/spaces/app-core/about#app_about_view), [`app_daemon_check_from_json`](/cua-sdk/reference/spaces/app-core/about#app_daemon_check_from_json), [`app_launch_input_from_json`](/cua-sdk/reference/spaces/app-core/about#app_launch_input_from_json), [`app_refresh_report_from_json`](/cua-sdk/reference/spaces/app-core/about#app_refresh_report_from_json), [`AppAboutInput`](/cua-sdk/reference/spaces/app-core/about#appaboutinput-record), [`AppAboutLink`](/cua-sdk/reference/spaces/app-core/about#appaboutlink-record), [`AppAboutLinkId`](/cua-sdk/reference/spaces/app-core/about#appaboutlinkid-enum), [`AppAboutUpdates`](/cua-sdk/reference/spaces/app-core/about#appaboutupdates-record), [`AppAboutView`](/cua-sdk/reference/spaces/app-core/about#appaboutview-record), [`AppCliInstaller`](/cua-sdk/reference/spaces/app-core/about#appcliinstaller), [`AppCliInstallPlan`](/cua-sdk/reference/spaces/app-core/about#appcliinstallplan-record), [`AppCliInstallRequest`](/cua-sdk/reference/spaces/app-core/about#appcliinstallrequest-record), [`AppDaemonCheck`](/cua-sdk/reference/spaces/app-core/about#appdaemoncheck-record), [`AppInstallMethod`](/cua-sdk/reference/spaces/app-core/about#appinstallmethod-enum), [`AppLaunchInput`](/cua-sdk/reference/spaces/app-core/about#applaunchinput-record), [`AppLaunchPlan`](/cua-sdk/reference/spaces/app-core/about#applaunchplan-record), [`AppRefreshReport`](/cua-sdk/reference/spaces/app-core/about#apprefreshreport-record), [`AppUpdateChannel`](/cua-sdk/reference/spaces/app-core/about#appupdatechannel-enum)+**[About, updates and launch](/cua-sdk/reference/spaces/app-core/about)**: `app_about_after_launch`, `app_about_allowed_channels`, `app_about_input_from_json`, `app_about_refresh_notice`, `app_about_restart_daemon`, `app_about_view`, `app_daemon_check_from_json`, `app_launch_input_from_json`, `app_refresh_report_from_json`, `AppAboutInput`, `AppAboutLink`, `AppAboutLinkId`, `AppAboutUpdates`, `AppAboutView`, `AppCliInstaller`, `AppCliInstallPlan`, `AppCliInstallRequest`, `AppDaemonCheck`, `AppInstallMethod`, `AppLaunchInput`, `AppLaunchPlan`, `AppRefreshReport`, `AppUpdateChannel`-**Settings, Agents**: [`app_agent_key_form`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_key_form), [`app_agent_key_form_input_from_json`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_key_form_input_from_json), [`app_agent_key_name_problem`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_key_name_problem), [`app_agent_key_remove_confirm`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_key_remove_confirm), [`app_agent_keys_input_from_json`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_keys_input_from_json), [`app_agent_keys_view`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_keys_view), [`app_agent_settings_rows`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_settings_rows), [`app_agent_setup_outcome`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_setup_outcome), [`app_agent_setup_outcomes_from_json`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_setup_outcomes_from_json), [`app_agent_setup_status`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_setup_status), [`app_agent_setup_statuses_from_json`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_setup_statuses_from_json), [`app_agent_setup_summary`](/cua-sdk/reference/spaces/app-core/agent-keys#app_agent_setup_summary), [`AppAgentKeyConfirm`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeyconfirm-record), [`AppAgentKeyFormInput`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeyforminput-record), [`AppAgentKeyFormView`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeyformview-record), [`AppAgentKeyInput`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeyinput-record), [`AppAgentKeyRow`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeyrow-record), [`AppAgentKeysInput`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeysinput-record), [`AppAgentKeysView`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentkeysview-record), [`AppAgentSettingsRow`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentsettingsrow-record), [`AppAgentSetupOutcomeInput`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentsetupoutcomeinput-record), [`AppAgentSetupStatus`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentsetupstatus-record), [`AppAgentSetupSummary`](/cua-sdk/reference/spaces/app-core/agent-keys#appagentsetupsummary-record)+**[Settings, Agents](/cua-sdk/reference/spaces/app-core/agent-keys)**: `app_agent_key_form`, `app_agent_key_form_input_from_json`, `app_agent_key_name_problem`, `app_agent_key_remove_confirm`, `app_agent_keys_input_from_json`, `app_agent_keys_view`, `app_agent_settings_rows`, `app_agent_setup_outcome`, `app_agent_setup_outcomes_from_json`, `app_agent_setup_status`, `app_agent_setup_statuses_from_json`, `app_agent_setup_summary`, `AppAgentKeyConfirm`, `AppAgentKeyFormInput`, `AppAgentKeyFormView`, `AppAgentKeyInput`, `AppAgentKeyRow`, `AppAgentKeysInput`, `AppAgentKeysView`, `AppAgentSettingsRow`, `AppAgentSetupOutcomeInput`, `AppAgentSetupStatus`, `AppAgentSetupSummary`-**Spaces**: [`app_agent_name`](/cua-sdk/reference/spaces/app-core/spaces#app_agent_name), [`app_ambient_dots`](/cua-sdk/reference/spaces/app-core/spaces#app_ambient_dots), [`app_group_windows_by_app`](/cua-sdk/reference/spaces/app-core/spaces#app_group_windows_by_app), [`app_hosted_rows`](/cua-sdk/reference/spaces/app-core/spaces#app_hosted_rows), [`app_roster_initial`](/cua-sdk/reference/spaces/app-core/spaces#app_roster_initial), [`app_roster_reduce`](/cua-sdk/reference/spaces/app-core/spaces#app_roster_reduce), [`app_rows_to_spaces`](/cua-sdk/reference/spaces/app-core/spaces#app_rows_to_spaces), [`app_sidebar`](/cua-sdk/reference/spaces/app-core/spaces#app_sidebar), [`app_space_accepts_drop`](/cua-sdk/reference/spaces/app-core/spaces#app_space_accepts_drop), [`app_space_detail`](/cua-sdk/reference/spaces/app-core/spaces#app_space_detail), [`app_space_detail_for`](/cua-sdk/reference/spaces/app-core/spaces#app_space_detail_for), [`app_space_detail_with`](/cua-sdk/reference/spaces/app-core/spaces#app_space_detail_with), [`app_space_rows_from_json`](/cua-sdk/reference/spaces/app-core/spaces#app_space_rows_from_json), [`app_spaces_from_json`](/cua-sdk/reference/spaces/app-core/spaces#app_spaces_from_json), [`app_status_line`](/cua-sdk/reference/spaces/app-core/spaces#app_status_line), [`app_this_machine_space`](/cua-sdk/reference/spaces/app-core/spaces#app_this_machine_space), [`app_without_this_relay_machine`](/cua-sdk/reference/spaces/app-core/spaces#app_without_this_relay_machine), [`AppAgentStatus`](/cua-sdk/reference/spaces/app-core/spaces#appagentstatus-enum), [`AppAmbientDots`](/cua-sdk/reference/spaces/app-core/spaces#appambientdots-record), [`AppFactWarning`](/cua-sdk/reference/spaces/app-core/spaces#appfactwarning-record), [`AppHostSummaryInput`](/cua-sdk/reference/spaces/app-core/spaces#apphostsummaryinput-record), [`AppNewSpaceOn`](/cua-sdk/reference/spaces/app-core/spaces#appnewspaceon-record), [`AppNotice`](/cua-sdk/reference/spaces/app-core/spaces#appnotice-record), [`AppNoticeKind`](/cua-sdk/reference/spaces/app-core/spaces#appnoticekind-enum), [`AppOpenApp`](/cua-sdk/reference/spaces/app-core/spaces#appopenapp-record), [`AppOpenWindow`](/cua-sdk/reference/spaces/app-core/spaces#appopenwindow-record), [`AppRemoteWindow`](/cua-sdk/reference/spaces/app-core/spaces#appremotewindow-record), [`AppRemoteWindowGroup`](/cua-sdk/reference/spaces/app-core/spaces#appremotewindowgroup-record), [`AppRosterAction`](/cua-sdk/reference/spaces/app-core/spaces#approsteraction-enum), [`AppRosterState`](/cua-sdk/reference/spaces/app-core/spaces#approsterstate-record), [`AppSidebarRow`](/cua-sdk/reference/spaces/app-core/spaces#appsidebarrow-record), [`AppSidebarSection`](/cua-sdk/reference/spaces/app-core/spaces#appsidebarsection-record), [`AppSidebarView`](/cua-sdk/reference/spaces/app-core/spaces#appsidebarview-record), [`AppSpace`](/cua-sdk/reference/spaces/app-core/spaces#appspace-record), [`AppSpaceAgentRun`](/cua-sdk/reference/spaces/app-core/spaces#appspaceagentrun-record), [`AppSpaceDetail`](/cua-sdk/reference/spaces/app-core/spaces#appspacedetail-record), [`AppSpaceKind`](/cua-sdk/reference/spaces/app-core/spaces#appspacekind-enum), [`AppSpaceOs`](/cua-sdk/reference/spaces/app-core/spaces#appspaceos-enum), [`AppSpaceProgress`](/cua-sdk/reference/spaces/app-core/spaces#appspaceprogress-record), [`AppSpaceProvider`](/cua-sdk/reference/spaces/app-core/spaces#appspaceprovider-enum), [`AppSpaceRow`](/cua-sdk/reference/spaces/app-core/spaces#appspacerow-record), [`AppSpaceSdkRef`](/cua-sdk/reference/spaces/app-core/spaces#appspacesdkref-record), [`AppSpaceStatus`](/cua-sdk/reference/spaces/app-core/spaces#appspacestatus-enum), [`AppThumbnailScene`](/cua-sdk/reference/spaces/app-core/spaces#appthumbnailscene-enum), [`AppWindowMode`](/cua-sdk/reference/spaces/app-core/spaces#appwindowmode-enum)+**[Spaces](/cua-sdk/reference/spaces/app-core/spaces)**: `app_agent_name`, `app_ambient_dots`, `app_group_windows_by_app`, `app_hosted_rows`, `app_roster_initial`, `app_roster_reduce`, `app_rows_to_spaces`, `app_sidebar`, `app_space_accepts_drop`, `app_space_detail`, `app_space_detail_for`, `app_space_detail_with`, `app_space_rows_from_json`, `app_spaces_from_json`, `app_status_line`, `app_this_machine_space`, `app_without_this_relay_machine`, `AppAgentStatus`, `AppAmbientDots`, `AppFactWarning`, `AppHostSummaryInput`, `AppNewSpaceOn`, `AppNotice`, `AppNoticeKind`, `AppOpenApp`, `AppOpenWindow`, `AppRemoteWindow`, `AppRemoteWindowGroup`, `AppRosterAction`, `AppRosterState`, `AppSidebarRow`, `AppSidebarSection`, `AppSidebarView`, `AppSpace`, `AppSpaceAgentRun`, `AppSpaceDetail`, `AppSpaceKind`, `AppSpaceOs`, `AppSpaceProgress`, `AppSpaceProvider`, `AppSpaceRow`, `AppSpaceSdkRef`, `AppSpaceStatus`, `AppThumbnailScene`, `AppWindowMode`-**Devices**: [`app_approve_open`](/cua-sdk/reference/spaces/app-core/devices#app_approve_open), [`app_approve_reduce`](/cua-sdk/reference/spaces/app-core/devices#app_approve_reduce), [`app_approve_sheet_action_from_json`](/cua-sdk/reference/spaces/app-core/devices#app_approve_sheet_action_from_json), [`app_approve_view`](/cua-sdk/reference/spaces/app-core/devices#app_approve_view), [`app_confirm_presence`](/cua-sdk/reference/spaces/app-core/devices#app_confirm_presence), [`app_devices_clean_name`](/cua-sdk/reference/spaces/app-core/devices#app_devices_clean_name), [`app_devices_input`](/cua-sdk/reference/spaces/app-core/devices#app_devices_input), [`app_devices_input_from_json`](/cua-sdk/reference/spaces/app-core/devices#app_devices_input_from_json), [`app_devices_view`](/cua-sdk/reference/spaces/app-core/devices#app_devices_view), [`app_enroll_action_from_json`](/cua-sdk/reference/spaces/app-core/devices#app_enroll_action_from_json), [`app_enroll_initial`](/cua-sdk/reference/spaces/app-core/devices#app_enroll_initial), [`app_enroll_reduce`](/cua-sdk/reference/spaces/app-core/devices#app_enroll_reduce), [`app_enroll_state_from_json`](/cua-sdk/reference/spaces/app-core/devices#app_enroll_state_from_json), [`app_enroll_view`](/cua-sdk/reference/spaces/app-core/devices#app_enroll_view), [`app_machine_access_notice`](/cua-sdk/reference/spaces/app-core/devices#app_machine_access_notice), [`AppActivityRow`](/cua-sdk/reference/spaces/app-core/devices#appactivityrow-record), [`AppApprovalPrompt`](/cua-sdk/reference/spaces/app-core/devices#appapprovalprompt-record), [`AppApproveRequest`](/cua-sdk/reference/spaces/app-core/devices#appapproverequest-record), [`AppApproveSheetAction`](/cua-sdk/reference/spaces/app-core/devices#appapprovesheetaction-enum), [`AppApproveSheetState`](/cua-sdk/reference/spaces/app-core/devices#appapprovesheetstate-record), [`AppApproveSheetView`](/cua-sdk/reference/spaces/app-core/devices#appapprovesheetview-record), [`AppAuditInput`](/cua-sdk/reference/spaces/app-core/devices#appauditinput-record), [`AppBannerTone`](/cua-sdk/reference/spaces/app-core/devices#appbannertone-enum), [`AppDeviceAction`](/cua-sdk/reference/spaces/app-core/devices#appdeviceaction-enum), [`AppDeviceBanner`](/cua-sdk/reference/spaces/app-core/devices#appdevicebanner-record), [`AppDeviceConfirm`](/cua-sdk/reference/spaces/app-core/devices#appdeviceconfirm-record), [`AppDeviceInput`](/cua-sdk/reference/spaces/app-core/devices#appdeviceinput-record), [`AppDeviceRow`](/cua-sdk/reference/spaces/app-core/devices#appdevicerow-record), [`AppDevicesInput`](/cua-sdk/reference/spaces/app-core/devices#appdevicesinput-record), [`AppDevicesLabels`](/cua-sdk/reference/spaces/app-core/devices#appdeviceslabels-record), [`AppDevicesView`](/cua-sdk/reference/spaces/app-core/devices#appdevicesview-record), [`AppEnrollAction`](/cua-sdk/reference/spaces/app-core/devices#appenrollaction-enum), [`AppEnrollmentKind`](/cua-sdk/reference/spaces/app-core/devices#appenrollmentkind-enum), [`AppEnrollMethod`](/cua-sdk/reference/spaces/app-core/devices#appenrollmethod-enum), [`AppEnrollOption`](/cua-sdk/reference/spaces/app-core/devices#appenrolloption-record), [`AppEnrollPhase`](/cua-sdk/reference/spaces/app-core/devices#appenrollphase-enum), [`AppEnrollState`](/cua-sdk/reference/spaces/app-core/devices#appenrollstate-record), [`AppEnrollView`](/cua-sdk/reference/spaces/app-core/devices#appenrollview-record), [`AppMachineAccessNotice`](/cua-sdk/reference/spaces/app-core/devices#appmachineaccessnotice-record), [`AppMachineInput`](/cua-sdk/reference/spaces/app-core/devices#appmachineinput-record), [`AppThisDevice`](/cua-sdk/reference/spaces/app-core/devices#appthisdevice-record), [`AppUnconfirmedMachine`](/cua-sdk/reference/spaces/app-core/devices#appunconfirmedmachine-record)+**[Devices](/cua-sdk/reference/spaces/app-core/devices)**: `app_approve_open`, `app_approve_reduce`, `app_approve_sheet_action_from_json`, `app_approve_view`, `app_confirm_presence`, `app_devices_clean_name`, `app_devices_input`, `app_devices_input_from_json`, `app_devices_view`, `app_enroll_action_from_json`, `app_enroll_initial`, `app_enroll_reduce`, `app_enroll_state_from_json`, `app_enroll_view`, `app_machine_access_notice`, `AppActivityRow`, `AppApprovalPrompt`, `AppApproveRequest`, `AppApproveSheetAction`, `AppApproveSheetState`, `AppApproveSheetView`, `AppAuditInput`, `AppBannerTone`, `AppDeviceAction`, `AppDeviceBanner`, `AppDeviceConfirm`, `AppDeviceInput`, `AppDeviceRow`, `AppDevicesInput`, `AppDevicesLabels`, `AppDevicesView`, `AppEnrollAction`, `AppEnrollmentKind`, `AppEnrollMethod`, `AppEnrollOption`, `AppEnrollPhase`, `AppEnrollState`, `AppEnrollView`, `AppMachineAccessNotice`, `AppMachineInput`, `AppThisDevice`, `AppUnconfirmedMachine`-**Cua Cloud billing**: [`app_billing_status`](/cua-sdk/reference/spaces/app-core/billing#app_billing_status), [`AppBillingCard`](/cua-sdk/reference/spaces/app-core/billing#appbillingcard-record), [`AppBillingCredit`](/cua-sdk/reference/spaces/app-core/billing#appbillingcredit-record), [`AppBillingStatus`](/cua-sdk/reference/spaces/app-core/billing#appbillingstatus-record), [`AppCreditNotice`](/cua-sdk/reference/spaces/app-core/billing#appcreditnotice-record)+**[Cua Cloud billing](/cua-sdk/reference/spaces/app-core/billing)**: `app_billing_status`, `AppBillingCard`, `AppBillingCredit`, `AppBillingStatus`, `AppCreditNotice`-**Teleport picker**: [`app_catalog_entries_from_json`](/cua-sdk/reference/spaces/app-core/teleport#app_catalog_entries_from_json), [`app_catalog_entry`](/cua-sdk/reference/spaces/app-core/teleport#app_catalog_entry), [`app_picker_can_plan`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_can_plan), [`app_picker_consent`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_consent), [`app_picker_initial`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_initial), [`app_picker_plan_sensitive`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_plan_sensitive), [`app_picker_primary`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_primary), [`app_picker_progress`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_progress), [`app_picker_reduce`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_reduce), [`app_picker_review`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_review), [`app_picker_sections`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_sections), [`app_picker_sensitive_options`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_sensitive_options), [`app_picker_status`](/cua-sdk/reference/spaces/app-core/teleport#app_picker_status), [`AppCatalogEntry`](/cua-sdk/reference/spaces/app-core/teleport#appcatalogentry-record), [`AppEntrySection`](/cua-sdk/reference/spaces/app-core/teleport#appentrysection-record), [`AppPickerAction`](/cua-sdk/reference/spaces/app-core/teleport#apppickeraction-enum), [`AppPickerEvent`](/cua-sdk/reference/spaces/app-core/teleport#apppickerevent-enum), [`AppPickerPrimary`](/cua-sdk/reference/spaces/app-core/teleport#apppickerprimary-record), [`AppPickerState`](/cua-sdk/reference/spaces/app-core/teleport#apppickerstate-record), [`AppPickerStep`](/cua-sdk/reference/spaces/app-core/teleport#apppickerstep-enum), [`AppPickerTab`](/cua-sdk/reference/spaces/app-core/teleport#apppickertab-enum)+**[Teleport picker](/cua-sdk/reference/spaces/app-core/teleport)**: `app_catalog_entries_from_json`, `app_catalog_entry`, `app_picker_can_plan`, `app_picker_consent`, `app_picker_initial`, `app_picker_plan_sensitive`, `app_picker_primary`, `app_picker_progress`, `app_picker_reduce`, `app_picker_review`, `app_picker_sections`, `app_picker_sensitive_options`, `app_picker_status`, `AppCatalogEntry`, `AppEntrySection`, `AppPickerAction`, `AppPickerEvent`, `AppPickerPrimary`, `AppPickerState`, `AppPickerStep`, `AppPickerTab`-**Window, menu bar and Settings**: [`app_chrome_input_from_json`](/cua-sdk/reference/spaces/app-core/window#app_chrome_input_from_json), [`app_delete_failed_text`](/cua-sdk/reference/spaces/app-core/window#app_delete_failed_text), [`app_display_name`](/cua-sdk/reference/spaces/app-core/window#app_display_name), [`app_display_path`](/cua-sdk/reference/spaces/app-core/window#app_display_path), [`app_drop_sending_text`](/cua-sdk/reference/spaces/app-core/window#app_drop_sending_text), [`app_drop_sent_text`](/cua-sdk/reference/spaces/app-core/window#app_drop_sent_text), [`app_format_bytes`](/cua-sdk/reference/spaces/app-core/window#app_format_bytes), [`app_login_item_launch_plan`](/cua-sdk/reference/spaces/app-core/window#app_login_item_launch_plan), [`app_main_chrome`](/cua-sdk/reference/spaces/app-core/window#app_main_chrome), [`app_menu`](/cua-sdk/reference/spaces/app-core/window#app_menu), [`app_menu_bar`](/cua-sdk/reference/spaces/app-core/window#app_menu_bar), [`app_menu_bar_with_keyvault`](/cua-sdk/reference/spaces/app-core/window#app_menu_bar_with_keyvault), [`app_menu_input_from_json`](/cua-sdk/reference/spaces/app-core/window#app_menu_input_from_json), [`app_openable_count`](/cua-sdk/reference/spaces/app-core/window#app_openable_count), [`app_sent_file`](/cua-sdk/reference/spaces/app-core/window#app_sent_file), [`app_sent_files_from_json`](/cua-sdk/reference/spaces/app-core/window#app_sent_files_from_json), [`app_settings_input_from_json`](/cua-sdk/reference/spaces/app-core/window#app_settings_input_from_json), [`app_settings_page`](/cua-sdk/reference/spaces/app-core/window#app_settings_page), [`app_space_detail_copy`](/cua-sdk/reference/spaces/app-core/window#app_space_detail_copy), [`AppChromeInput`](/cua-sdk/reference/spaces/app-core/window#appchromeinput-record), [`AppDeleteConfirm`](/cua-sdk/reference/spaces/app-core/window#appdeleteconfirm-record), [`AppDetailAction`](/cua-sdk/reference/spaces/app-core/window#appdetailaction-record), [`AppDetailActionId`](/cua-sdk/reference/spaces/app-core/window#appdetailactionid-enum), [`AppDetailCopy`](/cua-sdk/reference/spaces/app-core/window#appdetailcopy-record), [`AppFact`](/cua-sdk/reference/spaces/app-core/window#appfact-record), [`AppFactCopy`](/cua-sdk/reference/spaces/app-core/window#appfactcopy-record), [`AppLoginItemInput`](/cua-sdk/reference/spaces/app-core/window#apploginiteminput-record), [`AppLoginItemPlan`](/cua-sdk/reference/spaces/app-core/window#apploginitemplan-record), [`AppLoginItemStatus`](/cua-sdk/reference/spaces/app-core/window#apploginitemstatus-enum), [`AppMainChrome`](/cua-sdk/reference/spaces/app-core/window#appmainchrome-record), [`AppMenuInput`](/cua-sdk/reference/spaces/app-core/window#appmenuinput-record), [`AppMenuItem`](/cua-sdk/reference/spaces/app-core/window#appmenuitem-record), [`AppMenuItemId`](/cua-sdk/reference/spaces/app-core/window#appmenuitemid-enum), [`AppSentFileInfo`](/cua-sdk/reference/spaces/app-core/window#appsentfileinfo-record), [`AppSettingsInput`](/cua-sdk/reference/spaces/app-core/window#appsettingsinput-record), [`AppSettingsOption`](/cua-sdk/reference/spaces/app-core/window#appsettingsoption-record), [`AppSettingsPage`](/cua-sdk/reference/spaces/app-core/window#appsettingspage-record), [`AppSettingsRow`](/cua-sdk/reference/spaces/app-core/window#appsettingsrow-record), [`AppSettingsRowKind`](/cua-sdk/reference/spaces/app-core/window#appsettingsrowkind-enum), [`AppSettingsSection`](/cua-sdk/reference/spaces/app-core/window#appsettingssection-record), [`AppSignInPhase`](/cua-sdk/reference/spaces/app-core/window#appsigninphase-enum), [`AppTelemetryInput`](/cua-sdk/reference/spaces/app-core/window#apptelemetryinput-record)+**[Window, menu bar and Settings](/cua-sdk/reference/spaces/app-core/window)**: `app_chrome_input_from_json`, `app_delete_failed_text`, `app_display_name`, `app_display_path`, `app_drop_sending_text`, `app_drop_sent_text`, `app_format_bytes`, `app_login_item_launch_plan`, `app_main_chrome`, `app_menu`, `app_menu_bar`, `app_menu_bar_with_keyvault`, `app_menu_input_from_json`, `app_openable_count`, `app_sent_file`, `app_sent_files_from_json`, `app_settings_input_from_json`, `app_settings_page`, `app_space_detail_copy`, `AppChromeInput`, `AppDeleteConfirm`, `AppDetailAction`, `AppDetailActionId`, `AppDetailCopy`, `AppFact`, `AppFactCopy`, `AppLoginItemInput`, `AppLoginItemPlan`, `AppLoginItemStatus`, `AppMainChrome`, `AppMenuInput`, `AppMenuItem`, `AppMenuItemId`, `AppSentFileInfo`, `AppSettingsInput`, `AppSettingsOption`, `AppSettingsPage`, `AppSettingsRow`, `AppSettingsRowKind`, `AppSettingsSection`, `AppSignInPhase`, `AppTelemetryInput`-**Your cloud**: [`app_cloud_connect_action_from_json`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_action_from_json), [`app_cloud_connect_initial`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_initial), [`app_cloud_connect_input_from_json`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_input_from_json), [`app_cloud_connect_input_from_status_json`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_input_from_status_json), [`app_cloud_connect_reduce`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_reduce), [`app_cloud_connect_view`](/cua-sdk/reference/spaces/app-core/cloud#app_cloud_connect_view), [`app_connected_cloud_from_json`](/cua-sdk/reference/spaces/app-core/cloud#app_connected_cloud_from_json), [`app_connected_clouds_from_status_json`](/cua-sdk/reference/spaces/app-core/cloud#app_connected_clouds_from_status_json), [`app_is_cloud_word`](/cua-sdk/reference/spaces/app-core/cloud#app_is_cloud_word), [`AppCloudCheckInput`](/cua-sdk/reference/spaces/app-core/cloud#appcloudcheckinput-record), [`AppCloudCheckRow`](/cua-sdk/reference/spaces/app-core/cloud#appcloudcheckrow-record), [`AppCloudConnectAction`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectaction-enum), [`AppCloudConnectInput`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectinput-record), [`AppCloudConnectPhase`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectphase-enum), [`AppCloudConnectRequest`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectrequest-enum), [`AppCloudConnectState`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectstate-record), [`AppCloudConnectView`](/cua-sdk/reference/spaces/app-core/cloud#appcloudconnectview-record), [`AppCloudField`](/cua-sdk/reference/spaces/app-core/cloud#appcloudfield-record), [`AppCloudOffer`](/cua-sdk/reference/spaces/app-core/cloud#appcloudoffer-record), [`AppCloudProviderInput`](/cua-sdk/reference/spaces/app-core/cloud#appcloudproviderinput-record), [`AppCloudProviderRow`](/cua-sdk/reference/spaces/app-core/cloud#appcloudproviderrow-record), [`AppCloudTargetArgs`](/cua-sdk/reference/spaces/app-core/cloud#appcloudtargetargs-record), [`AppConnectedCloud`](/cua-sdk/reference/spaces/app-core/cloud#appconnectedcloud-record)+**[Your cloud](/cua-sdk/reference/spaces/app-core/cloud)**: `app_cloud_connect_action_from_json`, `app_cloud_connect_initial`, `app_cloud_connect_input_from_json`, `app_cloud_connect_input_from_status_json`, `app_cloud_connect_reduce`, `app_cloud_connect_view`, `app_connected_cloud_from_json`, `app_connected_clouds_from_status_json`, `app_is_cloud_word`, `AppCloudCheckInput`, `AppCloudCheckRow`, `AppCloudConnectAction`, `AppCloudConnectInput`, `AppCloudConnectPhase`, `AppCloudConnectRequest`, `AppCloudConnectState`, `AppCloudConnectView`, `AppCloudField`, `AppCloudOffer`, `AppCloudProviderInput`, `AppCloudProviderRow`, `AppCloudTargetArgs`, `AppConnectedCloud`-**Creates and deletes**: [`app_creates_compose`](/cua-sdk/reference/spaces/app-core/creates#app_creates_compose), [`app_creates_is_deleting`](/cua-sdk/reference/spaces/app-core/creates#app_creates_is_deleting), [`app_creates_is_pending`](/cua-sdk/reference/spaces/app-core/creates#app_creates_is_pending), [`app_creates_reduce`](/cua-sdk/reference/spaces/app-core/creates#app_creates_reduce), [`app_creates_settle`](/cua-sdk/reference/spaces/app-core/creates#app_creates_settle), [`AppCreateAction`](/cua-sdk/reference/spaces/app-core/creates#appcreateaction-enum), [`AppCreatesState`](/cua-sdk/reference/spaces/app-core/creates#appcreatesstate-record), [`AppPendingCreate`](/cua-sdk/reference/spaces/app-core/creates#apppendingcreate-record), [`AppPendingDelete`](/cua-sdk/reference/spaces/app-core/creates#apppendingdelete-record)+**[Creates and deletes](/cua-sdk/reference/spaces/app-core/creates)**: `app_creates_compose`, `app_creates_is_deleting`, `app_creates_is_pending`, `app_creates_reduce`, `app_creates_settle`, `AppCreateAction`, `AppCreatesState`, `AppPendingCreate`, `AppPendingDelete`-**Power button**: [`app_creates_is_powering`](/cua-sdk/reference/spaces/app-core/power#app_creates_is_powering), [`app_power_button`](/cua-sdk/reference/spaces/app-core/power#app_power_button), [`AppPendingPower`](/cua-sdk/reference/spaces/app-core/power#apppendingpower-record), [`AppPowerButton`](/cua-sdk/reference/spaces/app-core/power#apppowerbutton-record), [`AppPowerControl`](/cua-sdk/reference/spaces/app-core/power#apppowercontrol-enum), [`AppSpacePower`](/cua-sdk/reference/spaces/app-core/power#appspacepower-record)+**[Power button](/cua-sdk/reference/spaces/app-core/power)**: `app_creates_is_powering`, `app_power_button`, `AppPendingPower`, `AppPowerButton`, `AppPowerControl`, `AppSpacePower`-**Stream section and facts**: [`app_desktop_cover`](/cua-sdk/reference/spaces/app-core/stream#app_desktop_cover), [`app_space_detail_live`](/cua-sdk/reference/spaces/app-core/stream#app_space_detail_live), [`app_stream_desktop_row_id`](/cua-sdk/reference/spaces/app-core/stream#app_stream_desktop_row_id), [`app_stream_pip_click`](/cua-sdk/reference/spaces/app-core/stream#app_stream_pip_click), [`app_stream_pip_reduce`](/cua-sdk/reference/spaces/app-core/stream#app_stream_pip_reduce), [`app_stream_section`](/cua-sdk/reference/spaces/app-core/stream#app_stream_section), [`app_thumbnail_policy`](/cua-sdk/reference/spaces/app-core/stream#app_thumbnail_policy), [`app_usage_refresh_ms`](/cua-sdk/reference/spaces/app-core/stream#app_usage_refresh_ms), [`AppDesktopCover`](/cua-sdk/reference/spaces/app-core/stream#appdesktopcover-record), [`AppDesktopCoverInput`](/cua-sdk/reference/spaces/app-core/stream#appdesktopcoverinput-record), [`AppDesktopCoverKind`](/cua-sdk/reference/spaces/app-core/stream#appdesktopcoverkind-enum), [`AppPipCommand`](/cua-sdk/reference/spaces/app-core/stream#apppipcommand-enum), [`AppPipEvent`](/cua-sdk/reference/spaces/app-core/stream#apppipevent-enum), [`AppSpaceUsage`](/cua-sdk/reference/spaces/app-core/stream#appspaceusage-record), [`AppStreamDisplay`](/cua-sdk/reference/spaces/app-core/stream#appstreamdisplay-record), [`AppStreamPhase`](/cua-sdk/reference/spaces/app-core/stream#appstreamphase-enum), [`AppStreamRow`](/cua-sdk/reference/spaces/app-core/stream#appstreamrow-record), [`AppStreamRowAction`](/cua-sdk/reference/spaces/app-core/stream#appstreamrowaction-record), [`AppStreamRowActionId`](/cua-sdk/reference/spaces/app-core/stream#appstreamrowactionid-enum), [`AppStreamRowIcon`](/cua-sdk/reference/spaces/app-core/stream#appstreamrowicon-enum), [`AppStreamRowKind`](/cua-sdk/reference/spaces/app-core/stream#appstreamrowkind-enum), [`AppStreamSection`](/cua-sdk/reference/spaces/app-core/stream#appstreamsection-record), [`AppStreamSectionInput`](/cua-sdk/reference/spaces/app-core/stream#appstreamsectioninput-record), [`AppThumbnailPolicy`](/cua-sdk/reference/spaces/app-core/stream#appthumbnailpolicy-record)+**[Stream section and facts](/cua-sdk/reference/spaces/app-core/stream)**: `app_desktop_cover`, `app_space_detail_live`, `app_stream_desktop_row_id`, `app_stream_pip_click`, `app_stream_pip_reduce`, `app_stream_section`, `app_thumbnail_policy`, `app_usage_refresh_ms`, `AppDesktopCover`, `AppDesktopCoverInput`, `AppDesktopCoverKind`, `AppPipCommand`, `AppPipEvent`, `AppSpaceUsage`, `AppStreamDisplay`, `AppStreamPhase`, `AppStreamRow`, `AppStreamRowAction`, `AppStreamRowActionId`, `AppStreamRowIcon`, `AppStreamRowKind`, `AppStreamSection`, `AppStreamSectionInput`, `AppThumbnailPolicy`-**Window drag trigger**: [`app_drag_classify`](/cua-sdk/reference/spaces/app-core/drag-trigger#app_drag_classify), [`app_drag_displays`](/cua-sdk/reference/spaces/app-core/drag-trigger#app_drag_displays), [`app_drag_portal_displays`](/cua-sdk/reference/spaces/app-core/drag-trigger#app_drag_portal_displays), [`app_drag_trigger_apply`](/cua-sdk/reference/spaces/app-core/drag-trigger#app_drag_trigger_apply), [`app_drag_trigger_initial`](/cua-sdk/reference/spaces/app-core/drag-trigger#app_drag_trigger_initial), [`AppDragDisplay`](/cua-sdk/reference/spaces/app-core/drag-trigger#appdragdisplay-record), [`AppDragKind`](/cua-sdk/reference/spaces/app-core/drag-trigger#appdragkind-enum), [`AppDragTriggerEvent`](/cua-sdk/reference/spaces/app-core/drag-trigger#appdragtriggerevent-enum), [`AppDragTriggerState`](/cua-sdk/reference/spaces/app-core/drag-trigger#appdragtriggerstate-record), [`AppDragTriggerTransition`](/cua-sdk/reference/spaces/app-core/drag-trigger#appdragtriggertransition-record), [`AppStillAnchor`](/cua-sdk/reference/spaces/app-core/drag-trigger#appstillanchor-record), [`AppTriggerPhase`](/cua-sdk/reference/spaces/app-core/drag-trigger#apptriggerphase-enum)+**[Window drag trigger](/cua-sdk/reference/spaces/app-core/drag-trigger)**: `app_drag_classify`, `app_drag_displays`, `app_drag_portal_displays`, `app_drag_trigger_apply`, `app_drag_trigger_initial`, `AppDragDisplay`, `AppDragKind`, `AppDragTriggerEvent`, `AppDragTriggerState`, `AppDragTriggerTransition`, `AppStillAnchor`, `AppTriggerPhase`-**Onboarding and settings**: [`app_driver_preview`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_driver_preview), [`app_driver_preview_frame`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_driver_preview_frame), [`app_driver_preview_still`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_driver_preview_still), [`app_format_hotkey`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_format_hotkey), [`app_onboarding_action_from_json`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_action_from_json), [`app_onboarding_copy`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_copy), [`app_onboarding_initial`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_initial), [`app_onboarding_installed_at_text`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_installed_at_text), [`app_onboarding_reduce`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_reduce), [`app_onboarding_replaces_text`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_replaces_text), [`app_onboarding_sign_in_code_text`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_sign_in_code_text), [`app_onboarding_signed_in_text`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_signed_in_text), [`app_onboarding_view`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_onboarding_view), [`app_presentation_preview`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_presentation_preview), [`app_presentation_preview_frame`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_presentation_preview_frame), [`app_presentation_preview_still`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_presentation_preview_still), [`app_settings_load`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_settings_load), [`app_settings_save`](/cua-sdk/reference/spaces/app-core/onboarding-settings#app_settings_save), [`AppDriverFrame`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appdriverframe-record), [`AppDriverPreview`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appdriverpreview-record), [`AppKeyCombo`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appkeycombo-record), [`AppMenuPreview`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appmenupreview-record), [`AppMenuPreviewRow`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appmenupreviewrow-record), [`AppModeChoice`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appmodechoice-record), [`AppOnboardingAction`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingaction-enum), [`AppOnboardingCheckbox`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingcheckbox-record), [`AppOnboardingCopy`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingcopy-record), [`AppOnboardingMode`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingmode-enum), [`AppOnboardingState`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingstate-record), [`AppOnboardingStep`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingstep-enum), [`AppOnboardingView`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apponboardingview-record), [`AppPresentationCard`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppresentationcard-record), [`AppPresentationPreview`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppresentationpreview-record), [`AppPreviewFrame`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppreviewframe-record), [`AppPreviewPoint`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppreviewpoint-record), [`AppPreviewSegment`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppreviewsegment-record), [`AppPreviewWindow`](/cua-sdk/reference/spaces/app-core/onboarding-settings#apppreviewwindow-record), [`AppSettings`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appsettings-record), [`AppSwitcherTheme`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appswitchertheme-enum), [`AppUsageToggle`](/cua-sdk/reference/spaces/app-core/onboarding-settings#appusagetoggle-record)+**[Onboarding and settings](/cua-sdk/reference/spaces/app-core/onboarding-settings)**: `app_driver_preview`, `app_driver_preview_frame`, `app_driver_preview_still`, `app_format_hotkey`, `app_onboarding_action_from_json`, `app_onboarding_copy`, `app_onboarding_initial`, `app_onboarding_installed_at_text`, `app_onboarding_reduce`, `app_onboarding_replaces_text`, `app_onboarding_sign_in_code_text`, `app_onboarding_signed_in_text`, `app_onboarding_view`, `app_presentation_preview`, `app_presentation_preview_frame`, `app_presentation_preview_still`, `app_settings_load`, `app_settings_save`, `AppDriverFrame`, `AppDriverPreview`, `AppKeyCombo`, `AppMenuPreview`, `AppMenuPreviewRow`, `AppModeChoice`, `AppOnboardingAction`, `AppOnboardingCheckbox`, `AppOnboardingCopy`, `AppOnboardingMode`, `AppOnboardingState`, `AppOnboardingStep`, `AppOnboardingView`, `AppPresentationCard`, `AppPresentationPreview`, `AppPreviewFrame`, `AppPreviewPoint`, `AppPreviewSegment`, `AppPreviewWindow`, `AppSettings`, `AppSwitcherTheme`, `AppUsageToggle`-**Experiments**: [`app_experiments_choose`](/cua-sdk/reference/spaces/app-core/experiments#app_experiments_choose), [`app_experiments_from_json`](/cua-sdk/reference/spaces/app-core/experiments#app_experiments_from_json), [`app_experiments_page`](/cua-sdk/reference/spaces/app-core/experiments#app_experiments_page), [`app_settings_with_storage`](/cua-sdk/reference/spaces/app-core/experiments#app_settings_with_storage), [`app_telemetry_experiments_changed`](/cua-sdk/reference/spaces/app-core/experiments#app_telemetry_experiments_changed), [`app_telemetry_experiments_on`](/cua-sdk/reference/spaces/app-core/experiments#app_telemetry_experiments_on), [`AppExperiments`](/cua-sdk/reference/spaces/app-core/experiments#appexperiments-record)+**[Experiments](/cua-sdk/reference/spaces/app-core/experiments)**: `app_experiments_choose`, `app_experiments_from_json`, `app_experiments_page`, `app_settings_choose_experiment`, `app_settings_first_launch_channel`, `app_settings_resolve_new_ui`, `app_settings_with_storage`, `app_telemetry_experiments_changed`, `app_telemetry_experiments_on`, `AppExperiments`-**This machine**: [`app_host_account_key`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_account_key), [`app_host_account_step`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_account_step), [`app_host_arch`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_arch), [`app_host_form_action_from_json`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_form_action_from_json), [`app_host_form_initial`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_form_initial), [`app_host_form_reduce`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_form_reduce), [`app_host_form_view`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_form_view), [`app_host_looks_like_listen`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_looks_like_listen), [`app_host_panel`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_panel), [`app_host_parse_allow_list`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_parse_allow_list), [`app_host_permission_rows`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_permission_rows), [`app_host_setting_change`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_setting_change), [`app_host_setup`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_setup), [`app_host_state`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_state), [`app_host_state_from_json`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_state_from_json), [`app_host_summary_input`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_summary_input), [`app_host_validate_setup`](/cua-sdk/reference/spaces/app-core/this-machine#app_host_validate_setup), [`app_with_this_machine`](/cua-sdk/reference/spaces/app-core/this-machine#app_with_this_machine), [`AppHostAccess`](/cua-sdk/reference/spaces/app-core/this-machine#apphostaccess-record), [`AppHostAccessRow`](/cua-sdk/reference/spaces/app-core/this-machine#apphostaccessrow-record), [`AppHostAccount`](/cua-sdk/reference/spaces/app-core/this-machine#apphostaccount-record), [`AppHostAccountStep`](/cua-sdk/reference/spaces/app-core/this-machine#apphostaccountstep-enum), [`AppHostAction`](/cua-sdk/reference/spaces/app-core/this-machine#apphostaction-record), [`AppHostActionId`](/cua-sdk/reference/spaces/app-core/this-machine#apphostactionid-enum), [`AppHostClient`](/cua-sdk/reference/spaces/app-core/this-machine#apphostclient-record), [`AppHostConfirm`](/cua-sdk/reference/spaces/app-core/this-machine#apphostconfirm-record), [`AppHostFormAction`](/cua-sdk/reference/spaces/app-core/this-machine#apphostformaction-enum), [`AppHostFormChoice`](/cua-sdk/reference/spaces/app-core/this-machine#apphostformchoice-record), [`AppHostFormField`](/cua-sdk/reference/spaces/app-core/this-machine#apphostformfield-record), [`AppHostFormState`](/cua-sdk/reference/spaces/app-core/this-machine#apphostformstate-record), [`AppHostFormView`](/cua-sdk/reference/spaces/app-core/this-machine#apphostformview-record), [`AppHostLimit`](/cua-sdk/reference/spaces/app-core/this-machine#apphostlimit-record), [`AppHostPanelView`](/cua-sdk/reference/spaces/app-core/this-machine#apphostpanelview-record), [`AppHostPermissionInput`](/cua-sdk/reference/spaces/app-core/this-machine#apphostpermissioninput-record), [`AppHostProvidedSpace`](/cua-sdk/reference/spaces/app-core/this-machine#apphostprovidedspace-record), [`AppHostSettingChange`](/cua-sdk/reference/spaces/app-core/this-machine#apphostsettingchange-record), [`AppHostSetupChoice`](/cua-sdk/reference/spaces/app-core/this-machine#apphostsetupchoice-record), [`AppHostSetupRequest`](/cua-sdk/reference/spaces/app-core/this-machine#apphostsetuprequest-record), [`AppHostSpacesAudit`](/cua-sdk/reference/spaces/app-core/this-machine#apphostspacesaudit-record), [`AppHostState`](/cua-sdk/reference/spaces/app-core/this-machine#apphoststate-record), [`AppHostToggle`](/cua-sdk/reference/spaces/app-core/this-machine#apphosttoggle-record), [`AppPermissionRow`](/cua-sdk/reference/spaces/app-core/this-machine#apppermissionrow-record)+**[This machine](/cua-sdk/reference/spaces/app-core/this-machine)**: `app_host_account_key`, `app_host_account_step`, `app_host_arch`, `app_host_form_action_from_json`, `app_host_form_initial`, `app_host_form_reduce`, `app_host_form_view`, `app_host_looks_like_listen`, `app_host_panel`, `app_host_parse_allow_list`, `app_host_permission_rows`, `app_host_setting_change`, `app_host_setup`, `app_host_state`, `app_host_state_from_json`, `app_host_summary_input`, `app_host_validate_setup`, `app_with_this_machine`, `AppHostAccess`, `AppHostAccessRow`, `AppHostAccount`, `AppHostAccountStep`, `AppHostAction`, `AppHostActionId`, `AppHostClient`, `AppHostConfirm`, `AppHostFormAction`, `AppHostFormChoice`, `AppHostFormField`, `AppHostFormState`, `AppHostFormView`, `AppHostLimit`, `AppHostPanelView`, `AppHostPermissionInput`, `AppHostProvidedSpace`, `AppHostSettingChange`, `AppHostSetupChoice`, `AppHostSetupRequest`, `AppHostSpacesAudit`, `AppHostState`, `AppHostToggle`, `AppPermissionRow`-**Notch**: [`app_notch_estimated_progress`](/cua-sdk/reference/spaces/app-core/notch#app_notch_estimated_progress), [`app_notch_initial`](/cua-sdk/reference/spaces/app-core/notch#app_notch_initial), [`app_notch_layout`](/cua-sdk/reference/spaces/app-core/notch#app_notch_layout), [`app_notch_motion`](/cua-sdk/reference/spaces/app-core/notch#app_notch_motion), [`app_notch_radii`](/cua-sdk/reference/spaces/app-core/notch#app_notch_radii), [`app_notch_reduce`](/cua-sdk/reference/spaces/app-core/notch#app_notch_reduce), [`app_notch_tile_at`](/cua-sdk/reference/spaces/app-core/notch#app_notch_tile_at), [`app_notch_view`](/cua-sdk/reference/spaces/app-core/notch#app_notch_view), [`app_os_icon_svg`](/cua-sdk/reference/spaces/app-core/notch#app_os_icon_svg), [`app_os_icon_system_symbol`](/cua-sdk/reference/spaces/app-core/notch#app_os_icon_system_symbol), [`app_presence_name`](/cua-sdk/reference/spaces/app-core/notch#app_presence_name), [`app_presence_principal_id`](/cua-sdk/reference/spaces/app-core/notch#app_presence_principal_id), [`AppLogicalRect`](/cua-sdk/reference/spaces/app-core/notch#applogicalrect-record), [`AppNotchAccess`](/cua-sdk/reference/spaces/app-core/notch#appnotchaccess-record), [`AppNotchActivity`](/cua-sdk/reference/spaces/app-core/notch#appnotchactivity-record), [`AppNotchActivityKind`](/cua-sdk/reference/spaces/app-core/notch#appnotchactivitykind-enum), [`AppNotchButton`](/cua-sdk/reference/spaces/app-core/notch#appnotchbutton-record), [`AppNotchButtonId`](/cua-sdk/reference/spaces/app-core/notch#appnotchbuttonid-enum), [`AppNotchEffect`](/cua-sdk/reference/spaces/app-core/notch#appnotcheffect-enum), [`AppNotchEvent`](/cua-sdk/reference/spaces/app-core/notch#appnotchevent-enum), [`AppNotchHeader`](/cua-sdk/reference/spaces/app-core/notch#appnotchheader-record), [`AppNotchLayout`](/cua-sdk/reference/spaces/app-core/notch#appnotchlayout-record), [`AppNotchMotion`](/cua-sdk/reference/spaces/app-core/notch#appnotchmotion-record), [`AppNotchPermission`](/cua-sdk/reference/spaces/app-core/notch#appnotchpermission-record), [`AppNotchPhase`](/cua-sdk/reference/spaces/app-core/notch#appnotchphase-enum), [`AppNotchPreview`](/cua-sdk/reference/spaces/app-core/notch#appnotchpreview-record), [`AppNotchRadii`](/cua-sdk/reference/spaces/app-core/notch#appnotchradii-record), [`AppNotchState`](/cua-sdk/reference/spaces/app-core/notch#appnotchstate-record), [`AppNotchTab`](/cua-sdk/reference/spaces/app-core/notch#appnotchtab-record), [`AppNotchTile`](/cua-sdk/reference/spaces/app-core/notch#appnotchtile-record), [`AppNotchTransfer`](/cua-sdk/reference/spaces/app-core/notch#appnotchtransfer-record), [`AppNotchTransition`](/cua-sdk/reference/spaces/app-core/notch#appnotchtransition-record), [`AppNotchView`](/cua-sdk/reference/spaces/app-core/notch#appnotchview-record), [`AppScreenFacts`](/cua-sdk/reference/spaces/app-core/notch#appscreenfacts-record)+**[Notch](/cua-sdk/reference/spaces/app-core/notch)**: `app_notch_estimated_progress`, `app_notch_initial`, `app_notch_layout`, `app_notch_motion`, `app_notch_radii`, `app_notch_reduce`, `app_notch_tile_at`, `app_notch_view`, `app_os_icon_svg`, `app_os_icon_system_symbol`, `app_presence_name`, `app_presence_principal_id`, `AppLogicalRect`, `AppNotchAccess`, `AppNotchActivity`, `AppNotchActivityKind`, `AppNotchButton`, `AppNotchButtonId`, `AppNotchEffect`, `AppNotchEvent`, `AppNotchHeader`, `AppNotchLayout`, `AppNotchMotion`, `AppNotchPermission`, `AppNotchPhase`, `AppNotchPreview`, `AppNotchRadii`, `AppNotchState`, `AppNotchTab`, `AppNotchTile`, `AppNotchTransfer`, `AppNotchTransition`, `AppNotchView`, `AppScreenFacts`-**Teleport picker grid**: [`app_picker_app_grid`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_app_grid), [`app_picker_grid_primary`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_grid_primary), [`app_picker_grid_step`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_grid_step), [`app_picker_grid_tabs`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_grid_tabs), [`app_picker_remote_grid`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_remote_grid), [`app_picker_window_grid`](/cua-sdk/reference/spaces/app-core/teleport-grid#app_picker_window_grid), [`AppPickerGrid`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickergrid-record), [`AppPickerGridPrimary`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickergridprimary-record), [`AppPickerGridTab`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickergridtab-enum), [`AppPickerGridTabItem`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickergridtabitem-record), [`AppPickerTile`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickertile-record), [`AppPickerTileIcon`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickertileicon-enum), [`AppPickerTileSection`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickertilesection-record), [`AppPickerTileThumbnail`](/cua-sdk/reference/spaces/app-core/teleport-grid#apppickertilethumbnail-enum)+**[Teleport picker grid](/cua-sdk/reference/spaces/app-core/teleport-grid)**: `app_picker_app_grid`, `app_picker_grid_primary`, `app_picker_grid_step`, `app_picker_grid_tabs`, `app_picker_remote_grid`, `app_picker_window_grid`, `AppPickerGrid`, `AppPickerGridPrimary`, `AppPickerGridTab`, `AppPickerGridTabItem`, `AppPickerTile`, `AppPickerTileIcon`, `AppPickerTileSection`, `AppPickerTileThumbnail`-**Relay usage**: [`app_relay_usage`](/cua-sdk/reference/spaces/app-core/relay#app_relay_usage), [`app_relay_usage_view`](/cua-sdk/reference/spaces/app-core/relay#app_relay_usage_view), [`AppRelayAllowanceNotice`](/cua-sdk/reference/spaces/app-core/relay#apprelayallowancenotice-record), [`AppRelayUsage`](/cua-sdk/reference/spaces/app-core/relay#apprelayusage-record), [`AppRelayUsageTeam`](/cua-sdk/reference/spaces/app-core/relay#apprelayusageteam-record), [`AppRelayUsageView`](/cua-sdk/reference/spaces/app-core/relay#apprelayusageview-record)+**[Relay usage](/cua-sdk/reference/spaces/app-core/relay)**: `app_relay_usage`, `app_relay_usage_view`, `AppRelayAllowanceNotice`, `AppRelayUsage`, `AppRelayUsageTeam`, `AppRelayUsageView`-**Teleport review**: [`app_review_remember`](/cua-sdk/reference/spaces/app-core/teleport-review#app_review_remember), [`app_review_remember_key`](/cua-sdk/reference/spaces/app-core/teleport-review#app_review_remember_key), [`app_review_remembered`](/cua-sdk/reference/spaces/app-core/teleport-review#app_review_remembered), [`AppConsentItem`](/cua-sdk/reference/spaces/app-core/teleport-review#appconsentitem-record), [`AppConsentKind`](/cua-sdk/reference/spaces/app-core/teleport-review#appconsentkind-enum), [`AppInstallCuaPrompt`](/cua-sdk/reference/spaces/app-core/teleport-review#appinstallcuaprompt-record), [`AppPlanStepView`](/cua-sdk/reference/spaces/app-core/teleport-review#appplanstepview-record), [`AppRememberedChoice`](/cua-sdk/reference/spaces/app-core/teleport-review#apprememberedchoice-record), [`AppReviewChoice`](/cua-sdk/reference/spaces/app-core/teleport-review#appreviewchoice-record), [`AppReviewDomain`](/cua-sdk/reference/spaces/app-core/teleport-review#appreviewdomain-record), [`AppReviewToggle`](/cua-sdk/reference/spaces/app-core/teleport-review#appreviewtoggle-record), [`AppReviewView`](/cua-sdk/reference/spaces/app-core/teleport-review#appreviewview-record), [`AppSendSource`](/cua-sdk/reference/spaces/app-core/teleport-review#appsendsource-enum), [`AppVaultSource`](/cua-sdk/reference/spaces/app-core/teleport-review#appvaultsource-record)+**[Teleport review](/cua-sdk/reference/spaces/app-core/teleport-review)**: `app_review_remember`, `app_review_remember_key`, `app_review_remembered`, `AppConsentItem`, `AppConsentKind`, `AppInstallCuaPrompt`, `AppPlanStepView`, `AppRememberedChoice`, `AppReviewChoice`, `AppReviewDomain`, `AppReviewToggle`, `AppReviewView`, `AppSendSource`, `AppVaultSource`-**Keyvault**: [`app_sensitive_group_sdk`](/cua-sdk/reference/spaces/app-core/keyvault#app_sensitive_group_sdk), [`AppSensitiveGroup`](/cua-sdk/reference/spaces/app-core/keyvault#appsensitivegroup-enum), [`AppSensitiveOption`](/cua-sdk/reference/spaces/app-core/keyvault#appsensitiveoption-record), [`KeyvaultClient`](/cua-sdk/reference/spaces/app-core/keyvault#keyvaultclient), [`KeyvaultOverview`](/cua-sdk/reference/spaces/app-core/keyvault#keyvaultoverview-record), [`kv_credential_form`](/cua-sdk/reference/spaces/app-core/keyvault#kv_credential_form), [`kv_duration`](/cua-sdk/reference/spaces/app-core/keyvault#kv_duration), [`kv_labels`](/cua-sdk/reference/spaces/app-core/keyvault#kv_labels), [`kv_overview_from_json`](/cua-sdk/reference/spaces/app-core/keyvault#kv_overview_from_json), [`kv_passphrase_check`](/cua-sdk/reference/spaces/app-core/keyvault#kv_passphrase_check), [`kv_prune_dismissed`](/cua-sdk/reference/spaces/app-core/keyvault#kv_prune_dismissed), [`kv_recovery_key_text`](/cua-sdk/reference/spaces/app-core/keyvault#kv_recovery_key_text), [`kv_sharing_label`](/cua-sdk/reference/spaces/app-core/keyvault#kv_sharing_label), [`kv_signed_in_spaces`](/cua-sdk/reference/spaces/app-core/keyvault#kv_signed_in_spaces), [`kv_space_access_key`](/cua-sdk/reference/spaces/app-core/keyvault#kv_space_access_key), [`kv_visible_sharing_label`](/cua-sdk/reference/spaces/app-core/keyvault#kv_visible_sharing_label), [`KvAccessRequest`](/cua-sdk/reference/spaces/app-core/keyvault#kvaccessrequest-record), [`KvAuditEntry`](/cua-sdk/reference/spaces/app-core/keyvault#kvauditentry-record), [`KvCaller`](/cua-sdk/reference/spaces/app-core/keyvault#kvcaller-record), [`KvCommand`](/cua-sdk/reference/spaces/app-core/keyvault#kvcommand-enum), [`KvCredentialForm`](/cua-sdk/reference/spaces/app-core/keyvault#kvcredentialform-record), [`KvDelivery`](/cua-sdk/reference/spaces/app-core/keyvault#kvdelivery-record), [`KvDomainCount`](/cua-sdk/reference/spaces/app-core/keyvault#kvdomaincount-record), [`KvFavicon`](/cua-sdk/reference/spaces/app-core/keyvault#kvfavicon-record), [`KvFormMode`](/cua-sdk/reference/spaces/app-core/keyvault#kvformmode-enum), [`KvGrant`](/cua-sdk/reference/spaces/app-core/keyvault#kvgrant-record), [`KvInventory`](/cua-sdk/reference/spaces/app-core/keyvault#kvinventory-record), [`KvItem`](/cua-sdk/reference/spaces/app-core/keyvault#kvitem-record), [`KvItemPolicy`](/cua-sdk/reference/spaces/app-core/keyvault#kvitempolicy-record), [`KvLabels`](/cua-sdk/reference/spaces/app-core/keyvault#kvlabels-record), [`KvMethod`](/cua-sdk/reference/spaces/app-core/keyvault#kvmethod-enum), [`KvOutcome`](/cua-sdk/reference/spaces/app-core/keyvault#kvoutcome-enum), [`KvPassphraseCheck`](/cua-sdk/reference/spaces/app-core/keyvault#kvpassphrasecheck-record), [`KvPending`](/cua-sdk/reference/spaces/app-core/keyvault#kvpending-record), [`KvRule`](/cua-sdk/reference/spaces/app-core/keyvault#kvrule-record), [`KvRuleCaller`](/cua-sdk/reference/spaces/app-core/keyvault#kvrulecaller-record), [`KvSelector`](/cua-sdk/reference/spaces/app-core/keyvault#kvselector-enum), [`KvSigning`](/cua-sdk/reference/spaces/app-core/keyvault#kvsigning-enum), [`KvStatus`](/cua-sdk/reference/spaces/app-core/keyvault#kvstatus-record), [`KvStrength`](/cua-sdk/reference/spaces/app-core/keyvault#kvstrength-enum), [`KvVerification`](/cua-sdk/reference/spaces/app-core/keyvault#kvverification-record)+**[Keyvault](/cua-sdk/reference/spaces/app-core/keyvault)**: `app_sensitive_group_sdk`, `AppSensitiveGroup`, `AppSensitiveOption`, `KeyvaultClient`, `KeyvaultOverview`, `kv_credential_form`, `kv_duration`, `kv_labels`, `kv_overview_from_json`, `kv_passphrase_check`, `kv_prune_dismissed`, `kv_recovery_key_text`, `kv_sharing_label`, `kv_signed_in_spaces`, `kv_space_access_key`, `kv_visible_sharing_label`, `KvAccessRequest`, `KvAuditEntry`, `KvCaller`, `KvCommand`, `KvCredentialForm`, `KvDelivery`, `KvDomainCount`, `KvFavicon`, `KvFormMode`, `KvGrant`, `KvInventory`, `KvItem`, `KvItemPolicy`, `KvLabels`, `KvMethod`, `KvOutcome`, `KvPassphraseCheck`, `KvPending`, `KvRule`, `KvRuleCaller`, `KvSelector`, `KvSigning`, `KvStatus`, `KvStrength`, `KvVerification`-**Share sheet**: [`app_share_action_from_json`](/cua-sdk/reference/spaces/app-core/share#app_share_action_from_json), [`app_share_initial`](/cua-sdk/reference/spaces/app-core/share#app_share_initial), [`app_share_input_from_json`](/cua-sdk/reference/spaces/app-core/share#app_share_input_from_json), [`app_share_reduce`](/cua-sdk/reference/spaces/app-core/share#app_share_reduce), [`app_share_state_from_json`](/cua-sdk/reference/spaces/app-core/share#app_share_state_from_json), [`app_share_view`](/cua-sdk/reference/spaces/app-core/share#app_share_view), [`AppRoleOption`](/cua-sdk/reference/spaces/app-core/share#approleoption-record), [`AppShareEntryInput`](/cua-sdk/reference/spaces/app-core/share#appshareentryinput-record), [`AppShareInput`](/cua-sdk/reference/spaces/app-core/share#appshareinput-record), [`AppShareRequest`](/cua-sdk/reference/spaces/app-core/share#appsharerequest-enum), [`AppShareRowView`](/cua-sdk/reference/spaces/app-core/share#appsharerowview-record), [`AppShareSheetAction`](/cua-sdk/reference/spaces/app-core/share#appsharesheetaction-enum), [`AppShareSheetState`](/cua-sdk/reference/spaces/app-core/share#appsharesheetstate-record), [`AppShareSheetView`](/cua-sdk/reference/spaces/app-core/share#appsharesheetview-record)+**[Share sheet](/cua-sdk/reference/spaces/app-core/share)**: `app_share_action_from_json`, `app_share_initial`, `app_share_input_from_json`, `app_share_reduce`, `app_share_state_from_json`, `app_share_view`, `AppRoleOption`, `AppShareEntryInput`, `AppShareInput`, `AppShareRequest`, `AppShareRowView`, `AppShareSheetAction`, `AppShareSheetState`, `AppShareSheetView`-**Run on**: [`app_space_host`](/cua-sdk/reference/spaces/app-core/run-on#app_space_host), [`app_wizard_placement_options`](/cua-sdk/reference/spaces/app-core/run-on#app_wizard_placement_options), [`AppPlacementOption`](/cua-sdk/reference/spaces/app-core/run-on#appplacementoption-record), [`AppSpaceHost`](/cua-sdk/reference/spaces/app-core/run-on#appspacehost-record)+**[Run on](/cua-sdk/reference/spaces/app-core/run-on)**: `app_space_host`, `app_wizard_placement_options`, `AppPlacementOption`, `AppSpaceHost`-**Usage telemetry**: [`app_telemetry_creates`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_creates), [`app_telemetry_enroll`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_enroll), [`app_telemetry_feature`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_feature), [`app_telemetry_launched`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_launched), [`app_telemetry_onboarding`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_onboarding), [`app_telemetry_onboarding_finished`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_onboarding_finished), [`app_telemetry_record`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_record), [`app_telemetry_share`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_share), [`app_telemetry_sign_in_failed`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_sign_in_failed), [`app_telemetry_start`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_start), [`app_telemetry_storage`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_storage), [`app_telemetry_welcome_left`](/cua-sdk/reference/spaces/app-core/telemetry#app_telemetry_welcome_left), [`AppTelemetrySignal`](/cua-sdk/reference/spaces/app-core/telemetry#apptelemetrysignal-enum)+**[Usage telemetry](/cua-sdk/reference/spaces/app-core/telemetry)**: `app_telemetry_creates`, `app_telemetry_enroll`, `app_telemetry_feature`, `app_telemetry_launched`, `app_telemetry_onboarding`, `app_telemetry_onboarding_finished`, `app_telemetry_record`, `app_telemetry_share`, `app_telemetry_sign_in_failed`, `app_telemetry_start`, `app_telemetry_storage`, `app_telemetry_welcome_left`, `AppTelemetrySignal`-**Teleport plan and run**: [`app_teleport_plan`](/cua-sdk/reference/spaces/app-core/teleport-run#app_teleport_plan), [`app_teleport_plan_from_json`](/cua-sdk/reference/spaces/app-core/teleport-run#app_teleport_plan_from_json), [`app_teleport_run_event`](/cua-sdk/reference/spaces/app-core/teleport-run#app_teleport_run_event), [`app_teleport_run_status`](/cua-sdk/reference/spaces/app-core/teleport-run#app_teleport_run_status), [`AppTeleportCapability`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportcapability-enum), [`AppTeleportConsent`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportconsent-record), [`AppTeleportMove`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportmove-enum), [`AppTeleportPlan`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportplan-record), [`AppTeleportRunEvent`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportrunevent-record), [`AppTeleportRunPhase`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportrunphase-enum), [`AppTeleportRunReport`](/cua-sdk/reference/spaces/app-core/teleport-run#appteleportrunreport-record)+**[Teleport plan and run](/cua-sdk/reference/spaces/app-core/teleport-run)**: `app_teleport_plan`, `app_teleport_plan_from_json`, `app_teleport_run_event`, `app_teleport_run_status`, `AppTeleportCapability`, `AppTeleportConsent`, `AppTeleportMove`, `AppTeleportPlan`, `AppTeleportRunEvent`, `AppTeleportRunPhase`, `AppTeleportRunReport`-**Teleport transfer and drag**: [`app_transfer_reduce`](/cua-sdk/reference/spaces/app-core/teleport-transfer#app_transfer_reduce), [`app_transfer_title`](/cua-sdk/reference/spaces/app-core/teleport-transfer#app_transfer_title), [`AppDragOverlayEffect`](/cua-sdk/reference/spaces/app-core/teleport-transfer#appdragoverlayeffect-enum), [`AppDragOverlayEvent`](/cua-sdk/reference/spaces/app-core/teleport-transfer#appdragoverlayevent-enum), [`AppDragOverlayPhase`](/cua-sdk/reference/spaces/app-core/teleport-transfer#appdragoverlayphase-enum), [`AppDragOverlayState`](/cua-sdk/reference/spaces/app-core/teleport-transfer#appdragoverlaystate-record), [`AppDragOverlayTransition`](/cua-sdk/reference/spaces/app-core/teleport-transfer#appdragoverlaytransition-record), [`AppTransferOverlayState`](/cua-sdk/reference/spaces/app-core/teleport-transfer#apptransferoverlaystate-record), [`AppTransferPhase`](/cua-sdk/reference/spaces/app-core/teleport-transfer#apptransferphase-enum), [`AppTransferSignal`](/cua-sdk/reference/spaces/app-core/teleport-transfer#apptransfersignal-record), [`AppTransferStatus`](/cua-sdk/reference/spaces/app-core/teleport-transfer#apptransferstatus-enum)+**[Teleport transfer and drag](/cua-sdk/reference/spaces/app-core/teleport-transfer)**: `app_transfer_reduce`, `app_transfer_title`, `AppDragOverlayEffect`, `AppDragOverlayEvent`, `AppDragOverlayPhase`, `AppDragOverlayState`, `AppDragOverlayTransition`, `AppTransferOverlayState`, `AppTransferPhase`, `AppTransferSignal`, `AppTransferStatus`-**New Space wizard**: [`app_wizard_action_from_json`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_action_from_json), [`app_wizard_create_args`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_create_args), [`app_wizard_create_failed_text`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_create_failed_text), [`app_wizard_creating_text`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_creating_text), [`app_wizard_env_from_json`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_env_from_json), [`app_wizard_image_suggestions`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_image_suggestions), [`app_wizard_initial`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_initial), [`app_wizard_reduce`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_reduce), [`app_wizard_validate_image_ref`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_validate_image_ref), [`app_wizard_view`](/cua-sdk/reference/spaces/app-core/new-space#app_wizard_view), [`AppAddressForm`](/cua-sdk/reference/spaces/app-core/new-space#appaddressform-record), [`AppAddressSubmit`](/cua-sdk/reference/spaces/app-core/new-space#appaddresssubmit-record), [`AppAddressView`](/cua-sdk/reference/spaces/app-core/new-space#appaddressview-record), [`AppCloudEngine`](/cua-sdk/reference/spaces/app-core/new-space#appcloudengine-enum), [`AppCloudPricing`](/cua-sdk/reference/spaces/app-core/new-space#appcloudpricing-record), [`AppCreatePlan`](/cua-sdk/reference/spaces/app-core/new-space#appcreateplan-record), [`AppCreateSpaceArgs`](/cua-sdk/reference/spaces/app-core/new-space#appcreatespaceargs-record), [`AppGpuChoice`](/cua-sdk/reference/spaces/app-core/new-space#appgpuchoice-record), [`AppGpuRow`](/cua-sdk/reference/spaces/app-core/new-space#appgpurow-record), [`AppKindOption`](/cua-sdk/reference/spaces/app-core/new-space#appkindoption-record), [`AppLocalEngine`](/cua-sdk/reference/spaces/app-core/new-space#applocalengine-enum), [`AppLocalStorage`](/cua-sdk/reference/spaces/app-core/new-space#applocalstorage-record), [`AppLocation`](/cua-sdk/reference/spaces/app-core/new-space#applocation-enum), [`AppMenuOption`](/cua-sdk/reference/spaces/app-core/new-space#appmenuoption-record), [`AppRuntime`](/cua-sdk/reference/spaces/app-core/new-space#appruntime-enum), [`AppRuntimeSwitch`](/cua-sdk/reference/spaces/app-core/new-space#appruntimeswitch-record), [`AppStepDot`](/cua-sdk/reference/spaces/app-core/new-space#appstepdot-record), [`AppStepState`](/cua-sdk/reference/spaces/app-core/new-space#appstepstate-enum), [`AppStepView`](/cua-sdk/reference/spaces/app-core/new-space#appstepview-record), [`AppStorageVolume`](/cua-sdk/reference/spaces/app-core/new-space#appstoragevolume-record), [`AppTile`](/cua-sdk/reference/spaces/app-core/new-space#apptile-record), [`AppWizardAction`](/cua-sdk/reference/spaces/app-core/new-space#appwizardaction-enum), [`AppWizardEnv`](/cua-sdk/reference/spaces/app-core/new-space#appwizardenv-record), [`AppWizardFact`](/cua-sdk/reference/spaces/app-core/new-space#appwizardfact-record), [`AppWizardField`](/cua-sdk/reference/spaces/app-core/new-space#appwizardfield-record), [`AppWizardLabels`](/cua-sdk/reference/spaces/app-core/new-space#appwizardlabels-record), [`AppWizardMode`](/cua-sdk/reference/spaces/app-core/new-space#appwizardmode-enum), [`AppWizardState`](/cua-sdk/reference/spaces/app-core/new-space#appwizardstate-record), [`AppWizardView`](/cua-sdk/reference/spaces/app-core/new-space#appwizardview-record)+**[New Space wizard](/cua-sdk/reference/spaces/app-core/new-space)**: `app_wizard_action_from_json`, `app_wizard_create_args`, `app_wizard_create_failed_text`, `app_wizard_creating_text`, `app_wizard_env_from_json`, `app_wizard_image_suggestions`, `app_wizard_initial`, `app_wizard_reduce`, `app_wizard_validate_image_ref`, `app_wizard_view`, `AppAddressForm`, `AppAddressSubmit`, `AppAddressView`, `AppCloudEngine`, `AppCloudPricing`, `AppCreatePlan`, `AppCreateSpaceArgs`, `AppGpuChoice`, `AppGpuRow`, `AppKindOption`, `AppLocalEngine`, `AppLocalStorage`, `AppLocation`, `AppMenuOption`, `AppRuntime`, `AppRuntimeSwitch`, `AppStepDot`, `AppStepState`, `AppStepView`, `AppStorageVolume`, `AppTile`, `AppWizardAction`, `AppWizardEnv`, `AppWizardFact`, `AppWizardField`, `AppWizardLabels`, `AppWizardMode`, `AppWizardState`, `AppWizardView`-**Image catalog**: [`AppImageDistro`](/cua-sdk/reference/spaces/app-core/images#appimagedistro-record), [`AppImageFieldView`](/cua-sdk/reference/spaces/app-core/images#appimagefieldview-record), [`AppImageGroup`](/cua-sdk/reference/spaces/app-core/images#appimagegroup-record), [`AppImageSizes`](/cua-sdk/reference/spaces/app-core/images#appimagesizes-record), [`AppImageSuggestion`](/cua-sdk/reference/spaces/app-core/images#appimagesuggestion-record), [`AppImageTier`](/cua-sdk/reference/spaces/app-core/images#appimagetier-enum), [`AppPlatformSize`](/cua-sdk/reference/spaces/app-core/images#appplatformsize-record), [`AppSandboxImage`](/cua-sdk/reference/spaces/app-core/images#appsandboximage-record), [`AppSuggestionGroup`](/cua-sdk/reference/spaces/app-core/images#appsuggestiongroup-record)+**[Image catalog](/cua-sdk/reference/spaces/app-core/images)**: `AppImageDistro`, `AppImageFieldView`, `AppImageGroup`, `AppImageSizes`, `AppImageSuggestion`, `AppImageTier`, `AppPlatformSize`, `AppSandboxImage`, `AppSuggestionGroup`**Spaces app core**: [`cua_spaces_register`](#cua_spaces_register)-**Keyvault screens**: [`kv_approval_approve_command`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_approval_approve_command), [`kv_approval_deny_command`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_approval_deny_command), [`kv_approval_open`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_approval_open), [`kv_approval_reduce`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_approval_reduce), [`kv_approval_view`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_approval_view), [`kv_delete_command`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_delete_command), [`kv_delete_confirm`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_delete_confirm), [`kv_list`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_list), [`kv_live_copy_spaces`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_live_copy_spaces), [`kv_lock_command`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_lock_command), [`kv_page`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_page), [`kv_sidebar`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_sidebar), [`kv_unlock_command`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_unlock_command), [`kv_unlock_prompt`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_unlock_prompt), [`kv_unlock_prompt_always`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_unlock_prompt_always), [`kv_vault_prune`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_vault_prune), [`kv_vault_reduce`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_vault_reduce), [`kv_vault_source`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_vault_source), [`kv_vault_view`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kv_vault_view), [`KvAccessKind`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvaccesskind-enum), [`KvAccessRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvaccessrow-record), [`KvApprovalAction`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvapprovalaction-enum), [`KvApprovalRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvapprovalrow-record), [`KvApprovalState`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvapprovalstate-record), [`KvApprovalView`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvapprovalview-record), [`KvAppRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvapprow-record), [`KvCategory`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvcategory-enum), [`KvCategoryRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvcategoryrow-record), [`KvDecision`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvdecision-record), [`KvDecisionTone`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvdecisiontone-enum), [`KvDeleteConfirm`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvdeleteconfirm-record), [`KvKind`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvkind-enum), [`KvListView`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvlistview-record), [`KvLock`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvlock-enum), [`KvPage`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvpage-record), [`KvPendingRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvpendingrow-record), [`KvRecentRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvrecentrow-record), [`KvSelection`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvselection-enum), [`KvSidebar`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvsidebar-record), [`KvSigningBadge`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvsigningbadge-record), [`KvTone`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvtone-enum), [`KvTri`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvtri-enum), [`KvUnlockPrompt`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvunlockprompt-record), [`KvVaultAction`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultaction-enum), [`KvVaultApp`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultapp-record), [`KvVaultFiles`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultfiles-record), [`KvVaultRow`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultrow-record), [`KvVaultSelection`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultselection-record), [`KvVaultSite`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultsite-record), [`KvVaultSource`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultsource-record), [`KvVaultState`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultstate-record), [`KvVaultView`](/cua-sdk/reference/spaces/app-core/keyvault-screens#kvvaultview-record)+**[Keyvault screens](/cua-sdk/reference/spaces/app-core/keyvault-screens)**: `kv_approval_approve_command`, `kv_approval_deny_command`, `kv_approval_open`, `kv_approval_reduce`, `kv_approval_view`, `kv_delete_command`, `kv_delete_confirm`, `kv_list`, `kv_live_copy_spaces`, `kv_lock_command`, `kv_page`, `kv_sidebar`, `kv_unlock_command`, `kv_unlock_prompt`, `kv_unlock_prompt_always`, `kv_vault_prune`, `kv_vault_reduce`, `kv_vault_source`, `kv_vault_view`, `KvAccessKind`, `KvAccessRow`, `KvApprovalAction`, `KvApprovalRow`, `KvApprovalState`, `KvApprovalView`, `KvAppRow`, `KvCategory`, `KvCategoryRow`, `KvDecision`, `KvDecisionTone`, `KvDeleteConfirm`, `KvKind`, `KvListView`, `KvLock`, `KvPage`, `KvPendingRow`, `KvRecentRow`, `KvSelection`, `KvSidebar`, `KvSigningBadge`, `KvTone`, `KvTri`, `KvUnlockPrompt`, `KvVaultAction`, `KvVaultApp`, `KvVaultFiles`, `KvVaultRow`, `KvVaultSelection`, `KvVaultSite`, `KvVaultSource`, `KvVaultState`, `KvVaultView`diff --git a/docs/content/docs/cua-sdk/reference/spaces/app-core/onboarding-settings.mdx b/docs/content/docs/cua-sdk/reference/spaces/app-core/onboarding-settings.mdxindex 62820a6c1a..80cc4e3baf 100644--- a/docs/content/docs/cua-sdk/reference/spaces/app-core/onboarding-settings.mdx+++ b/docs/content/docs/cua-sdk/reference/spaces/app-core/onboarding-settings.mdx@@ -318,7 +318,7 @@ Returned by [`app_presentation_preview_frame`](#app_presentation_preview_frame),## `AppSettings` record-Returned by [`app_settings_load`](#app_settings_load).+Returned by [`app_settings_choose_experiment`](/cua-sdk/reference/spaces/app-core/experiments#app_settings_choose_experiment), [`app_settings_load`](#app_settings_load), [`app_settings_resolve_new_ui`](/cua-sdk/reference/spaces/app-core/experiments#app_settings_resolve_new_ui).| Field | Type | Default | Description || --- | --- | --- | --- |@@ -331,7 +331,8 @@ Returned by [`app_settings_load`](#app_settings_load).| `last_seen_version` / `lastSeenVersion` | `Option<String>` | | The version and build the app last launched as (`crate.about.identity`; `None`: never recorded). A launch as another one follows an update (`crate.about.after_launch`). || `update_channel` / `updateChannel` | [`AppUpdateChannel`](/cua-sdk/reference/spaces/app-core/about#appupdatechannel-enum) | | Which releases the updater offers (Settings, About). || `launch_at_login` / `launchAtLogin` | `Option<bool>` | | Launch at login, as the user chose it (the first run's Done page or Settings); `None`: never chosen (`crate.login_item.launch_plan`). |-| `experiments` | [`AppExperiments`](/cua-sdk/reference/spaces/app-core/experiments#appexperiments-record) | | Settings, Experiments: every switch off unless turned on (`crate.experiments`). |+| `experiments` | [`AppExperiments`](/cua-sdk/reference/spaces/app-core/experiments#appexperiments-record) | | Settings, Experiments: every switch off unless turned on (`crate.experiments`). Its `webUi` is the New UI as this launch shows it (`resolve_new_ui`); the file keeps only `Self.new_ui`'s "on" there, the value older builds read. |+| `new_ui` / `newUi` | `Option<bool>` | | The New UI as the user chose it (Settings, Experiments, "Use classic UI"); `None`: never chosen, so `crate.experiments.new_ui_default` decides. An older build's saved `webUi: true` reads as `Some(true)`; its `false` was only the saved default, so it reads as never chosen (`load`). || `dismissed_access` / `dismissedAccess` | `Vec<String>` | | Keyvault copies (import ids) the user dismissed from the notch: it no longer shows them, nothing is revoked or wiped (`crate.keyvault.view.prune_dismissed` forgets the gone ones). || `keyvault_site_icons` / `keyvaultSiteIcons` | `bool` | | Keyvault rows may load a site's icon from Google's favicon service when the source browser had none (Settings, Keyvault; on by default). Off, only icons read locally are shown. || `teleport_choices` / `teleportChoices` | [`Vec<AppRememberedChoice>`](/cua-sdk/reference/spaces/app-core/teleport-review#apprememberedchoice-record) | | The sites the user sent to each Space last time, per app (`crate.teleport.review.remember`): the review starts from them. |diff --git a/docs/content/docs/cua-sdk/reference/spaces/volume-app-core.mdx b/docs/content/docs/cua-sdk/reference/spaces/volume-app-core.mdxindex 5bf2eb01aa..e09cf5652f 100644--- a/docs/content/docs/cua-sdk/reference/spaces/volume-app-core.mdx+++ b/docs/content/docs/cua-sdk/reference/spaces/volume-app-core.mdx@@ -858,6 +858,6 @@ pub fn app_storage_update_json(update: AppDriveStorageUpdate) -> String## All items-37 items, across this page and its subpages, grouped by page. Methods are listed on their object.+37 items, across this page and its subpages, grouped by page (each item's section is on its page). Methods are listed on their object.**App core: Cua Volume storage, mount and sync**: [`app_drive_mount_from_json`](#app_drive_mount_from_json), [`app_drive_mount_preview`](#app_drive_mount_preview), [`app_drive_mount_preview_frame`](#app_drive_mount_preview_frame), [`app_drive_mount_preview_still`](#app_drive_mount_preview_still), [`app_drive_sync_from_json`](#app_drive_sync_from_json), [`app_storage_action_from_json`](#app_storage_action_from_json), [`app_storage_choose`](#app_storage_choose), [`app_storage_edit`](#app_storage_edit), [`app_storage_initial`](#app_storage_initial), [`app_storage_input_from_json`](#app_storage_input_from_json), [`app_storage_press`](#app_storage_press), [`app_storage_reduce`](#app_storage_reduce), [`app_storage_request_text`](#app_storage_request_text), [`app_storage_section`](#app_storage_section), [`app_storage_state_from_json`](#app_storage_state_from_json), [`app_storage_update_json`](#app_storage_update_json), [`AppConflictView`](#appconflictview-record), [`AppDriveCacheInput`](#appdrivecacheinput-record), [`AppDriveCard`](#appdrivecard-record), [`AppDriveCheckInput`](#appdrivecheckinput-record), [`AppDriveConflictInput`](#appdriveconflictinput-record), [`AppDriveDeviceInput`](#appdrivedeviceinput-record), [`AppDriveMountFrame`](#appdrivemountframe-record), [`AppDriveMountInput`](#appdrivemountinput-record), [`AppDriveMountPreview`](#appdrivemountpreview-record), [`AppDriveS3Input`](#appdrives3input-record), [`AppDriveStepRequest`](#appdrivesteprequest-enum), [`AppDriveStorageInput`](#appdrivestorageinput-record), [`AppDriveStorageUpdate`](#appdrivestorageupdate-record), [`AppDriveSyncInput`](#appdrivesyncinput-record), [`AppStorageAction`](#appstorageaction-enum), [`AppStorageChoice`](#appstoragechoice-enum), [`AppStorageField`](#appstoragefield-enum), [`AppStorageForm`](#appstorageform-record), [`AppStorageInput`](#appstorageinput-record), [`AppStorageRequest`](#appstoragerequest-enum), [`AppStorageState`](#appstoragestate-record)diff --git a/docs/content/docs/cua-sdk/reference/types.mdx b/docs/content/docs/cua-sdk/reference/types.mdxindex 933a4bbecb..4eff2b3df7 100644--- a/docs/content/docs/cua-sdk/reference/types.mdx+++ b/docs/content/docs/cua-sdk/reference/types.mdx@@ -50,7 +50,7 @@ Renamed members: in Kotlin, objects implement `AutoCloseable`, whose `close()` f292 items. Methods are listed on their object.-The 756 items of the Cua Spaces app export (source-available, FSL-1.1-MIT, Swift only) are listed on their pages: [Decoded media](/cua-sdk/reference/spaces/decoded-media), [Host teleport](/cua-sdk/reference/spaces/teleport-host), [Teleport an app](/cua-sdk/reference/spaces/teleport-apps), [Spaces app core](/cua-sdk/reference/spaces/app-core#all-items), [App core: Cua Volume storage, mount and sync](/cua-sdk/reference/spaces/volume-app-core#all-items), [App core: agents, drive, notifications](/cua-sdk/reference/spaces/agents-app-core#all-items), [Getting started and the command palette](/cua-sdk/reference/spaces/app-checklist-palette).+The 759 items of the Cua Spaces app export (source-available, FSL-1.1-MIT, Swift only) are listed on their pages: [Decoded media](/cua-sdk/reference/spaces/decoded-media), [Host teleport](/cua-sdk/reference/spaces/teleport-host), [Teleport an app](/cua-sdk/reference/spaces/teleport-apps), [Spaces app core](/cua-sdk/reference/spaces/app-core#all-items), [App core: Cua Volume storage, mount and sync](/cua-sdk/reference/spaces/volume-app-core#all-items), [App core: agents, drive, notifications](/cua-sdk/reference/spaces/agents-app-core#all-items), [Getting started and the command palette](/cua-sdk/reference/spaces/app-checklist-palette).| Item | Kind | Summary || --- | --- | --- |diff --git a/libs/cua/crates/cua-spaces-app-core/parity/experiments.json b/libs/cua/crates/cua-spaces-app-core/parity/experiments.jsonindex 9b9ab0813f..966827691d 100644--- a/libs/cua/crates/cua-spaces-app-core/parity/experiments.json+++ b/libs/cua/crates/cua-spaces-app-core/parity/experiments.json@@ -10,7 +10,9 @@{ "step": "another row changes nothing", "row": "notch", "option": "hide" },{ "step": "cua volume off", "row": "experiment:cua_volume", "option": "off" },{ "step": "your cloud off", "row": "experiment:your_cloud", "option": "off" },- { "step": "sharing off", "row": "experiment:sharing", "option": "off" }+ { "step": "sharing off", "row": "experiment:sharing", "option": "off" },+ { "step": "new ui on (use classic ui off)", "row": "experiment:classic_ui", "option": "off" },+ { "step": "use classic ui on", "row": "experiment:classic_ui", "option": "on" }],"settings": {"identity": "[email protected]",diff --git a/libs/cua/crates/cua-spaces-app-core/parity/golden/experiments.json b/libs/cua/crates/cua-spaces-app-core/parity/golden/experiments.jsonindex d642471272..8cfff40a6b 100644--- a/libs/cua/crates/cua-spaces-app-core/parity/golden/experiments.json+++ b/libs/cua/crates/cua-spaces-app-core/parity/golden/experiments.json@@ -87,8 +87,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {On|*Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": null,"wizard": {@@ -213,8 +213,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {On|*Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": "Volume","wizard": {@@ -340,8 +340,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {On|*Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": "Volume","wizard": {@@ -472,8 +472,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {*On|Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": "Volume","wizard": {@@ -590,8 +590,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {*On|Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": "Volume","wizard": {@@ -708,8 +708,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {*On|Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": "Volume","wizard": {@@ -831,8 +831,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {*On|Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": null,"wizard": {@@ -953,8 +953,8 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {*On|Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": null,"wizard": {@@ -1069,8 +1069,242 @@"- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.","- experiment:sharing toggle: Sharing {On|*Off}","- experiment:sharing-note note: Share a Space with other Cua accounts.",- "- experiment:web_ui toggle: New UI (preview) {On|*Off}",- "- experiment:web_ui-note note: Try the new Spaces window, built on the shared web UI."+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."+ ],+ "volumePage": null,+ "wizard": {+ "fields": [+ "os",+ "image",+ "placement",+ "kind",+ "runtime",+ "connect-by-address"+ ],+ "placements": [+ "local | This Mac | Container on this Mac (gVisor when installed) | on *",+ "---",+ "host:m-mini | Mac mini | Through the Cua relay | on"+ ]+ }+ },+ {+ "actions": [+ "teleport: Teleport an app [arrow.down.circle] ?Teleport an app into this Space",+ "pip: Picture in picture [pip.enter] ?Picture in picture",+ "delete: Remove [trash] ?Remove from the list (destructive)",+ "open: Open [-] ?Open the desktop in its own window (primary)"+ ],+ "menu": [+ "status: No Spaces (disabled)",+ "---",+ "open: Open Cua Spaces",+ "new-space: New Space…",+ "settings: Settings… ⌘,",+ "---",+ "quit: Quit Cua Spaces ⌘Q"+ ],+ "onboarding": {+ "done": {+ "canBack": true,+ "canSkip": false,+ "choices": [],+ "dots": "Welcome,Sign in,AI agents,Menu bar,This machine,*Done",+ "drive": null,+ "driveStorage": null,+ "launchAtLogin": "[ ] Launch at login ~Keeps your Spaces and agents available after a restart.",+ "lede": "Cua Spaces is in your menu bar.",+ "notice": null,+ "noticeLink": null,+ "presentations": [],+ "primary": "Start using Cua Spaces",+ "prompts": [+ "qa my app on windows, macos and linux",+ "use the cua sdk to build an agent app that runs codex in a space",+ "open my app in a space and pip it",+ "use the cua sdk to stream a space's window into my app",+ "teleport my browser into a space and finish the checkout test",+ "use the cua docs to set up a cua bench taskset",+ "spin up a linux space and run the test suite there"+ ],+ "showMark": false,+ "step": "done",+ "summary": [+ "cua command: not installed",+ "Account: not signed in",+ "AI agents: none",+ "Shows in: Notch and menu bar",+ "This machine: Access other machines"+ ],+ "title": "You're all set",+ "usage": null+ },+ "pages": [+ "welcome",+ "signin",+ "agents",+ "presentation",+ "mode",+ "done"+ ]+ },+ "settings": [+ "= Settings",+ "# Account (account)",+ "- account text: [email protected] [Sign out]",+ "- teams text: Teams = Coming soon [Join the waitlist] < https://cua.ai/teams>",+ "# General (general)",+ "- launch-at-login toggle: Launch Cua Spaces at login {*On|Off}",+ "- launch-at-login-note note: Keeps your Spaces and agents available after a restart.",+ "- notch choice: Spaces tab in the notch {*Show|Hide}",+ "- welcome text: Welcome [Show again]",+ "# Privacy (privacy)",+ "- telemetry choice: Share anonymous usage data {*On|Off}",+ "- telemetry-note note: Features used, sandbox types, durations and error categories. Never paths, names, prompts, screen content or Keyvault items. <What is collected https://cua.ai/docs/cua-sdk/concepts/telemetry>",+ "# AI agents (agents) [Configure all detected agents] (disabled)"+ ],+ "signals": [+ {+ "action": "experiment_on",+ "experiment": "web_ui",+ "type": "experiment"+ },+ {+ "experiments": [+ "web_ui"+ ],+ "type": "experiments-on"+ }+ ],+ "step": "new ui on (use classic ui off)",+ "tab": [+ "= Experiments",+ "# Experiments (experiments)",+ "- experiment:cua_volume toggle: Cua Volume {On|*Off}",+ "- experiment:cua_volume-note note: Memory and files your agents share across every Space.",+ "- experiment:your_cloud toggle: Your cloud {On|*Off}",+ "- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.",+ "- experiment:sharing toggle: Sharing {On|*Off}",+ "- experiment:sharing-note note: Share a Space with other Cua accounts.",+ "- experiment:classic_ui toggle: Use classic UI {On|*Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."+ ],+ "volumePage": null,+ "wizard": {+ "fields": [+ "os",+ "image",+ "placement",+ "kind",+ "runtime",+ "connect-by-address"+ ],+ "placements": [+ "local | This Mac | Container on this Mac (gVisor when installed) | on *",+ "---",+ "host:m-mini | Mac mini | Through the Cua relay | on"+ ]+ }+ },+ {+ "actions": [+ "teleport: Teleport an app [arrow.down.circle] ?Teleport an app into this Space",+ "pip: Picture in picture [pip.enter] ?Picture in picture",+ "delete: Remove [trash] ?Remove from the list (destructive)",+ "open: Open [-] ?Open the desktop in its own window (primary)"+ ],+ "menu": [+ "status: No Spaces (disabled)",+ "---",+ "open: Open Cua Spaces",+ "new-space: New Space…",+ "settings: Settings… ⌘,",+ "---",+ "quit: Quit Cua Spaces ⌘Q"+ ],+ "onboarding": {+ "done": {+ "canBack": true,+ "canSkip": false,+ "choices": [],+ "dots": "Welcome,Sign in,AI agents,Menu bar,This machine,*Done",+ "drive": null,+ "driveStorage": null,+ "launchAtLogin": "[ ] Launch at login ~Keeps your Spaces and agents available after a restart.",+ "lede": "Cua Spaces is in your menu bar.",+ "notice": null,+ "noticeLink": null,+ "presentations": [],+ "primary": "Start using Cua Spaces",+ "prompts": [+ "qa my app on windows, macos and linux",+ "use the cua sdk to build an agent app that runs codex in a space",+ "open my app in a space and pip it",+ "use the cua sdk to stream a space's window into my app",+ "teleport my browser into a space and finish the checkout test",+ "use the cua docs to set up a cua bench taskset",+ "spin up a linux space and run the test suite there"+ ],+ "showMark": false,+ "step": "done",+ "summary": [+ "cua command: not installed",+ "Account: not signed in",+ "AI agents: none",+ "Shows in: Notch and menu bar",+ "This machine: Access other machines"+ ],+ "title": "You're all set",+ "usage": null+ },+ "pages": [+ "welcome",+ "signin",+ "agents",+ "presentation",+ "mode",+ "done"+ ]+ },+ "settings": [+ "= Settings",+ "# Account (account)",+ "- account text: [email protected] [Sign out]",+ "- teams text: Teams = Coming soon [Join the waitlist] < https://cua.ai/teams>",+ "# General (general)",+ "- launch-at-login toggle: Launch Cua Spaces at login {*On|Off}",+ "- launch-at-login-note note: Keeps your Spaces and agents available after a restart.",+ "- notch choice: Spaces tab in the notch {*Show|Hide}",+ "- welcome text: Welcome [Show again]",+ "# Privacy (privacy)",+ "- telemetry choice: Share anonymous usage data {*On|Off}",+ "- telemetry-note note: Features used, sandbox types, durations and error categories. Never paths, names, prompts, screen content or Keyvault items. <What is collected https://cua.ai/docs/cua-sdk/concepts/telemetry>",+ "# AI agents (agents) [Configure all detected agents] (disabled)"+ ],+ "signals": [+ {+ "action": "experiment_off",+ "experiment": "web_ui",+ "type": "experiment"+ },+ {+ "experiments": [],+ "type": "experiments-on"+ }+ ],+ "step": "use classic ui on",+ "tab": [+ "= Experiments",+ "# Experiments (experiments)",+ "- experiment:cua_volume toggle: Cua Volume {On|*Off}",+ "- experiment:cua_volume-note note: Memory and files your agents share across every Space.",+ "- experiment:your_cloud toggle: Your cloud {On|*Off}",+ "- experiment:your_cloud-note note: Create Spaces in your own AWS, Google Cloud or Modal account.",+ "- experiment:sharing toggle: Sharing {On|*Off}",+ "- experiment:sharing-note note: Share a Space with other Cua accounts.",+ "- experiment:classic_ui toggle: Use classic UI {*On|Off}",+ "- experiment:classic_ui-note note: Open the previous Spaces window instead of the New UI."],"volumePage": null,"wizard": {diff --git a/libs/cua/crates/cua-spaces-app-core/src/experiments.rs b/libs/cua/crates/cua-spaces-app-core/src/experiments.rsindex 91b09ae74e..aefce1d2ce 100644--- a/libs/cua/crates/cua-spaces-app-core/src/experiments.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/experiments.rs@@ -2,7 +2,8 @@// Copyright (c) 2026 Cua AI, Inc.//! Settings, Experiments: features still being built, one switch each, all-//! off by default.+//! off by default except the New UI, which [`new_ui_default`] turns on for+//! the Beta channel and then for every release.//!//! - Cua Volume ([`Experiment::CuaVolume`]): the first run's Volume page//! (and its Done line) and Settings' Storage section;@@ -10,8 +11,9 @@//! connected clouds (AWS, Google Cloud, Modal), "Connect a cloud…" and a//! default location in a cloud;//! - Sharing ([`Experiment::Sharing`]): a Space's Share button;-//! - New UI (preview) ([`Experiment::WebUi`]): the shared web UI in a-//! window of its own (the macOS shell's "Open New UI (preview)").+//! - New UI ([`Experiment::WebUi`]): the shared web UI as the main window+//! (the macOS shell). Settings shows it as "Use classic UI"+//! ([`CLASSIC_UI_ROW`]), the way back to the SwiftUI window.//!//! Off only hides the entry points. Nothing is undone: a mounted Volume//! stays mounted (and keeps syncing), a connected cloud stays connected@@ -21,9 +23,16 @@//! The switches live in the app's settings ([`crate::settings::AppSettings`],//! `experiments`): one key per experiment, missing keys read as off and//! unknown ones are ignored, so an older or newer build reads the file.+//!+//! The New UI is the one switch with a default of its own: `web_ui` is+//! what this launch shows, the user's own choice lives in+//! [`crate::settings::AppSettings::new_ui`] and, without one,+//! [`new_ui_default`] decides ([`crate::settings::resolve_new_ui`]).use serde::{Deserialize, Serialize};+use crate::about::UpdateChannel;+use crate::settings::{SettingsOption, SettingsPage, SettingsRow, SettingsRowKind, SettingsSection,};@@ -38,7 +47,8 @@ pub struct Experiments {pub your_cloud: bool,/// Sharing a Space with other accounts.pub sharing: bool,- /// The shared web UI, previewed in its own window.+ /// The New UI (the shared web UI) is the main window: the user's choice+ /// or, without one, [`new_ui_default`] ([`crate::settings::resolve_new_ui`]).pub web_ui: bool,}@@ -87,7 +97,7 @@ impl Experiment {Experiment::CuaVolume => "Cua Volume",Experiment::YourCloud => "Your cloud",Experiment::Sharing => "Sharing",- Experiment::WebUi => "New UI (preview)",+ Experiment::WebUi => "New UI",}}@@ -99,7 +109,7 @@ impl Experiment {"Create Spaces in your own AWS, Google Cloud or Modal account."}Experiment::Sharing => "Share a Space with other Cua accounts.",- Experiment::WebUi => "Try the new Spaces window, built on the shared web UI.",+ Experiment::WebUi => "The Spaces window built on the shared web UI.",}}}@@ -151,10 +161,140 @@ pub fn of_row(id: &str) -> Option<Experiment> {id.strip_prefix("experiment:").and_then(Experiment::parse)}+/// The New UI's row on the Experiments tab: "Use classic UI", on while the+/// New UI is off. (`experiment:web_ui`, on for the New UI, is still read.)+pub const CLASSIC_UI_ROW: &str = "experiment:classic_ui";++/// From this version the New UI is on by default for the Beta channel:+/// every 0.8.1 prerelease (`0.8.1-0` is the lowest SemVer allows; 0.8.0+/// shipped without the default).+pub const NEW_UI_BETA_FROM: &str = "0.8.1-0";++/// The first release with the New UI on by default on every channel.+pub const NEW_UI_ALL_FROM: &str = "0.8.1";++/// Whether the New UI is on for someone who never chose: on the Beta+/// channel from [`NEW_UI_BETA_FROM`], everywhere from [`NEW_UI_ALL_FROM`]+/// (so 0.8.1 turns it on for Stable with no change here). `version` is the+/// running app's (`0.8.1-beta.1`); one that does not read as a version+/// (a dev build's, or none) keeps the classic UI.+pub fn new_ui_default(channel: UpdateChannel, version: &str) -> bool {+ let Some(v) = Version::parse(version) else {+ return false;+ };+ let at_least = |from: &str| Version::parse(from).is_some_and(|f| v >= f);+ at_least(NEW_UI_ALL_FROM) || (channel == UpdateChannel::Beta && at_least(NEW_UI_BETA_FROM))+}++/// The New UI choice a row's option makes: `Some(on)` for the New UI's+/// row ("Use classic UI" on is the New UI off), `None` for any other row or+/// option. The shell saves it as [`crate::settings::AppSettings::new_ui`].+pub fn new_ui_choice(row: &str, option: &str) -> Option<bool> {+ match (row, option) {+ (CLASSIC_UI_ROW, "on") => Some(false),+ (CLASSIC_UI_ROW, "off") => Some(true),+ (r, "on") if of_row(r) == Some(Experiment::WebUi) => Some(true),+ (r, "off") if of_row(r) == Some(Experiment::WebUi) => Some(false),+ _ => None,+ }+}++/// A release version, compared as SemVer does (`0.8.0-beta.6` < `0.8.0`;+/// build metadata after `+` ignored).+#[derive(Debug, Clone, PartialEq, Eq)]+struct Version {+ core: [u64; 3],+ pre: Vec<PreId>,+}++#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]+enum PreId {+ // Numeric identifiers sort before alphanumeric ones.+ Num(u64),+ Alpha(String),+}++impl Version {+ fn parse(s: &str) -> Option<Self> {+ let s = s.trim().trim_start_matches('v');+ let s = s.split('+').next()?;+ let (core, pre) = match s.split_once('-') {+ Some((c, p)) => (c, Some(p)),+ None => (s, None),+ };+ let mut parts = core.split('.');+ let mut n = [0u64; 3];+ for slot in &mut n {+ *slot = parts.next()?.parse().ok()?;+ }+ if parts.next().is_some() {+ return None;+ }+ let pre = match pre {+ None => vec![],+ Some(p) => p+ .split('.')+ .map(|id| match id.parse() {+ Ok(n) => Some(PreId::Num(n)),+ Err(_) if !id.is_empty() => Some(PreId::Alpha(id.to_string())),+ Err(_) => None,+ })+ .collect::<Option<Vec<_>>>()?,+ };+ Some(Self { core: n, pre })+ }+}++impl PartialOrd for Version {+ fn partial_cmp(&self, other: &Self) -> Option<std::cmp::Ordering> {+ Some(self.cmp(other))+ }+}++impl Ord for Version {+ fn cmp(&self, other: &Self) -> std::cmp::Ordering {+ use std::cmp::Ordering;+ self.core.cmp(&other.core).then_with(|| {+ match (self.pre.is_empty(), other.pre.is_empty()) {+ (true, true) => Ordering::Equal,+ // A release sorts after its prereleases.+ (true, false) => Ordering::Greater,+ (false, true) => Ordering::Less,+ (false, false) => self.pre.cmp(&other.pre),+ }+ })+ }+}+/// The Experiments tab: one switch per experiment, each with its one line.pub fn page(experiments: &Experiments) -> SettingsPage {let mut rows = Vec::new();for e in ALL {+ if e == Experiment::WebUi {+ // "Use classic UI": on while the New UI is off.+ let classic = !experiments.web_ui;+ let mut toggle =+ crate::settings::row(CLASSIC_UI_ROW, SettingsRowKind::Toggle, "Use classic UI");+ toggle.options = vec![+ SettingsOption {+ id: "on".into(),+ label: "On".into(),+ active: classic,+ },+ SettingsOption {+ id: "off".into(),+ label: "Off".into(),+ active: !classic,+ },+ ];+ rows.push(toggle);+ rows.push(crate::settings::row(+ &format!("{CLASSIC_UI_ROW}-note"),+ SettingsRowKind::Note,+ "Open the previous Spaces window instead of the New UI.",+ ));+ continue;+ }let on = experiments.is_on(e);let mut toggle = crate::settings::row(&row_id(e), SettingsRowKind::Toggle, e.title());toggle.options = vec![@@ -192,6 +332,9 @@ pub fn page(experiments: &Experiments) -> SettingsPage {/// The switches after a row's choice (`on` or `off`); unchanged for any/// other row or option.pub fn choose(experiments: &Experiments, row: &str, option: &str) -> Experiments {+ if let Some(on) = new_ui_choice(row, option) {+ return experiments.with(Experiment::WebUi, on);+ }match (of_row(row), option) {(Some(e), "on") => experiments.with(e, true),(Some(e), "off") => experiments.with(e, false),@@ -226,13 +369,15 @@ mod tests {"experiment:your_cloud-note","experiment:sharing","experiment:sharing-note",- "experiment:web_ui",- "experiment:web_ui-note",+ "experiment:classic_ui",+ "experiment:classic_ui-note",]);for r in switches(&p) {+ // Off, the New UI shows as "Use classic UI" on.+ let shown = if r.id == CLASSIC_UI_ROW { "on" } else { "off" };assert!(- r.options.iter().any(|o| o.id == "off" && o.active),+ r.options.iter().any(|o| o.id == shown && o.active),"{}",r.id);@@ -267,6 +412,106 @@ mod tests {);}+ #[test]+ fn use_classic_ui_is_the_new_ui_switch_inverted() {+ let on = Experiments {+ web_ui: true,+ ..Default::default()+ };+ let row = |x: &Experiments| {+ let p = page(x);+ let r = switches(&p)+ .into_iter()+ .find(|r| r.id == CLASSIC_UI_ROW)+ .cloned()+ .unwrap();+ (+ r.label.clone(),+ r.options.iter().find(|o| o.active).unwrap().id.clone(),+ )+ };+ assert_eq!(row(&on), ("Use classic UI".to_string(), "off".to_string()));+ assert_eq!(row(&Experiments::default()).1, "on");+ // Classic on is the New UI off, and back.+ assert_eq!(choose(&on, CLASSIC_UI_ROW, "on"), Experiments::default());+ assert_eq!(choose(&Experiments::default(), CLASSIC_UI_ROW, "off"), on);+ // The older row id still means the New UI itself.+ assert_eq!(+ choose(&Experiments::default(), "experiment:web_ui", "on"),+ on+ );+ assert_eq!(+ choose(&on, "experiment:web_ui", "off"),+ Experiments::default()+ );+ assert_eq!(new_ui_choice(CLASSIC_UI_ROW, "on"), Some(false));+ assert_eq!(new_ui_choice(CLASSIC_UI_ROW, "off"), Some(true));+ assert_eq!(new_ui_choice("experiment:web_ui", "on"), Some(true));+ assert_eq!(new_ui_choice("experiment:sharing", "on"), None);+ assert_eq!(new_ui_choice(CLASSIC_UI_ROW, "maybe"), None);+ }++ #[test]+ fn the_new_ui_is_on_for_beta_from_0_8_1_betas_and_for_everyone_from_0_8_1() {+ use UpdateChannel::{Beta, Stable};+ for (channel, version, on) in [+ // Before: classic on both channels, 0.8.0 included (it shipped+ // without the default).+ (Beta, "0.7.2", false),+ (Stable, "0.7.2", false),+ (Beta, "0.8.0-beta.5", false),+ (Beta, "0.8.0-beta.6", false),+ (Beta, "0.8.0", false),+ (Stable, "0.8.0", false),+ // Beta: every 0.8.1 prerelease, from the first.+ (Beta, "0.8.1-0", true),+ (Beta, "0.8.1-beta.0", true),+ (Beta, "0.8.1-beta.1", true),+ (Beta, "0.8.1-beta.10", true),+ (Beta, "0.8.1-rc.1", true),+ (Beta, "0.8.1-beta.1+build.7", true),+ // Stable keeps classic until 0.8.1.+ (Stable, "0.8.1-beta.1", false),+ (Stable, "0.8.1-rc.1", false),+ (Stable, "0.8.1", true),+ (Beta, "0.8.1", true),+ (Stable, "0.8.2", true),+ (Stable, "0.9.0-beta.1", true),+ (Stable, "1.0.0", true),+ // Not a version: classic.+ (Beta, "", false),+ (Beta, "dev", false),+ (Beta, "0.8", false),+ ] {+ assert_eq!(+ new_ui_default(channel, version),+ on,+ "{channel:?} {version}"+ );+ }+ }++ #[test]+ fn versions_compare_as_semver() {+ let v = |s: &str| Version::parse(s).unwrap();+ assert!(+ v("0.8.0-beta.6") < v("0.8.0-beta.10"),+ "numeric parts as numbers"+ );+ assert!(v("0.8.0-beta.6") < v("0.8.0-rc.1"));+ assert!(v("0.8.0-rc.1") < v("0.8.0"));+ assert!(v("0.7.2") < v("0.8.0-beta.1"));+ assert!(v("0.8.0-beta") < v("0.8.0-beta.1"));+ assert!(v("0.8.0") < v("0.8.1-0"));+ assert!(+ v("0.8.1-0") < v("0.8.1-beta.0"),+ "numeric before alphanumeric"+ );+ assert_eq!(v("v0.8.0+abc"), v("0.8.0"));+ assert!(Version::parse("0.8.0-").is_none());+ assert!(Version::parse("0.8.0.1").is_none());+ }+#[test]fn stored_keys_are_forward_compatible() {let x: Experiments =diff --git a/libs/cua/crates/cua-spaces-app-core/src/settings.rs b/libs/cua/crates/cua-spaces-app-core/src/settings.rsindex 83d8c93016..c08eeb3f50 100644--- a/libs/cua/crates/cua-spaces-app-core/src/settings.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/settings.rs@@ -55,8 +55,16 @@ pub struct AppSettings {/// Settings); `None`: never chosen ([`crate::login_item::launch_plan`]).pub launch_at_login: Option<bool>,/// Settings, Experiments: every switch off unless turned on- /// ([`crate::experiments`]).+ /// ([`crate::experiments`]). Its `webUi` is the New UI as this launch+ /// shows it ([`resolve_new_ui`]); the file keeps only [`Self::new_ui`]'s+ /// "on" there, the value older builds read.pub experiments: Experiments,+ /// The New UI as the user chose it (Settings, Experiments, "Use classic+ /// UI"); `None`: never chosen, so+ /// [`crate::experiments::new_ui_default`] decides. An older build's+ /// saved `webUi: true` reads as `Some(true)`; its `false` was only the+ /// saved default, so it reads as never chosen ([`load`]).+ pub new_ui: Option<bool>,/// Keyvault copies (import ids) the user dismissed from the notch: it no/// longer shows them, nothing is revoked or wiped/// ([`crate::keyvault::view::prune_dismissed`] forgets the gone ones).@@ -87,6 +95,7 @@ impl Default for AppSettings {update_channel: UpdateChannel::Stable,launch_at_login: None,experiments: Experiments::default(),+ new_ui: None,dismissed_access: vec![],keyvault_site_icons: true,teleport_choices: vec![],@@ -96,16 +105,67 @@ impl Default for AppSettings {}/// Reads settings; a missing or damaged file gives the defaults.+///+/// The New UI: a file with no choice yet ([`AppSettings::new_ui`]) takes an+/// older build's `experiments.webUi: true` as the choice and its `false`+/// as no choice (every older install saved `false` without anyone choosing+/// it). Until [`resolve_new_ui`] runs with the app's version, the New UI+/// is on only by choice.pub fn load(path: &Path) -> AppSettings {- std::fs::read_to_string(path)+ let mut s: AppSettings = std::fs::read_to_string(path).ok().and_then(|s| serde_json::from_str(&s).ok())- .unwrap_or_default()+ .unwrap_or_default();+ if s.new_ui.is_none() && s.experiments.web_ui {+ s.new_ui = Some(true);+ }+ s.experiments.web_ui = s.new_ui == Some(true);+ s+}++/// `settings` with the New UI as this launch shows it: the user's choice,+/// else [`crate::experiments::new_ui_default`] for the update channel and+/// the running app's `version`. Again after the channel changes.+pub fn resolve_new_ui(settings: &AppSettings, version: &str) -> AppSettings {+ let mut s = settings.clone();+ s.experiments.web_ui = s+ .new_ui+ .unwrap_or_else(|| crate::experiments::new_ui_default(s.update_channel, version));+ s}-/// Writes settings atomically (temp file, then rename).+/// The update channel of an install's first launch, from the one in the+/// settings file (`channel`): Beta for a prerelease (someone who installed+/// a beta keeps getting betas, and the New UI default that comes with+/// them), else unchanged.+pub fn first_launch_channel(channel: UpdateChannel, version: &str) -> UpdateChannel {+ if version.split('+').next().unwrap_or("").contains('-') {+ UpdateChannel::Beta+ } else {+ channel+ }+}++/// The settings after a Settings, Experiments row's choice: the switches+/// ([`crate::experiments::choose`]) and, for the New UI's row ("Use classic+/// UI"), the user's choice ([`AppSettings::new_ui`]), which later launches+/// keep whatever the default becomes.+pub fn choose_experiment(settings: &AppSettings, row: &str, option: &str) -> AppSettings {+ let mut s = settings.clone();+ s.experiments = crate::experiments::choose(&s.experiments, row, option);+ if let Some(on) = crate::experiments::new_ui_choice(row, option) {+ s.new_ui = Some(on);+ }+ s+}++/// Writes settings atomically (temp file, then rename). The New UI is+/// saved as chosen ([`AppSettings::new_ui`]), never as its default: the+/// default follows the version and channel of each launch.pub fn save(path: &Path, settings: &AppSettings) -> Result<(), CoreError> {- let json = serde_json::to_string_pretty(settings).map_err(|e| CoreError::Io(e.to_string()))?;+ let mut stored = settings.clone();+ stored.experiments.web_ui = stored.new_ui == Some(true);+ let json = serde_json::to_string_pretty(&stored).map_err(|e| CoreError::Io(e.to_string()))?;if let Some(dir) = path.parent() {std::fs::create_dir_all(dir).map_err(|e| CoreError::Io(e.to_string()))?;}@@ -1163,4 +1223,147 @@ mod tests {let old: AppSettings = serde_json::from_str(r#"{"menuBar":true}"#).unwrap();assert_eq!(old.experiments, Experiments::default());}++ /// A settings file in a fresh temp dir.+ fn temp_settings(name: &str) -> (std::path::PathBuf, std::path::PathBuf) {+ let dir =+ std::env::temp_dir().join(format!("cua-app-core-new-ui-{name}-{}", std::process::id()));+ let _ = std::fs::remove_dir_all(&dir);+ std::fs::create_dir_all(&dir).unwrap();+ let path = dir.join("settings.json");+ (dir, path)+ }++ #[test]+ fn an_older_builds_saved_new_ui_migrates_once() {+ let (dir, path) = temp_settings("migrate");+ let beta = "0.8.1-beta.1";+ // Every older install saved `webUi: false` without anyone choosing it:+ // never chosen, so Beta gets the New UI.+ std::fs::write(+ &path,+ r#"{"updateChannel":"beta","experiments":{"cuaVolume":true,"webUi":false}}"#,+ )+ .unwrap();+ let s = load(&path);+ assert_eq!(s.new_ui, None);+ assert!(s.experiments.cua_volume);+ assert!(!s.experiments.web_ui, "on only by choice until resolved");+ assert!(resolve_new_ui(&s, beta).experiments.web_ui);+ assert!(!resolve_new_ui(&s, "0.8.0").experiments.web_ui);+ // Saving the resolved settings keeps it unchosen: the default is+ // never written as a choice.+ save(&path, &resolve_new_ui(&s, beta)).unwrap();+ let raw: serde_json::Value =+ serde_json::from_str(&std::fs::read_to_string(&path).unwrap()).unwrap();+ assert_eq!(raw["experiments"]["webUi"], false, "what older builds read");+ assert!(raw["newUi"].is_null());+ assert_eq!(load(&path).new_ui, None);++ // A saved `webUi: true` was chosen: kept, on any channel.+ std::fs::write(&path, r#"{"experiments":{"webUi":true}}"#).unwrap();+ let s = load(&path);+ assert_eq!(s.new_ui, Some(true));+ assert!(s.experiments.web_ui);+ assert!(resolve_new_ui(&s, "0.7.2").experiments.web_ui);+ save(&path, &s).unwrap();+ assert_eq!(load(&path).new_ui, Some(true));++ // No experiments at all (or no file): never chosen.+ std::fs::write(&path, r#"{"menuBar":true}"#).unwrap();+ assert_eq!(load(&path).new_ui, None);+ std::fs::remove_file(&path).unwrap();+ let fresh = load(&path);+ assert_eq!(fresh.new_ui, None);+ assert!(!resolve_new_ui(&fresh, beta).experiments.web_ui, "Stable");+ let _ = std::fs::remove_dir_all(dir);+ }++ #[test]+ fn use_classic_ui_survives_later_launches() {+ let (dir, path) = temp_settings("classic");+ let beta = "0.8.1-beta.1";+ let s = resolve_new_ui(+ &AppSettings {+ update_channel: UpdateChannel::Beta,+ ..Default::default()+ },+ beta,+ );+ assert!(s.experiments.web_ui);+ // "Use classic UI" on: saved as the user's choice.+ let row = crate::experiments::CLASSIC_UI_ROW;+ let s = choose_experiment(&s, row, "on");+ assert_eq!(s.new_ui, Some(false));+ assert!(!s.experiments.web_ui);+ // Another row leaves the choice alone.+ assert_eq!(+ choose_experiment(&s, "experiment:sharing", "on").new_ui,+ Some(false)+ );+ save(&path, &s).unwrap();+ // Later launches, later versions, either channel: still classic.+ for version in [beta, "0.8.1-beta.2", "0.8.1", "0.9.0"] {+ let again = resolve_new_ui(&load(&path), version);+ assert_eq!(again.new_ui, Some(false));+ assert!(!again.experiments.web_ui, "{version}");+ save(&path, &again).unwrap();+ }+ // Off again: the New UI, kept as chosen even on Stable before 0.8.1.+ let mut s = choose_experiment(&load(&path), row, "off");+ assert_eq!(s.new_ui, Some(true));+ s.update_channel = UpdateChannel::Stable;+ save(&path, &s).unwrap();+ assert!(resolve_new_ui(&load(&path), "0.7.3").experiments.web_ui);+ let _ = std::fs::remove_dir_all(dir);+ }++ #[test]+ fn switching_channel_moves_the_default_not_a_choice() {+ let beta = AppSettings {+ update_channel: UpdateChannel::Beta,+ ..Default::default()+ };+ let stable = AppSettings {+ update_channel: UpdateChannel::Stable,+ ..beta.clone()+ };+ let v = "0.8.1-beta.1";+ assert!(resolve_new_ui(&beta, v).experiments.web_ui);+ assert!(!resolve_new_ui(&stable, v).experiments.web_ui);+ // Back to Beta: on again.+ let back = AppSettings {+ update_channel: UpdateChannel::Beta,+ ..resolve_new_ui(&stable, v)+ };+ assert!(resolve_new_ui(&back, v).experiments.web_ui);+ // A choice holds on either channel.+ for (choice, channel) in [(false, UpdateChannel::Beta), (true, UpdateChannel::Stable)] {+ let s = AppSettings {+ update_channel: channel,+ new_ui: Some(choice),+ ..Default::default()+ };+ assert_eq!(resolve_new_ui(&s, v).experiments.web_ui, choice);+ }+ // From 0.8.1, Stable too.+ assert!(resolve_new_ui(&stable, "0.8.1").experiments.web_ui);+ }++ #[test]+ fn a_prerelease_installs_first_launch_is_on_beta() {+ use UpdateChannel::{Beta, Stable};+ assert_eq!(first_launch_channel(Stable, "0.8.1-beta.1"), Beta);+ assert_eq!(first_launch_channel(Stable, "0.8.1-beta.1+abc"), Beta);+ assert_eq!(first_launch_channel(Stable, "0.7.2"), Stable);+ assert_eq!(first_launch_channel(Stable, "0.8.0+build-7"), Stable);+ // A release keeps a channel already in the file.+ assert_eq!(first_launch_channel(Beta, "0.7.2"), Beta);+ // With it, a fresh beta opens the New UI.+ let fresh = AppSettings {+ update_channel: first_launch_channel(Stable, "0.8.1-beta.1"),+ ..Default::default()+ };+ assert!(resolve_new_ui(&fresh, "0.8.1-beta.1").experiments.web_ui);+ }}diff --git a/libs/cua/crates/cua-spaces-ffi/src/app_core.rs b/libs/cua/crates/cua-spaces-ffi/src/app_core.rsindex 098db7b4f1..ffff3e2ac9 100644--- a/libs/cua/crates/cua-spaces-ffi/src/app_core.rs+++ b/libs/cua/crates/cua-spaces-ffi/src/app_core.rs@@ -1924,6 +1924,35 @@ pub fn app_settings_save(path: String, settings: AppSettings) -> Result<()> {.map_err(|e| CuaError::Internal(e.to_string()))}+/// The settings with the New UI as a launch of `version` shows it: the+/// user's choice, else the default for the update channel and version+/// (again after the channel changes).+#[uniffi::export]+pub fn app_settings_resolve_new_ui(settings: AppSettings, version: String) -> AppSettings {+ core::settings::resolve_new_ui(&settings, &version)+}++/// The update channel of an install's first launch, from the file's+/// `channel`: Beta for a prerelease, else unchanged.+#[uniffi::export]+pub fn app_settings_first_launch_channel(+ channel: AppUpdateChannel,+ version: String,+) -> AppUpdateChannel {+ core::settings::first_launch_channel(channel, &version)+}++/// The settings after a Settings, Experiments row's choice (the switches,+/// and the New UI's "Use classic UI" saved as the user's choice).+#[uniffi::export]+pub fn app_settings_choose_experiment(+ settings: AppSettings,+ row: String,+ option: String,+) -> AppSettings {+ core::settings::choose_experiment(&settings, &row, &option)+}+/// The Settings page.#[uniffi::export]pub fn app_settings_page(input: AppSettingsInput) -> AppSettingsPage {diff --git a/libs/cua/crates/cua-spaces-ffi/src/app_core_types.rs b/libs/cua/crates/cua-spaces-ffi/src/app_core_types.rsindex a693742c5d..5deecc6544 100644--- a/libs/cua/crates/cua-spaces-ffi/src/app_core_types.rs+++ b/libs/cua/crates/cua-spaces-ffi/src/app_core_types.rs@@ -6360,7 +6360,8 @@ pub struct AppExperiments {pub your_cloud: bool,/// Sharing a Space with other accounts.pub sharing: bool,- /// The shared web UI, previewed in its own window.+ /// The New UI (the shared web UI) is the main window: the user's choice+ /// or, without one, [`new_ui_default`] ([`crate::settings::resolve_new_ui`]).pub web_ui: bool,}@@ -6400,8 +6401,16 @@ pub struct AppSettings {/// Settings); `None`: never chosen ([`crate::login_item::launch_plan`]).pub launch_at_login: Option<bool>,/// Settings, Experiments: every switch off unless turned on- /// ([`crate::experiments`]).+ /// ([`crate::experiments`]). Its `webUi` is the New UI as this launch+ /// shows it ([`resolve_new_ui`]); the file keeps only [`Self::new_ui`]'s+ /// "on" there, the value older builds read.pub experiments: AppExperiments,+ /// The New UI as the user chose it (Settings, Experiments, "Use classic+ /// UI"); `None`: never chosen, so+ /// [`crate::experiments::new_ui_default`] decides. An older build's+ /// saved `webUi: true` reads as `Some(true)`; its `false` was only the+ /// saved default, so it reads as never chosen ([`load`]).+ pub new_ui: Option<bool>,/// Keyvault copies (import ids) the user dismissed from the notch: it no/// longer shows them, nothing is revoked or wiped/// ([`crate::keyvault::view::prune_dismissed`] forgets the gone ones).diff --git a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swiftindex 6a264a774e..dd7c984335 100644--- a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift+++ b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift@@ -13742,7 +13742,8 @@ public struct AppExperiments: Equatable, Hashable {*/public var sharing: Bool/**- * The shared web UI, previewed in its own window.+ * The New UI (the shared web UI) is the main window: the user's choice+ * or, without one, [`new_ui_default`] ([`crate::settings::resolve_new_ui`]).*/public var webUi: Bool@@ -13759,7 +13760,8 @@ public struct AppExperiments: Equatable, Hashable {* Sharing a Space with other accounts.*/sharing: Bool,/**- * The shared web UI, previewed in its own window.+ * The New UI (the shared web UI) is the main window: the user's choice+ * or, without one, [`new_ui_default`] ([`crate::settings::resolve_new_ui`]).*/webUi: Bool) {self.cuaVolume = cuaVolumeself.yourCloud = yourCloud@@ -27352,9 +27354,19 @@ public struct AppSettings: Equatable, Hashable {public var launchAtLogin: Bool?/*** Settings, Experiments: every switch off unless turned on- * ([`crate::experiments`]).+ * ([`crate::experiments`]). Its `webUi` is the New UI as this launch+ * shows it ([`resolve_new_ui`]); the file keeps only [`Self::new_ui`]'s+ * "on" there, the value older builds read.*/public var experiments: AppExperiments+ /**+ * The New UI as the user chose it (Settings, Experiments, "Use classic+ * UI"); `None`: never chosen, so+ * [`crate::experiments::new_ui_default`] decides. An older build's+ * saved `webUi: true` reads as `Some(true)`; its `false` was only the+ * saved default, so it reads as never chosen ([`load`]).+ */+ public var newUi: Bool?/*** Keyvault copies (import ids) the user dismissed from the notch: it no* longer shows them, nothing is revoked or wiped@@ -27414,8 +27426,17 @@ public struct AppSettings: Equatable, Hashable {*/launchAtLogin: Bool?,/*** Settings, Experiments: every switch off unless turned on- * ([`crate::experiments`]).+ * ([`crate::experiments`]). Its `webUi` is the New UI as this launch+ * shows it ([`resolve_new_ui`]); the file keeps only [`Self::new_ui`]'s+ * "on" there, the value older builds read.*/experiments: AppExperiments,+ /**+ * The New UI as the user chose it (Settings, Experiments, "Use classic+ * UI"); `None`: never chosen, so+ * [`crate::experiments::new_ui_default`] decides. An older build's+ * saved `webUi: true` reads as `Some(true)`; its `false` was only the+ * saved default, so it reads as never chosen ([`load`]).+ */newUi: Bool?,/*** Keyvault copies (import ids) the user dismissed from the notch: it no* longer shows them, nothing is revoked or wiped@@ -27445,6 +27466,7 @@ public struct AppSettings: Equatable, Hashable {self.updateChannel = updateChannelself.launchAtLogin = launchAtLoginself.experiments = experiments+ self.newUi = newUiself.dismissedAccess = dismissedAccessself.keyvaultSiteIcons = keyvaultSiteIconsself.teleportChoices = teleportChoices@@ -27477,6 +27499,7 @@ public struct FfiConverterTypeAppSettings: FfiConverterRustBuffer {updateChannel: FfiConverterTypeAppUpdateChannel.read(from: &buf),launchAtLogin: FfiConverterOptionBool.read(from: &buf),experiments: FfiConverterTypeAppExperiments.read(from: &buf),+ newUi: FfiConverterOptionBool.read(from: &buf),dismissedAccess: FfiConverterSequenceString.read(from: &buf),keyvaultSiteIcons: FfiConverterBool.read(from: &buf),teleportChoices: FfiConverterSequenceTypeAppRememberedChoice.read(from: &buf),@@ -27495,6 +27518,7 @@ public struct FfiConverterTypeAppSettings: FfiConverterRustBuffer {FfiConverterTypeAppUpdateChannel.write(value.updateChannel, into: &buf)FfiConverterOptionBool.write(value.launchAtLogin, into: &buf)FfiConverterTypeAppExperiments.write(value.experiments, into: &buf)+ FfiConverterOptionBool.write(value.newUi, into: &buf)FfiConverterSequenceString.write(value.dismissedAccess, into: &buf)FfiConverterBool.write(value.keyvaultSiteIcons, into: &buf)FfiConverterSequenceTypeAppRememberedChoice.write(value.teleportChoices, into: &buf)@@ -64287,6 +64311,31 @@ public func appSentFilesFromJson(json: String)throws -> [AppSentFileInfo] {)})}+/**+ * The settings after a Settings, Experiments row's choice (the switches,+ * and the New UI's "Use classic UI" saved as the user's choice).+ */+public func appSettingsChooseExperiment(settings: AppSettings, row: String, option: String) -> AppSettings {+ return try! FfiConverterTypeAppSettings_lift(try! rustCall() {+ uniffi_cua_spaces_ffi_fn_func_app_settings_choose_experiment(+ FfiConverterTypeAppSettings_lower(settings),+ FfiConverterString.lower(row),+ FfiConverterString.lower(option),$0+ )+})+}+/**+ * The update channel of an install's first launch, from the file's+ * `channel`: Beta for a prerelease, else unchanged.+ */+public func appSettingsFirstLaunchChannel(channel: AppUpdateChannel, version: String) -> AppUpdateChannel {+ return try! FfiConverterTypeAppUpdateChannel_lift(try! rustCall() {+ uniffi_cua_spaces_ffi_fn_func_app_settings_first_launch_channel(+ FfiConverterTypeAppUpdateChannel_lower(channel),+ FfiConverterString.lower(version),$0+ )+})+}/*** The Settings page's input from JSON (parity flows).*/@@ -64317,6 +64366,19 @@ public func appSettingsPage(input: AppSettingsInput) -> AppSettingsPage {)})}+/**+ * The settings with the New UI as a launch of `version` shows it: the+ * user's choice, else the default for the update channel and version+ * (again after the channel changes).+ */+public func appSettingsResolveNewUi(settings: AppSettings, version: String) -> AppSettings {+ return try! FfiConverterTypeAppSettings_lift(try! rustCall() {+ uniffi_cua_spaces_ffi_fn_func_app_settings_resolve_new_ui(+ FfiConverterTypeAppSettings_lower(settings),+ FfiConverterString.lower(version),$0+ )+})+}/*** Writes the settings file.*/@@ -66047,6 +66109,12 @@ private let initializationResult: InitializationResult = {if (uniffi_cua_spaces_ffi_checksum_func_app_sent_files_from_json() != 3362) {return InitializationResult.apiChecksumMismatch}+ if (uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment() != 8693) {+ return InitializationResult.apiChecksumMismatch+ }+ if (uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel() != 11279) {+ return InitializationResult.apiChecksumMismatch+ }if (uniffi_cua_spaces_ffi_checksum_func_app_settings_input_from_json() != 15437) {return InitializationResult.apiChecksumMismatch}@@ -66056,6 +66124,9 @@ private let initializationResult: InitializationResult = {if (uniffi_cua_spaces_ffi_checksum_func_app_settings_page() != 454) {return InitializationResult.apiChecksumMismatch}+ if (uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui() != 48081) {+ return InitializationResult.apiChecksumMismatch+ }if (uniffi_cua_spaces_ffi_checksum_func_app_settings_save() != 30129) {return InitializationResult.apiChecksumMismatch}diff --git a/libs/spaces-app-swift/Sources/cua_spaces_ffiFFI/include/cua_spaces_ffiFFI.h b/libs/spaces-app-swift/Sources/cua_spaces_ffiFFI/include/cua_spaces_ffiFFI.hindex f6780dc115..677c877e63 100644--- a/libs/spaces-app-swift/Sources/cua_spaces_ffiFFI/include/cua_spaces_ffiFFI.h+++ b/libs/spaces-app-swift/Sources/cua_spaces_ffiFFI/include/cua_spaces_ffiFFI.h@@ -1571,6 +1571,16 @@ RustBuffer uniffi_cua_spaces_ffi_fn_func_app_sent_file(RustBuffer report, RustCaRustBuffer uniffi_cua_spaces_ffi_fn_func_app_sent_files_from_json(RustBuffer json, RustCallStatus *_Nonnull out_status);#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_CHOOSE_EXPERIMENT+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_CHOOSE_EXPERIMENT+RustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_choose_experiment(RustBuffer settings, RustBuffer row, RustBuffer option, RustCallStatus *_Nonnull out_status+);+#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_FIRST_LAUNCH_CHANNEL+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_FIRST_LAUNCH_CHANNEL+RustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_first_launch_channel(RustBuffer channel, RustBuffer version, RustCallStatus *_Nonnull out_status+);+#endif#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_INPUT_FROM_JSON#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_INPUT_FROM_JSONRustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_input_from_json(RustBuffer json, RustCallStatus *_Nonnull out_status@@ -1586,6 +1596,11 @@ RustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_load(RustBuffer path, RustRustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_page(RustBuffer input, RustCallStatus *_Nonnull out_status);#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_RESOLVE_NEW_UI+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_RESOLVE_NEW_UI+RustBuffer uniffi_cua_spaces_ffi_fn_func_app_settings_resolve_new_ui(RustBuffer settings, RustBuffer version, RustCallStatus *_Nonnull out_status+);+#endif#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_SAVE#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_FN_FUNC_APP_SETTINGS_SAVEvoid uniffi_cua_spaces_ffi_fn_func_app_settings_save(RustBuffer path, RustBuffer settings, RustCallStatus *_Nonnull out_status@@ -3451,6 +3466,18 @@ uint16_t uniffi_cua_spaces_ffi_checksum_func_app_sent_file(void#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SENT_FILES_FROM_JSONuint16_t uniffi_cua_spaces_ffi_checksum_func_app_sent_files_from_json(void+);+#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_CHOOSE_EXPERIMENT+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_CHOOSE_EXPERIMENT+uint16_t uniffi_cua_spaces_ffi_checksum_func_app_settings_choose_experiment(void++);+#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_FIRST_LAUNCH_CHANNEL+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_FIRST_LAUNCH_CHANNEL+uint16_t uniffi_cua_spaces_ffi_checksum_func_app_settings_first_launch_channel(void+);#endif#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_INPUT_FROM_JSON@@ -3469,6 +3496,12 @@ uint16_t uniffi_cua_spaces_ffi_checksum_func_app_settings_load(void#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_PAGEuint16_t uniffi_cua_spaces_ffi_checksum_func_app_settings_page(void+);+#endif+#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_RESOLVE_NEW_UI+#define UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_RESOLVE_NEW_UI+uint16_t uniffi_cua_spaces_ffi_checksum_func_app_settings_resolve_new_ui(void+);#endif#ifndef UNIFFI_FFIDEF_UNIFFI_CUA_SPACES_FFI_CHECKSUM_FUNC_APP_SETTINGS_SAVEdiff --git a/scripts/docs-generators/cua-sdk.test.ts b/scripts/docs-generators/cua-sdk.test.tsindex b586571559..9307dd0e59 100644--- a/scripts/docs-generators/cua-sdk.test.ts+++ b/scripts/docs-generators/cua-sdk.test.ts@@ -316,8 +316,9 @@ test('nested folders get their own meta.json; a catalog page lists its subtree iassert.deepEqual(JSON.parse(out.get('/out/sandbox/life/meta.json')!), { title: 'Lifecycle', pages: ['results'] });const home = out.get('/out/sandbox/index.mdx')!;assert.match(home, /^## All items$/m);- // The index is grouped by page: one line of item links per page.- assert.match(home, /\*\*Results\*\*: .*\[`ExecResult`\]\(\/cua-sdk\/reference\/sandbox\/life\/results#execresult-record\)/);+ // The index is grouped by page: one line per subpage, its title a link,+ // then its item names; this page's own items keep their anchor links.+ assert.match(home, /\*\*\[Results\]\(\/cua-sdk\/reference\/sandbox\/life\/results\)\*\*: .*`ExecResult`/);assert.match(home, /\[`Sandbox`\]\(#sandbox\)/);const types = out.get('/out/types.mdx')!;assert.doesNotMatch(types, /\[`ExecResult`\]/);diff --git a/scripts/docs-generators/cua-sdk.ts b/scripts/docs-generators/cua-sdk.tsindex a5ce903471..156bbf5afb 100644--- a/scripts/docs-generators/cua-sdk.ts+++ b/scripts/docs-generators/cua-sdk.ts@@ -929,8 +929,8 @@ export const PAGES: PageSpec[] = [slug: 'spaces/app-core/experiments',title: 'Experiments',description: 'Settings > Experiments: the switches that hide Cua Volume, your own cloud and sharing until they are turned on.',- intro: '`app_experiments_page` derives the Experiments tab from the saved `AppExperiments`; `app_experiments_choose` applies a switch. Off only hides a feature: a mounted Volume, a connected cloud and existing shares stay as they are.',- items: ['app_experiments_from_json', 'app_settings_with_storage', 'app_telemetry_experiments_changed', 'app_telemetry_experiments_on'],+ intro: '`app_experiments_page` derives the Experiments tab from the saved `AppExperiments`; `app_settings_choose_experiment` applies a switch and saves the New UI choice ("Use classic UI"). `app_settings_resolve_new_ui` applies the New UI default for the update channel and version. Off only hides a feature: a mounted Volume, a connected cloud and existing shares stay as they are.',+ items: ['app_experiments_from_json', 'app_settings_with_storage', 'app_settings_resolve_new_ui', 'app_settings_first_launch_channel', 'app_settings_choose_experiment', 'app_telemetry_experiments_changed', 'app_telemetry_experiments_on'],prefixes: ['AppExperiment', 'app_experiments_'],spaces: true,},@@ -2078,9 +2078,10 @@ function itemTable(items: Array<Item & { href: string }>, page: string): string[}/**- * A catalog page's compact index: one line of item links per subpage (the- * summaries live on each item's own section), so large catalogs stay under- * the page budget.+ * A catalog page's compact index: one line per subpage, its title linking to+ * it, then the names of its items (each one's section is on that page, under+ * its name), so large catalogs stay under the page budget. The catalog page's+ * own items keep their anchor links.*/function catalogIndex(items: Array<Item & { href: string }>, page: string, rc: RenderContext): string[] {const groups = new Map<string, Array<Item & { href: string }>>();@@ -2092,7 +2093,12 @@ function catalogIndex(items: Array<Item & { href: string }>, page: string, rc: Rconst out: string[] = [];for (const [target, group] of groups) {const spec = rc.pages.find((p) => pageRoute(p.slug) === target || target.endsWith(`/${p.slug}`));- out.push(`**${spec ? spec.title : target}**: ${group.map((i) => `[\`${i.name}\`](${relLink(i.href, page)})`).join(', ')}`, '');+ const title = spec ? spec.title : target;+ if (target === pageRoute(page)) {+ out.push(`**${title}**: ${group.map((i) => `[\`${i.name}\`](${relLink(i.href, page)})`).join(', ')}`, '');+ } else {+ out.push(`**[${title}](${target})**: ${group.map((i) => `\`${i.name}\``).join(', ')}`, '');+ }}return out;}@@ -2112,7 +2118,7 @@ function renderObjectPage(p: Placed, rc: RenderContext, version: string): stringfor (const item of p.items) body.push(...renderItem(item, rc));if (spec.catalog) {const items = catalogItems(spec.slug, rc);- body.push('## All items', '', `${items.length} items, across this page and its subpages, grouped by page. Methods are listed on their object.`, '');+ body.push('## All items', '', `${items.length} items, across this page and its subpages, grouped by page (each item's section is on its page). Methods are listed on their object.`, '');body.push(...catalogIndex(items, spec.slug, rc), '');}const needsCallout = body.some((l) => l.includes('<Callout'));