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 Cua Spaces apps render the same state from this core, so their behaviour cannot diverge. 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()app_account_app_url#The account app for this environment (CUA_ACCOUNT_APP_URL, else
https://app.cua.ai, or https://app.staging.cua.ai under
CUA_ENV=staging): billing, plans and team administration, which the
apps open in the browser.
func appAccountAppUrl() -> StringReturns String
620 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, 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 core: app_account_app_url, cua_spaces_register
Settings, Agents: 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, 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, 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
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
Window, menu bar and Settings: 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, 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_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, 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, 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_sign_in_failed, 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, AppRuntimeSwitch, 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