Spaces app core
The view models the Cua Spaces apps share: Space list, New Space wizard, teleport review, notch and Keyvault.
The view models the Cua Spaces apps share: Space list, New Space wizard, teleport review, notch and Keyvault.
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.
The Tauri and SwiftUI Cua Spaces apps render the same state from this core, so their behaviour cannot diverge. Build your own Spaces UI on it. Each screen is a state record, a pure *_reduce function that applies an action or event, and a *_view that derives what to draw. The subpages cover one screen each; the shared formatters are on Window, menu bar and Settings.
cua_spaces_register#Registers the Cua Spaces extensions (teleport, the Cua Volume, persistent
agents, the Keyvault) for every runtime the SDK builds in this process.
Idempotent; the SwiftUI app calls it once at launch, before its first
Cua.
func cuaSpacesRegister()AppRuntimeSwitch record#| Field | Type | Default | Description |
|---|---|---|---|
setting | String | The cua config setting: runtime.lume. | |
value | String | The value to set: builtin. | |
label | String | The button: "Use built-in Lume". | |
detail | String | One line on what that does. |
app_menu_input_from_json#The menu bar item's menu input from JSON (fixtures, parity).
func appMenuInputFromJson(json: String) throws -> AppMenuInput| Parameter | Type | Default |
|---|---|---|
json | String | required |
Returns AppMenuInput · Raises CuaError
606 items, across this page and its subpages, grouped by page. Methods are listed on their object.
About, updates and launch: 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
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
Window, menu bar and Settings: 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, 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_openable_count, app_sent_file, app_sent_files_from_json, app_settings_input_from_json, app_settings_page, app_space_detail_copy, AppAgentSettingsRow, AppAgentSetupOutcomeInput, AppAgentSetupStatus, AppAgentSetupSummary, AppChromeInput, AppDeleteConfirm, AppDetailAction, AppDetailActionId, AppDetailCopy, AppFact, AppFactCopy, AppLoginItemInput, AppLoginItemPlan, AppLoginItemStatus, AppMainChrome, AppMenuInput, AppMenuItem, AppMenuItemId, AppSentFileInfo, AppSettingsInput, AppSettingsOption, AppSettingsPage, AppSettingsRow, AppSettingsRowKind, AppSettingsSection, AppSignInPhase, AppTelemetryInput
Devices: app_approve_open, app_approve_reduce, app_approve_sheet_action_from_json, app_approve_view, 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, AppBillingCard, AppBillingCredit, AppBillingStatus, AppCreditNotice
Teleport picker: 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
Your 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, app_creates_is_deleting, app_creates_is_pending, app_creates_reduce, app_creates_settle, AppCreateAction, AppCreatesState, AppPendingCreate, AppPendingDelete
Power button: app_creates_is_powering, app_power_button, AppPendingPower, AppPowerButton, AppPowerControl, AppSpacePower
Stream section and facts: 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, 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, 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, app_experiments_from_json, app_experiments_page, app_settings_with_storage, app_telemetry_experiments_changed, app_telemetry_experiments_on, AppExperiments
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
Spaces app core: app_menu_input_from_json, AppRuntimeSwitch, cua_spaces_register
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, 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
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, 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, 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, app_wizard_placement_options, AppPlacementOption, AppSpaceHost
Usage 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_start, app_telemetry_storage, app_telemetry_welcome_left, AppTelemetrySignal
Teleport plan and 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, app_transfer_title, AppDragOverlayEffect, AppDragOverlayEvent, AppDragOverlayPhase, AppDragOverlayState, AppDragOverlayTransition, AppTransferOverlayState, AppTransferPhase, AppTransferSignal, AppTransferStatus
New Space wizard: 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, AppStepDot, AppStepState, AppStepView, AppStorageVolume, AppTile, AppWizardAction, AppWizardEnv, AppWizardFact, AppWizardField, AppWizardLabels, AppWizardMode, AppWizardState, AppWizardView
Image catalog: AppImageDistro, AppImageFieldView, AppImageGroup, AppImageSizes, AppImageSuggestion, AppImageTier, AppPlatformSize, AppSandboxImage, AppSuggestionGroup
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