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()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
552 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_roster_initial, app_roster_reduce, app_rows_to_spaces, app_sidebar, app_space_accepts_drop, app_space_detail, app_space_detail_with, app_space_rows_from_json, app_spaces_from_json, app_status_line, app_this_machine_space, AppAgentStatus, AppAmbientDots, AppFactWarning, AppHostSummaryInput, 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, AppActivityRow, AppApprovalPrompt, AppApproveRequest, AppApproveSheetAction, AppApproveSheetState, AppApproveSheetView, AppAuditInput, AppBannerTone, AppDeviceAction, AppDeviceBanner, AppDeviceConfirm, AppDeviceInput, AppDeviceRow, AppDevicesInput, AppDevicesLabels, AppDevicesView, AppEnrollAction, AppEnrollmentKind, AppEnrollMethod, AppEnrollOption, AppEnrollPhase, AppEnrollState, AppEnrollView, 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_teleport_plan, app_teleport_plan_from_json, app_transfer_reduce, app_transfer_title, AppCatalogEntry, AppConsentItem, AppConsentKind, AppDragOverlayEffect, AppDragOverlayEvent, AppDragOverlayPhase, AppDragOverlayState, AppDragOverlayTransition, AppEntrySection, AppInstallCuaPrompt, AppPickerAction, AppPickerEvent, AppPickerPrimary, AppPickerState, AppPickerStep, AppPickerTab, AppPlanStepView, AppReviewView, AppTeleportCapability, AppTeleportConsent, AppTeleportMove, AppTeleportPlan, AppTeleportRunEvent, AppTeleportRunPhase, AppTeleportRunReport, AppTransferOverlayState, AppTransferPhase, AppTransferSignal, AppTransferStatus
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
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_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, AppHostAction, AppHostActionId, AppHostClient, AppHostConfirm, AppHostFormAction, AppHostFormChoice, AppHostFormField, AppHostFormState, AppHostFormView, AppHostLimit, AppHostPanelView, AppHostPermissionInput, AppHostProvidedSpace, AppHostSettingChange, AppHostSetupRequest, AppHostSpacesAudit, AppHostState, AppHostToggle, AppPermissionRow
Spaces app core: app_menu_input_from_json, 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, 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
Keyvault: app_sensitive_group_sdk, AppSensitiveGroup, AppSensitiveOption, KeyvaultClient, KeyvaultOverview, kv_credential_form, kv_duration, kv_labels, kv_overview_from_json, kv_passphrase_check, kv_recovery_key_text, kv_sharing_label, KvAccessRequest, KvAuditEntry, KvCaller, KvCommand, KvCookieInfo, KvCredentialForm, KvDelivery, KvFormMode, KvGrant, KvItem, KvItemPolicy, KvItemSummary, 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
Stream section and facts: app_space_detail_live, app_stream_desktop_row_id, app_stream_pip_click, app_stream_pip_reduce, app_stream_section, app_usage_refresh_ms, AppPipCommand, AppPipEvent, AppSpaceUsage, AppStreamDisplay, AppStreamRow, AppStreamRowAction, AppStreamRowActionId, AppStreamRowIcon, AppStreamRowKind, AppStreamSection, AppStreamSectionInput
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
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_list, kv_page, kv_sidebar, kv_site_detail, kv_site_toggle, KvAccessKind, KvAccessRow, KvApprovalAction, KvApprovalRow, KvApprovalState, KvApprovalView, KvCategory, KvCategoryRow, KvConsentChip, KvConsentChipKind, KvDecision, KvDecisionTone, KvItemRow, KvListView, KvPage, KvPendingRow, KvRecentRow, KvSelection, KvSidebar, KvSigningBadge, KvSiteDetail, KvSiteGroup, KvSiteRow, KvTone, KvTri