Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.md
index 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 window
without 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 stay
native; 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.swift
index 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.swift
index 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: AppSettings
let 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 = backend
self.startup = startup ?? StartupModel()
self.devices = DevicesModel(devices: devices, presence: presence)
@@ -177,7 +181,9 @@ public final class AppModel {
self.keyvault = keyvault
self.onboarding = onboarding
self.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 = settings
self.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.experiments
saveSettings()
- 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.swift
index 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 = save
try? appSettingsSave(path: settingsPath, settings: settings)
}
diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MainUIRouteTests.swift
index 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.swift
index 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.tsx
index 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.tsx
index 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.mdx
index 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 b
291 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.mdx
index 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.mdx
index 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.mdx
index 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.mdx
index 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.mdx
index 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.mdx
index 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()` f
292 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.json
index 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.json
index 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.rs
index 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.rs
index 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.rs
index 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.rs
index 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.swift
index 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 = cuaVolume
self.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 = updateChannel
self.launchAtLogin = launchAtLogin
self.experiments = experiments
+ self.newUi = newUi
self.dismissedAccess = dismissedAccess
self.keyvaultSiteIcons = keyvaultSiteIcons
self.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.h
index 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, RustCa
RustBuffer 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_JSON
RustBuffer 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, Rust
RustBuffer 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_SAVE
void 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_JSON
uint16_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_PAGE
uint16_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_SAVE
diff --git a/scripts/docs-generators/cua-sdk.test.ts b/scripts/docs-generators/cua-sdk.test.ts
index 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 i
assert.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.ts
index 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: R
const 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): string
for (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'));