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): link System Status from Help, Settings About and the troubleshoot guide (CUA-2228) (#5902)

cua-agents[bot]aab27757205b
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 b3c87b6d7c..547b0b1ba6 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
@@ -6875,6 +6875,10 @@ export enum AppAboutLinkId {
* The terms of service.
*/
Terms = "terms",
+ /**
+ * The public status page.
+ */
+ Status = "status",
/**
* A new issue.
*/
@@ -6890,7 +6894,8 @@ const FfiConverterTypeAppAboutLinkId = (() => {
case 1: return AppAboutLinkId.Acknowledgements;
case 2: return AppAboutLinkId.Privacy;
case 3: return AppAboutLinkId.Terms;
- case 4: return AppAboutLinkId.Issue;
+ case 4: return AppAboutLinkId.Status;
+ case 5: return AppAboutLinkId.Issue;
default: throw new UniffiInternalError.UnexpectedEnumCase();
}
}
@@ -6899,7 +6904,8 @@ const FfiConverterTypeAppAboutLinkId = (() => {
case AppAboutLinkId.Acknowledgements: return ordinalConverter.write(1, into);
case AppAboutLinkId.Privacy: return ordinalConverter.write(2, into);
case AppAboutLinkId.Terms: return ordinalConverter.write(3, into);
- case AppAboutLinkId.Issue: return ordinalConverter.write(4, into);
+ case AppAboutLinkId.Status: return ordinalConverter.write(4, into);
+ case AppAboutLinkId.Issue: return ordinalConverter.write(5, into);
}
}
allocationSize(value: TypeName): number {
@@ -7143,7 +7149,7 @@ export type AppAboutView = {
*/
versionLine: string,
/**
- * Acknowledgements, Privacy Policy, Terms of Service, Report an Issue.
+ * Acknowledgements, Privacy Policy, Terms of Service, System Status, Report an Issue.
*/
links: Array<AppAboutLink>,
/**
diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/AboutView.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/AboutView.swift
index 3336474881..bca6fa75e5 100644
--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/AboutView.swift
+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/AboutView.swift
@@ -115,6 +115,7 @@ struct AboutSettingsView: View {
case .acknowledgements: "acknowledgements"
case .privacy: "privacy"
case .terms: "terms"
+ case .status: "status"
case .issue: "issue"
}
}
diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/CuaSpacesMacApp.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/CuaSpacesMacApp.swift
index 66b486603b..e2db4929f1 100644
--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/CuaSpacesMacApp.swift
+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Views/CuaSpacesMacApp.swift
@@ -53,6 +53,7 @@ public struct CuaSpacesMacApp: App {
}
CommandGroup(after: .help) {
GettingStartedCommand(model: model)
+ SystemStatusCommand(model: model)
}
}
@@ -166,6 +167,20 @@ struct GettingStartedCommand: View {
}
}
+/// Help, System Status: the public status page, in the browser. The address is
+/// the About pane's own link (the core's `appAboutView`), so both open the same page.
+struct SystemStatusCommand: View {
+ let model: AppModel
+ @Environment(\.openURL) private var openURL
+
+ var body: some View {
+ if let link = model.updates.view.links.first(where: { $0.id == .status }),
+ let url = link.url.flatMap(URL.init(string:)) {
+ Button(link.label) { openURL(url) }
+ }
+ }
+}
+
/// The menu bar item's menu: the core's items in order.
struct MenuBarContent: View {
let model: AppModel
diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ParityTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ParityTests.swift
index fece942fa7..7f140e9fbd 100644
--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ParityTests.swift
+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ParityTests.swift
@@ -2278,6 +2278,7 @@ struct ParityTests {
case .acknowledgements: "acknowledgements"
case .privacy: "privacy"
case .terms: "terms"
+ case .status: "status"
case .issue: "issue"
}
}
diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/UpdatesTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/UpdatesTests.swift
index ad851c7bd2..7405483703 100644
--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/UpdatesTests.swift
+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/UpdatesTests.swift
@@ -49,7 +49,7 @@ struct UpdatesTests {
var v = model.view
#expect(v.title == "Cua Spaces for macOS")
#expect(v.versionLine == "Version 0.2.0-staging.5 (0.2.0.105)")
- #expect(v.links.map(\.label) == ["Acknowledgements", "Privacy Policy", "Terms of Service", "Report an Issue\u{2026}"])
+ #expect(v.links.map(\.label) == ["Acknowledgements", "Privacy Policy", "Terms of Service", "System Status", "Report an Issue\u{2026}"])
#expect(v.updates?.lastCheck == "Last check: Never")
#expect(v.updates?.autoInstallEnabled == true)
@@ -80,7 +80,7 @@ struct UpdatesTests {
@Test func noUpdaterNoControls() {
let model = UpdatesModel(updater: nil, info: Self.info)
#expect(model.view.updates == nil)
- #expect(model.view.links.count == 4)
+ #expect(model.view.links.count == 5)
}
@Test func theChannelIsSavedAndGivesSparkleItsChannels() {
diff --git a/apps/cua-spaces-web/src/bridge/__tests__/settings.test.tsx b/apps/cua-spaces-web/src/bridge/__tests__/settings.test.tsx
index 1295a1c7e0..d00f507add 100644
--- a/apps/cua-spaces-web/src/bridge/__tests__/settings.test.tsx
+++ b/apps/cua-spaces-web/src/bridge/__tests__/settings.test.tsx
@@ -72,7 +72,7 @@ describe.skipIf(!wasmBuilt)("Settings and Notifications through the core", () =>
it("draws About from the host's version and changes the update controls", async () => {
const { hooks } = mount(await testCore());
await waitFor(() => expect(hooks.about.data?.view?.versionLine).toBe("Version 0.6.0 (0.6.0.142)"));
- expect(hooks.about.data?.view?.links.map((l) => l.id)).toEqual(["acknowledgements", "privacy", "terms", "issue"]);
+ expect(hooks.about.data?.view?.links.map((l) => l.id)).toEqual(["acknowledgements", "privacy", "terms", "status", "issue"]);
await hooks.about.setAbout({ autoCheck: false });
await waitFor(() => expect(hooks.about.data?.view?.updates?.autoInstallEnabled).toBe(false));
await hooks.about.setAbout({ channel: "beta" });
diff --git a/apps/cua-spaces-web/src/bridge/contracts/settings.ts b/apps/cua-spaces-web/src/bridge/contracts/settings.ts
index 102a49ac9c..90f9eb053b 100644
--- a/apps/cua-spaces-web/src/bridge/contracts/settings.ts
+++ b/apps/cua-spaces-web/src/bridge/contracts/settings.ts
@@ -37,7 +37,7 @@ export interface AboutInput {
checking: boolean;
}
-export type AboutLinkId = "acknowledgements" | "privacy" | "terms" | "issue";
+export type AboutLinkId = "acknowledgements" | "privacy" | "terms" | "status" | "issue";
export interface AboutLink {
id: AboutLinkId;
diff --git a/docs/content/docs/spaces/guides/troubleshoot.mdx b/docs/content/docs/spaces/guides/troubleshoot.mdx
index fb31f0da52..fb9701844f 100644
--- a/docs/content/docs/spaces/guides/troubleshoot.mdx
+++ b/docs/content/docs/spaces/guides/troubleshoot.mdx
@@ -9,6 +9,11 @@ Most problems are a Space that won't create, or an agent or computer that won't
connect. This page covers a failed create in detail and points to the fix for the
rest.
+<Callout type="info">
+ If sign-in, connecting a computer or a download fails for everyone, check
+ [System status](https://status.cua.ai) first. We post outages and updates there.
+</Callout>
+
## A Space won't create
When a Space can't be created, Cua Spaces shows **Couldn't create this Space**
@@ -87,6 +92,7 @@ and system versions. Before anything leaves your computer:
- **Open email** starts a message to Cua support ([email protected]) in your
mail app. Nothing is sent until you press Send there.
+Before you email, check [System status](https://status.cua.ai) in case it is a wider outage.
On any version, you can email [email protected] with the reason shown, your
system, and the Cua Spaces version from **Settings, About**.
@@ -104,6 +110,7 @@ system, and the Cua Spaces version from **Settings, About**.
| On Linux, Share fails at once with "user presence was not confirmed" | [Sharing on Linux](/spaces/guides/share-a-space) in Share a Space: install the latest .deb and use a desktop session with a polkit agent |
| An error name such as `capability_missing` or `permission_denied` | [Errors](/spaces/reference#errors) in the Spaces reference |
| You want Cua Spaces gone, or a clean reinstall | [Uninstall Cua Spaces](/spaces/guides/uninstall), then [Install](/spaces/guides/install) |
+| Sign-in, connecting a computer, downloads or billing fail for everyone, or the problem started suddenly | [System status](https://status.cua.ai): we post outages and updates there |
| Something else | Email [email protected] as described above |
## Next
diff --git a/libs/cua/crates/cua-spaces-app-core/parity/golden/about.json b/libs/cua/crates/cua-spaces-app-core/parity/golden/about.json
index 1edb93a588..0cb3df30e0 100644
--- a/libs/cua/crates/cua-spaces-app-core/parity/golden/about.json
+++ b/libs/cua/crates/cua-spaces-app-core/parity/golden/about.json
@@ -8,6 +8,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.2.0%20%280.2.0.123%29%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
@@ -31,6 +32,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.2.0%20%280.2.0.123%29%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
@@ -54,6 +56,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.3.0-beta.1%20%280.3.0.130%29%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
@@ -79,6 +82,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.3.0-beta.1%20%280.3.0.130%29%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
@@ -104,6 +108,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.3.0-beta.1%20%280.3.0.130%29%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
@@ -129,6 +134,7 @@
"acknowledgements Acknowledgements -> (bundled notices)",
"privacy Privacy Policy -> https://cua.ai/privacy-policy",
"terms Terms of Service -> https://cua.ai/terms-of-service",
+ "status System Status -> https://status.cua.ai",
"issue Report an Issue… -> https://github.com/trycua/cua/issues/new?template=bug.yml&environment=Cua%20Spaces%20for%20macOS%200.3.0-beta.1%0AmacOS%2026.0%20%28arm64%29"
],
"title": "Cua Spaces for macOS",
diff --git a/libs/cua/crates/cua-spaces-app-core/src/about.rs b/libs/cua/crates/cua-spaces-app-core/src/about.rs
index a95278e2da..8fd3065942 100644
--- a/libs/cua/crates/cua-spaces-app-core/src/about.rs
+++ b/libs/cua/crates/cua-spaces-app-core/src/about.rs
@@ -2,7 +2,7 @@
// Copyright (c) 2026 Cua AI, Inc.
//! Settings, About: the app's name and version, its links (acknowledgements,
-//! privacy policy, terms, an issue report), the copyright line, and, where
+//! privacy policy, terms, system status, an issue report), the copyright line, and, where
//! the app updates itself (the macOS app, through Sparkle), the update
//! controls: automatic checks, automatic installs, the channel (Stable or
//! Beta), Check Now and the last check.
@@ -22,6 +22,9 @@ use crate::settings::SettingsOption;
pub const PRIVACY_URL: &str = "https://cua.ai/privacy-policy";
/// The terms of service.
pub const TERMS_URL: &str = "https://cua.ai/terms-of-service";
+/// The public status page: whether sign-in, the relay, the Spaces API,
+/// downloads and billing are up.
+pub const STATUS_URL: &str = "https://status.cua.ai";
/// A new issue from the repository's bug report form.
pub const ISSUE_URL: &str = "https://github.com/trycua/cua/issues/new";
/// The copyright line.
@@ -103,6 +106,8 @@ pub enum AboutLinkId {
Privacy,
/// The terms of service.
Terms,
+ /// The public status page.
+ Status,
/// A new issue.
Issue,
}
@@ -155,7 +160,7 @@ pub struct AboutView {
pub title: String,
/// "Version 0.2.0 (0.2.0.123)".
pub version_line: String,
- /// Acknowledgements, Privacy Policy, Terms of Service, Report an Issue.
+ /// Acknowledgements, Privacy Policy, Terms of Service, System Status, Report an Issue.
pub links: Vec<AboutLink>,
/// "© 2026 Cua AI, Inc. All rights reserved."
pub copyright: String,
@@ -265,6 +270,11 @@ pub fn view(input: &AboutInput) -> AboutView {
"Terms of Service",
Some(TERMS_URL.into()),
),
+ link(
+ AboutLinkId::Status,
+ "System Status",
+ Some(STATUS_URL.into()),
+ ),
link(
AboutLinkId::Issue,
"Report an Issue\u{2026}",
@@ -428,6 +438,7 @@ mod tests {
"Acknowledgements",
"Privacy Policy",
"Terms of Service",
+ "System Status",
"Report an Issue\u{2026}"
]
);
@@ -440,6 +451,7 @@ mod tests {
v.links[2].url.as_deref(),
Some("https://cua.ai/terms-of-service")
);
+ assert_eq!(v.links[3].url.as_deref(), Some("https://status.cua.ai"));
}
#[test]
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 da5af3d702..7861d63cb1 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
@@ -6469,6 +6469,8 @@ pub enum AppAboutLinkId {
Privacy,
/// The terms of service.
Terms,
+ /// The public status page.
+ Status,
/// A new issue.
Issue,
}
@@ -6521,7 +6523,7 @@ pub struct AppAboutView {
pub title: String,
/// "Version 0.2.0 (0.2.0.123)".
pub version_line: String,
- /// Acknowledgements, Privacy Policy, Terms of Service, Report an Issue.
+ /// Acknowledgements, Privacy Policy, Terms of Service, System Status, Report an Issue.
pub links: Vec<AppAboutLink>,
/// "© 2026 Cua AI, Inc. All rights reserved."
pub copyright: String,
diff --git a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift
index 2bbbc924a6..683a176ce5 100644
--- a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift
+++ b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift
@@ -3328,7 +3328,7 @@ public struct AppAboutView: Equatable, Hashable {
*/
public var versionLine: String
/**
- * Acknowledgements, Privacy Policy, Terms of Service, Report an Issue.
+ * Acknowledgements, Privacy Policy, Terms of Service, System Status, Report an Issue.
*/
public var links: [AppAboutLink]
/**
@@ -3350,7 +3350,7 @@ public struct AppAboutView: Equatable, Hashable {
* "Version 0.2.0 (0.2.0.123)".
*/versionLine: String,
/**
- * Acknowledgements, Privacy Policy, Terms of Service, Report an Issue.
+ * Acknowledgements, Privacy Policy, Terms of Service, System Status, Report an Issue.
*/links: [AppAboutLink],
/**
* "© 2026 Cua AI, Inc. All rights reserved."
@@ -48260,6 +48260,10 @@ public enum AppAboutLinkId: Equatable, Hashable {
* The terms of service.
*/
case terms
+ /**
+ * The public status page.
+ */
+ case status
/**
* A new issue.
*/
@@ -48291,7 +48295,9 @@ public struct FfiConverterTypeAppAboutLinkId: FfiConverterRustBuffer {
case 3: return .terms
- case 4: return .issue
+ case 4: return .status
+
+ case 5: return .issue
default: throw UniffiInternalError.unexpectedEnumCase
}
@@ -48313,9 +48319,13 @@ public struct FfiConverterTypeAppAboutLinkId: FfiConverterRustBuffer {
writeInt(&buf, Int32(3))
- case .issue:
+ case .status:
writeInt(&buf, Int32(4))
+
+ case .issue:
+ writeInt(&buf, Int32(5))
+
}
}
}