Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
feat(spaces): the warming home stays out of the top bar and off the phone until a person writes into it (#6513)
dduponta7f27ccecbf8
diff --git a/apps/cua-spaces-desktop/src/bridge/host-start.ts b/apps/cua-spaces-desktop/src/bridge/host-start.tsindex b28fac9be0..4d010cdcfb 100644--- a/apps/cua-spaces-desktop/src/bridge/host-start.ts+++ b/apps/cua-spaces-desktop/src/bridge/host-start.ts@@ -31,9 +31,9 @@ export function isMachineDesktop(space: Pick<AppSpace, "id" | "status" | "providreturn own.length > 0 && !own.includes("/") && !own.startsWith("space-");}-/** The Spaces the user created (what the menu and the tray count and list). */-export const realSpaces = <T extends Pick<AppSpace, "id" | "status" | "provider" | "host">>(spaces: readonly T[]): T[] =>- spaces.filter((s) => !isMachineDesktop(s));+/** The Spaces the user created (what the menu and the tray count and list), never the home warming for Home's prompt box (`hidden`). */+export const realSpaces = <T extends Pick<AppSpace, "id" | "status" | "provider" | "host"> & { hidden?: boolean }>(spaces: readonly T[]): T[] =>+ spaces.filter((s) => !isMachineDesktop(s) && !s.hidden);/** The menu bar item's menu (the core's `appMenu`): the count, the Volume's sync line and conflicts, then Open, New Space, Settings and Quit. */export function menuItems(ctx: BridgeContext): AppMenuItem[] {diff --git a/apps/cua-spaces-desktop/src/model/backend.ts b/apps/cua-spaces-desktop/src/model/backend.tsindex 154cd870d6..b34f6d205f 100644--- a/apps/cua-spaces-desktop/src/model/backend.ts+++ b/apps/cua-spaces-desktop/src/model/backend.ts@@ -526,6 +526,8 @@ export class LiveSpacesBackend implements SpacesBackend {imageDigest: text(info.imageDigest),kind: kindOf(this.native, info.kind),arch: text(info.arch),+ // The home warming for Home's prompt box (label `cua.hidden`): no list shows it.+ hidden: Boolean(info.labels?.has("cua.hidden")),reachable: false,error: undefined,host: text(info.host),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.tsindex cf855f7e7a..b3d172b1d1 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@@ -13263,7 +13263,15 @@ export type AppSpace = {* Who it belongs to, who else has it and what you may do with it* ([`crate::spaces::access`]). Absent reads as yours with nobody else.*/- access?: AppSpaceAccess+ access?: AppSpaceAccess,+ /**+ * The home that warms in the background for Home's prompt box, until a+ * person writes into it: no list shows it (not the Spaces list, the+ * sidebar, the palette, the menu bar item or the notch; see+ * [`crate::spaces::openable_spaces`]). Its own page still opens. The+ * SDK and `cua spaces ls` still return it, marked.+ */+ hidden: boolean}/**@@ -13312,7 +13320,8 @@ const FfiConverterTypeAppSpace = (() => {cloud: FfiConverterOptionalString.read(from),cloudPlace: FfiConverterOptionalString.read(from),cloudDelete: FfiConverterOptionalString.read(from),- access: FfiConverterOptionalTypeAppSpaceAccess.read(from)+ access: FfiConverterOptionalTypeAppSpaceAccess.read(from),+ hidden: FfiConverterBool.read(from)};}write(value: TypeName, into: RustBuffer): void {@@ -13342,6 +13351,7 @@ const FfiConverterTypeAppSpace = (() => {FfiConverterOptionalString.write(value.cloudPlace, into);FfiConverterOptionalString.write(value.cloudDelete, into);FfiConverterOptionalTypeAppSpaceAccess.write(value.access, into);+ FfiConverterBool.write(value.hidden, into);}allocationSize(value: TypeName): number {return FfiConverterString.allocationSize(value.id) +@@ -13369,7 +13379,8 @@ const FfiConverterTypeAppSpace = (() => {FfiConverterOptionalString.allocationSize(value.cloud) +FfiConverterOptionalString.allocationSize(value.cloudPlace) +FfiConverterOptionalString.allocationSize(value.cloudDelete) +- FfiConverterOptionalTypeAppSpaceAccess.allocationSize(value.access);+ FfiConverterOptionalTypeAppSpaceAccess.allocationSize(value.access) ++ FfiConverterBool.allocationSize(value.hidden);}};@@ -44358,6 +44369,11 @@ export type AppSpaceRow = {* `aarch64`, `amd64`, `x86_64`).*/arch?: string,+ /**+ * The SDK's `SpaceInfo.hidden` (label `cua.hidden`): the home warming+ * for Home's prompt box. No list shows it ([`Space::hidden`]).+ */+ hidden: boolean,/*** Answered the last connect.*/@@ -44444,6 +44460,7 @@ const FfiConverterTypeAppSpaceRow = (() => {imageDigest: FfiConverterOptionalString.read(from),kind: FfiConverterOptionalTypeAppSpaceKind.read(from),arch: FfiConverterOptionalString.read(from),+ hidden: FfiConverterBool.read(from),reachable: FfiConverterBool.read(from),error: FfiConverterOptionalString.read(from),host: FfiConverterOptionalString.read(from),@@ -44472,6 +44489,7 @@ const FfiConverterTypeAppSpaceRow = (() => {FfiConverterOptionalString.write(value.imageDigest, into);FfiConverterOptionalTypeAppSpaceKind.write(value.kind, into);FfiConverterOptionalString.write(value.arch, into);+ FfiConverterBool.write(value.hidden, into);FfiConverterBool.write(value.reachable, into);FfiConverterOptionalString.write(value.error, into);FfiConverterOptionalString.write(value.host, into);@@ -44499,6 +44517,7 @@ const FfiConverterTypeAppSpaceRow = (() => {FfiConverterOptionalString.allocationSize(value.imageDigest) +FfiConverterOptionalTypeAppSpaceKind.allocationSize(value.kind) +FfiConverterOptionalString.allocationSize(value.arch) ++ FfiConverterBool.allocationSize(value.hidden) +FfiConverterBool.allocationSize(value.reachable) +FfiConverterOptionalString.allocationSize(value.error) +FfiConverterOptionalString.allocationSize(value.host) +diff --git a/apps/cua-spaces-desktop/test/create-extras.test.ts b/apps/cua-spaces-desktop/test/create-extras.test.tsindex 81817b8fbf..1ac4d69bb6 100644--- a/apps/cua-spaces-desktop/test/create-extras.test.ts+++ b/apps/cua-spaces-desktop/test/create-extras.test.ts@@ -6,6 +6,10 @@ import { describe, expect, it } from "vitest";import { createExtrasOf } from "../src/model/backend";describe("a create's extras", () => {+ it("carries the warming home's labels (hidden, off the relay) as they come", () => {+ expect(createExtrasOf({ image: "x", labels: { "cua.hidden": "home", "cua.relay": "off" } })).toEqual({ labels: { "cua.hidden": "home", "cua.relay": "off" } });+ });+it("carry an agent home's children and labels", () => {expect(createExtrasOf({ image: "x", children: true, labels: { "cua.home": "1", "cua.home.agent": "claude-code" } })).toEqual({children: true,diff --git a/apps/cua-spaces-desktop/test/fixtures.ts b/apps/cua-spaces-desktop/test/fixtures.tsindex 8c4a19e0c4..e4b5236f68 100644--- a/apps/cua-spaces-desktop/test/fixtures.ts+++ b/apps/cua-spaces-desktop/test/fixtures.ts@@ -52,6 +52,7 @@ export function sampleRows(n: Native): AppSpaceRow[] {imageDigest: undefined,kind: undefined,arch: undefined,+ hidden: false,reachable: true,error: undefined,host: undefined,diff --git a/apps/cua-spaces-desktop/test/host-bridge.test.ts b/apps/cua-spaces-desktop/test/host-bridge.test.tsindex 5db92e1f37..6cfbb37644 100644--- a/apps/cua-spaces-desktop/test/host-bridge.test.ts+++ b/apps/cua-spaces-desktop/test/host-bridge.test.ts@@ -989,6 +989,33 @@ describe.skipIf(!built)("This machine, Devices and Settings on the app core", ()expect(items.map((i) => i.id)).toEqual(expect.arrayContaining(["open", "newSpace", "settings", "quit"]));});+ it("the home warming for Home's prompt box is in no top bar view until a person writes into it", async () => {+ const { wireView } = await import("../src/notch/core");+ await call("host.setUp", { request: { mode: "direct", direct: "0.0.0.0:3211" } });+ const base = backend.rowsNow[2]!;+ const home = { ...base, id: "local:home-claude-code", name: "home-claude-code", provider: "local", host: undefined, reachable: true, power: undefined, powerState: undefined };+ backend.rowsNow = [...backend.rowsNow, { ...home, hidden: true }];+ await model.refresh();+ const core = native as unknown as import("../src/notch/core").NotchCore;+ const tiles = () => {+ const shown = core.appNotchReduce(core.appNotchInitial(), { tag: "Visibility", inner: { shown: true } });+ const opened = core.appNotchReduce(shown.state, { tag: "Click" });+ return wireView(core.appNotchView(opened.state, model.spaces));+ };+ // Warming: the list the SDK returns keeps it (marked), the menu, the tray and the notch do not.+ expect(model.spaces.find((s) => s.id === home.id)?.hidden).toBe(true);+ expect(realSpaces(model.spaces).map((s) => s.id)).not.toContain(home.id);+ expect(tiles().tiles.map((t) => t.id)).not.toContain(home.id);+ const before = menuItems(bridge.context)[0]!.label;+ expect(before).toBe(native.appOnStatusLine(native.appOnCount(model.spaces)));+ // The first message: the daemon clears the mark and the next list has it.+ backend.rowsNow = backend.rowsNow.map((r) => (r.id === home.id ? { ...r, hidden: false } : r));+ await model.refresh();+ expect(realSpaces(model.spaces).map((s) => s.id)).toContain(home.id);+ expect(tiles().tiles.map((t) => t.id)).toContain(home.id);+ expect(menuItems(bridge.context)[0]!.label).not.toBe(before);+ });+it("the notch lists the Spaces, never a machine that only provides them (CUA-1619)", async () => {const { wireView } = await import("../src/notch/core");await call("host.setUp", { request: { mode: "direct", direct: "0.0.0.0:3211" } });diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swiftindex a1e056ede7..3033e69906 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/AppModel.swift@@ -564,7 +564,7 @@ public final class AppModel {/// Your Spaces: neither This machine nor one of your machines.var realSpaces: [AppSpace] {- spaces.filter { !$0.id.hasPrefix("relay:") && !detail($0).isHost }+ spaces.filter { !$0.id.hasPrefix("relay:") && !detail($0).isHost && !$0.hidden }}/// Where "Add a computer" opens: the New UI's sheet (one row per way todiff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/SpacesBackend.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/SpacesBackend.swiftindex ffce55b9b6..eea93f5939 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/SpacesBackend.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/Models/SpacesBackend.swift@@ -587,7 +587,8 @@ public final class LiveSpacesBackend: SpacesBackend, @unchecked Sendable {image: info.image.isEmpty ? nil : info.image,imageDigest: info.imageDigest.isEmpty ? nil : info.imageDigest,kind: AppSpaceKind(word: info.kind), arch: info.arch.isEmpty ? nil : info.arch,- reachable: false, error: nil, host: info.host.isEmpty ? nil : info.host, hostName: info.hostName.isEmpty ? nil : info.hostName,+ // The home warming for Home's prompt box (label `cua.hidden`): no list shows it.+ hidden: info.labels["cua.hidden"] != nil, reachable: false, error: nil, host: info.host.isEmpty ? nil : info.host, hostName: info.hostName.isEmpty ? nil : info.hostName,power: info.power.isEmpty ? nil : info.power,powerState: info.powerState.isEmpty ? nil : info.powerState,cloud: info.cloud.isEmpty ? nil : info.cloud,@@ -1530,17 +1531,17 @@ public final class FixtureSpacesBackend: SpacesBackend, @unchecked Sendable {os: .linux, osName: "Ubuntu", osPrettyName: "Ubuntu 24.04.3 LTS",image: "ghcr.io/trycua/linux:24.04",imageDigest: "sha256:4f1c2a9d8e7b6c5a4f3e2d1c0b9a8f7e6d5c4b3a2f1e0d9c8b7a6f5e4d3c2b1a",- kind: .container, arch: "arm64", reachable: true, error: nil, host: nil, hostName: nil,+ kind: .container, arch: "arm64", hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: "suspend", powerState: "running", cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil),AppSpaceRow(id: "direct:builder", name: "builder", displayName: nil, provider: "direct", spacesdVersion: "0.4.0",features: ["desktop_stream"], addedAt: "2026-09-24T08:00:00Z",os: .linux, osName: "Arch Linux", osPrettyName: nil, image: nil, imageDigest: nil,- kind: nil, arch: nil, reachable: false, error: "timed out", host: nil, hostName: nil,+ kind: nil, arch: nil, hidden: false, reachable: false, error: "timed out", host: nil, hostName: nil,power: nil, powerState: nil, cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil),AppSpaceRow(id: "direct:10.0.0.5:3211", name: "10.0.0.5:3211", displayName: nil, provider: "direct",spacesdVersion: "0.4.0", features: [], addedAt: nil, os: .windows,osName: "Windows", osPrettyName: "Windows Server 2022 Datacenter 10.0.20348",- image: nil, imageDigest: nil, kind: nil, arch: nil, reachable: true, error: nil, host: nil, hostName: nil,+ image: nil, imageDigest: nil, kind: nil, arch: nil, hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: nil, powerState: nil, cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil),]@@ -1616,7 +1617,7 @@ public final class FixtureSpacesBackend: SpacesBackend, @unchecked Sendable {spacesdVersion: "0.4.0", features: ["desktop_stream"],addedAt: nil, os: .linux, osName: nil, osPrettyName: nil,image: args.image, imageDigest: nil, kind: args.kind, arch: nil,- reachable: true, error: nil, host: nil, hostName: nil,+ hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: nil, powerState: nil, cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil))return id}diff --git a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/WebHost/SyntheticStreamProvider.swift b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/WebHost/SyntheticStreamProvider.swiftindex a59d810f83..388202233d 100644--- a/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/WebHost/SyntheticStreamProvider.swift+++ b/apps/cua-spaces-macos/Sources/CuaSpacesMacKit/WebHost/SyntheticStreamProvider.swift@@ -250,16 +250,27 @@ extension FixtureSpacesBackend {id: "relay:m1", name: "ellieln", displayName: nil, provider: "relay", spacesdVersion: "0.7.0",features: ["desktop_stream", "window_stream", "host_spaces"], addedAt: nil,os: .linux, osName: "Ubuntu", osPrettyName: "Ubuntu 24.04.3 LTS", image: nil, imageDigest: nil,- kind: nil, arch: nil, reachable: true, error: nil, host: nil, hostName: nil,+ kind: nil, arch: nil, hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: nil, powerState: "running", cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil))// A Space it provides, for comparison with its desktop row.base.append(AppSpaceRow(id: "relay:m1/xm1", name: "0123456789ab", displayName: nil, provider: "relay", spacesdVersion: "0.7.0",features: ["desktop_stream"], addedAt: nil,os: .linux, osName: "Ubuntu", osPrettyName: "Ubuntu 24.04.3 LTS", image: nil, imageDigest: nil,- kind: nil, arch: nil, reachable: true, error: nil, host: "m1", hostName: "ellieln",+ kind: nil, arch: nil, hidden: false, reachable: true, error: nil, host: "m1", hostName: "ellieln",power: nil, powerState: "running", cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil))}+ // `CUA_SPACES_FIXTURE_WARMING_HOME=hidden|visible`: the home that warms for Home's prompt box,+ // running: `hidden` before a person writes into it (in no top bar view), `visible` after.+ if let state = environment["CUA_SPACES_FIXTURE_WARMING_HOME"], ["hidden", "visible"].contains(state) {+ base.append(AppSpaceRow(+ id: "local:home-claude-code", name: "home-claude-code", displayName: nil, provider: "local",+ spacesdVersion: "0.7.0", features: ["desktop_stream"], addedAt: nil,+ os: .linux, osName: "Ubuntu", osPrettyName: "Ubuntu 24.04.3 LTS", image: nil, imageDigest: nil,+ kind: .container, arch: nil, hidden: state == "hidden", reachable: true, error: nil, host: nil,+ hostName: nil, power: nil, powerState: "running", cloud: nil, cloudPlace: nil, cloudDelete: nil,+ stopReason: nil, sharing: nil))+ }// `CUA_SPACES_FIXTURE_STOPPED=<n>`: `n` suspended or stopped Spaces that// one of your machines provides, with no recorded add date (so they read// as seen just now), the notch's ordering regression.@@ -271,7 +282,7 @@ extension FixtureSpacesBackend {id: "relay:ip-172-31-46-222/\(names[i])", name: names[i], displayName: nil, provider: "relay",spacesdVersion: "0.7.0", features: ["desktop_stream"], addedAt: nil,os: .unknown, osName: nil, osPrettyName: nil, image: nil, imageDigest: nil,- kind: nil, arch: nil, reachable: false, error: nil, host: "ip-172-31-46-222",+ kind: nil, arch: nil, hidden: false, reachable: false, error: nil, host: "ip-172-31-46-222",hostName: "ip-172-31-46-222", power: i % 2 == 0 ? "suspend" : "stop", powerState: state,cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil))}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/BulkDeleteTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/BulkDeleteTests.swiftindex 2d6226ad07..d0e097d4b2 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/BulkDeleteTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/BulkDeleteTests.swift@@ -20,7 +20,7 @@ struct BulkDeleteTests {static func sharedRow() -> AppSpaceRow {AppSpaceRow(id: "relay:space-sam-qa", name: "qa-shared", displayName: nil, provider: "relay", spacesdVersion: "0.4.0",features: [], addedAt: nil, os: .macos, osName: nil, osPrettyName: nil, image: nil,- imageDigest: nil, kind: nil, arch: nil, reachable: true, error: nil, host: nil,+ imageDigest: nil, kind: nil, arch: nil, hidden: false, reachable: true, error: nil, host: nil,hostName: "Mac mini", power: "stop", powerState: "running", cloud: nil, cloudPlace: nil,cloudDelete: nil, stopReason: nil,sharing: AppSpaceSharingFacts(ownerId: "sam", ownerEmail: "[email protected]",diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/CreateExtrasTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/CreateExtrasTests.swiftindex dc3aabca8d..bae69ac6e0 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/CreateExtrasTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/CreateExtrasTests.swift@@ -8,6 +8,11 @@ import Testing/// What `spaces.create` forwards for an agent home (CUA-2630): the spawn capability and its `cua.home.*` labels.@Suite("A create's extras")struct CreateExtrasTests {+ @Test func theWarmingHomesLabelsComeAsTheyCome() {+ let e = CreateExtrasValue.parse(["image": "x", "labels": ["cua.hidden": "home", "cua.relay": "off"]])+ #expect(e.labels == ["cua.hidden": "home", "cua.relay": "off"])+ }+@Test func carryAnAgentHomesChildrenAndLabels() {let e = CreateExtrasValue.parse(["image": "x", "children": true,diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/FactCopyTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/FactCopyTests.swiftindex b6ef68a968..6cfe731b94 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/FactCopyTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/FactCopyTests.swift@@ -15,7 +15,7 @@ struct FactCopyTests {let row = AppSpaceRow(id: "direct:127.0.0.1:34752", name: "studio", displayName: nil, provider: "direct",spacesdVersion: "0.4.0", features: [], addedAt: nil, os: .linux,osName: nil, osPrettyName: nil, image: nil, imageDigest: nil,- kind: nil, arch: nil, reachable: true, error: nil, host: nil, hostName: nil,+ kind: nil, arch: nil, hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: nil, powerState: nil, cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil)let facts = appSpaceDetail(space: appRowsToSpaces(rows: [row], nowMs: 0)[0]).facts#expect(facts.filter { $0.copy != nil }.map(\.label) == ["Identifier"])diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MachineAccessTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MachineAccessTests.swiftindex 68ab7c34b2..d894f5ed73 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MachineAccessTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/MachineAccessTests.swift@@ -22,7 +22,7 @@ enum MachinesFixture {addedAt: "2026-09-28T08:00:00Z", os: os,osName: os == .macos ? "macOS" : "Ubuntu",osPrettyName: os == .macos ? "macOS 26.0" : "Ubuntu 24.04.3 LTS",- image: nil, imageDigest: nil, kind: nil, arch: "arm64", reachable: reachable,+ image: nil, imageDigest: nil, kind: nil, arch: "arm64", hidden: false, reachable: reachable,error: error, host: host, hostName: hostName, power: power, powerState: powerState,cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil)}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SnapshotTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SnapshotTests.swiftindex eacd855250..55aa0338e8 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SnapshotTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SnapshotTests.swift@@ -276,7 +276,7 @@ struct SnapshotTests {AppSpaceRow(id: id, name: name, displayName: nil, provider: provider, spacesdVersion: "0.4.0",features: ["desktop_stream"], addedAt: "2026-09-25T08:00:00Z",os: os, osName: osName, osPrettyName: nil, image: nil, imageDigest: nil,- kind: nil, arch: "arm64", reachable: true, error: nil, host: host, hostName: hostName,+ kind: nil, arch: "arm64", hidden: false, reachable: true, error: nil, host: host, hostName: hostName,power: nil, powerState: nil, cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil)}let backend = FixtureSpacesBackend(rows: [diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SpaceMenuTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SpaceMenuTests.swiftindex 0ef5a62be0..65e4139b59 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SpaceMenuTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/SpaceMenuTests.swift@@ -19,7 +19,7 @@ struct SpaceMenuTests {AppSpaceRow(id: id, name: name, displayName: nil, provider: provider, spacesdVersion: "0.4.0",features: ["desktop_stream"], addedAt: "2026-09-25T08:00:00Z", os: .linux,osName: "Ubuntu", osPrettyName: nil, image: nil, imageDigest: nil, kind: .container,- arch: "arm64", reachable: running, error: nil, host: nil, hostName: hostName,+ arch: "arm64", hidden: false, reachable: running, error: nil, host: nil, hostName: hostName,power: "stop", powerState: running ? "running" : "stopped", cloud: nil, cloudPlace: nil,cloudDelete: nil, stopReason: nil, sharing: sharing)}@@ -51,6 +51,31 @@ struct SpaceMenuTests {return m}+ /// The home that warms for Home's prompt box (the daemon marks it `hidden`) is in no top bar view:+ /// not the menu bar item's count, the notch's tab, nor `realSpaces`. The first message clears the+ /// mark and it appears; a home the app did not prepare is never hidden.+ @Test func aWarmingHomeIsInNoTopBarViewUntilTheFirstMessage() async throws {+ func home(hidden: Bool) -> AppSpaceRow {+ var r = Self.row("local:home-claude-code", "home-claude-code", running: true)+ r.hidden = hidden+ return r+ }+ let other = Self.row("local:other", "other", running: true)+ let backend = FixtureSpacesBackend(rows: [home(hidden: true), other])+ let m = await makeModel(backend)+ // Listed by the core (marked), shown by none of the top bar views.+ #expect(try space(m, "local:home-claude-code").hidden)+ #expect(m.realSpaces.map(\.id) == ["local:other"])+ #expect(m.menuBar.first?.label == "1 Space running")+ #expect(appOnCount(spaces: m.spaces) == 1)++ backend.fixtureRows = [home(hidden: false), other]+ await m.refresh()+ #expect(m.realSpaces.map(\.id).sorted() == ["local:home-claude-code", "local:other"])+ #expect(m.menuBar.first?.label == "2 Spaces running")+ #expect(appOnCount(spaces: m.spaces) == 2)+ }+func space(_ m: AppModel, _ id: String) throws -> AppSpace {try #require(m.spaces.first { $0.id == id })}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/StalePollTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/StalePollTests.swiftindex a6432c164d..ceb85167b5 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/StalePollTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/StalePollTests.swift@@ -105,7 +105,7 @@ import TestingAppSpaceRow(id: id, name: String(id.split(separator: ":").last ?? ""), displayName: nil, provider: "local",spacesdVersion: "0.5.3", features: ["desktop_stream"], addedAt: nil, os: .linux,osName: nil, osPrettyName: nil, image: "ghcr.io/trycua/linux:24.04", imageDigest: nil,- kind: .container, arch: nil, reachable: true, error: nil, host: nil, hostName: nil,+ kind: .container, arch: nil, hidden: false, reachable: true, error: nil, host: nil, hostName: nil,power: nil, powerState: "running", cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil)}diff --git a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swiftindex 395b0a2896..60d88a1467 100644--- a/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift+++ b/apps/cua-spaces-macos/Tests/CuaSpacesMacTests/ViewModelTests.swift@@ -791,7 +791,7 @@ struct ViewModelTests {let name = "e2e-1005-gamma-macos"let record = AppSpaceRow(id: "relay:96fe/space-46e0", name: name, displayName: nil, provider: "relay", spacesdVersion: "",features: [], addedAt: nil, os: nil, osName: nil, osPrettyName: nil, image: nil,- imageDigest: nil, kind: nil, arch: nil, reachable: false, error: nil,+ imageDigest: nil, kind: nil, arch: nil, hidden: false, reachable: false, error: nil,host: "96fe", hostName: "gamma-4 Mac Studio", power: nil, powerState: nil,cloud: nil, cloudPlace: nil, cloudDelete: nil, stopReason: nil, sharing: nil)let backend = FixtureSpacesBackend(rows: [record])@@ -1226,7 +1226,7 @@ struct ViewModelTests {func cloudRow(_ id: String, _ name: String, _ cloud: String, _ place: String, _ delete: String) -> AppSpaceRow {AppSpaceRow(id: id, name: name, displayName: nil, provider: "relay", spacesdVersion: "0.4.0", features: [], addedAt: nil,os: .linux, osName: nil, osPrettyName: nil, image: nil, imageDigest: nil, kind: nil, arch: nil,- reachable: true, error: nil, host: nil, hostName: nil, power: nil, powerState: nil,+ hidden: false, reachable: true, error: nil, host: nil, hostName: nil, power: nil, powerState: nil,cloud: cloud, cloudPlace: place, cloudDelete: delete, stopReason: nil, sharing: nil)}let backend = FixtureSpacesBackend(rows: [diff --git a/apps/cua-spaces-web/src/lib/prepare/__tests__/home-request.test.ts b/apps/cua-spaces-web/src/lib/prepare/__tests__/home-request.test.tsindex 1437add659..93485b21b5 100644--- a/apps/cua-spaces-web/src/lib/prepare/__tests__/home-request.test.ts+++ b/apps/cua-spaces-web/src/lib/prepare/__tests__/home-request.test.ts@@ -27,6 +27,11 @@ describe("the new setup's first Space create", () => {expect(NO_LINUX_OFFER).not.toMatch(/config|image:|string/);});+ it("is labelled hidden and off the relay: out of the top bar and off the phone's list until a person writes into it", () => {+ const offer = { id: "linux", os: "linux", image: "ghcr.io/trycua/linux:24.04-slim", name: "Ubuntu", size: null, time: "", blocked: null, args: { image: "ghcr.io/trycua/linux:24.04-slim", on: "local", kind: "container", runtime: "auto", spacesd: true } } as FirstSpaceOffer;+ expect(homeCreateRequest([offer], "home-claude-code")).toMatchObject({ name: "home-claude-code", labels: { "cua.hidden": "home", "cua.relay": "off" } });+ });+it.skipIf(!wasmBuilt)("is the wizard's Linux offer for this machine, under the home's name", async () => {const core = await testCore();const offers = firstSpaceOffers(core, MAC, "macos");diff --git a/apps/cua-spaces-web/src/lib/prepare/home-request.ts b/apps/cua-spaces-web/src/lib/prepare/home-request.tsindex 1246cb74b6..813c644509 100644--- a/apps/cua-spaces-web/src/lib/prepare/home-request.ts+++ b/apps/cua-spaces-web/src/lib/prepare/home-request.ts@@ -23,6 +23,9 @@ export interface HomeOffer {/** The page's create request (`bridge/store.ts`'s `CreateSpaceRequest`). */export type HomeCreateRequest = SpaceCreateConfig & { os: "linux" };+/** The labels of the home that warms in the background (`registry::HIDDEN_LABEL` and `RELAY_LABEL`). */+export const HOME_WARMING_LABELS = { "cua.hidden": "home", "cua.relay": "off" } as const;+/** The words preparing stops with when this machine has no Linux Space to offer. */export const NO_LINUX_OFFER = "This computer can't make a Linux Space right now. Open New Space to see why.";@@ -37,5 +40,7 @@ export function homeCreateRequest(offers: readonly HomeOffer[], name: string): Hif (linux.blocked) throw new Error(linux.blocked);const image = linux.args.image || linux.image;if (!image) throw new Error(NO_LINUX_OFFER);- return { ...linux.args, image, os: "linux", name };+ // The home warms in the background: labelled hidden and off the relay, so it stays out of the top bar and+ // off the phone's list until a person writes into its thread (the daemon then makes it visible).+ return { ...linux.args, image, os: "linux", name, labels: { ...HOME_WARMING_LABELS } };}diff --git a/libs/cua/crates/cua-cli/src/host.rs b/libs/cua/crates/cua-cli/src/host.rsindex ab37e3555f..9abf4e471a 100644--- a/libs/cua/crates/cua-cli/src/host.rs+++ b/libs/cua/crates/cua-cli/src/host.rs@@ -4335,9 +4335,12 @@ pub async fn run_spaces(if let Some(e) = relay_error {line(out, format!("(relay computers unavailable: {e})"));}+ for line_text in hidden_notes(&list) {+ line(out, line_text);+ }let stay_off: Vec<&str> = list.iter()- .filter(|i| on_account.get(&i.id) == Some(&"off"))+ .filter(|i| !i.hidden && on_account.get(&i.id) == Some(&"off")).map(|i| i.shown_name()).collect();if !stay_off.is_empty() {@@ -4355,6 +4358,27 @@ pub async fn run_spaces(Ok(0)}+/// A line per kind of hidden Space: the apps do not list it and it is not on+/// your account (its thread gets a message from a person and it is listed);+/// `ls` and the tools still return it.+fn hidden_notes(list: &[cua_spaces::SpaceInfo]) -> Vec<String> {+ let mut by_note: std::collections::BTreeMap<String, Vec<&str>> = Default::default();+ for i in list.iter().filter(|i| i.hidden) {+ let value = i+ .labels+ .get(cua_spaces::registry::HIDDEN_LABEL)+ .map_or("", String::as_str);+ by_note+ .entry(cua_spaces::registry::hidden_note(value))+ .or_default()+ .push(i.shown_name());+ }+ by_note+ .into_iter()+ .map(|(note, names)| format!("({note}: {})", names.join(", ")))+ .collect()+}+/// The durable Spaces the coordinator of your machines keeps, when a cua/// daemon of Cua Spaces runs (none otherwise; bounded).async fn durable_spaces() -> Vec<serde_json::Value> {@@ -4687,6 +4711,7 @@ mod tests {);}let space = |id: &str, labels: &[(&str, &str)]| cua_spaces::SpaceInfo {+ hidden: false,id: id.into(),name: id.into(),display_name: String::new(),@@ -4752,11 +4777,31 @@ mod tests {assert!(rows[0].contains("[run=7, team=research]"), "{rows:?}");let json = ls_json(&list);assert_eq!(json[0]["labels"]["run"], "7");++ // The home warming for Home's prompt box is listed, marked hidden+ // (`--json` and a short note); one the app did not prepare is not.+ let mut home = space("local:home-claude-code", &[("cua.hidden", "home")]);+ home.hidden = true;+ let both = vec![home, space("local:home-other", &[])];+ let json = ls_json(&both);+ assert_eq!(json.len(), 2);+ assert_eq!(json[0]["hidden"], true);+ assert!(json[1].get("hidden").is_none());+ assert_eq!(+ hidden_notes(&both),+ ["(hidden: warming for Home: local:home-claude-code)"]+ );+ assert!(+ grouped_lines(&both, &Default::default())+ .iter()+ .any(|r| r.contains("home-claude-code"))+ );}#[test]fn ls_takes_power_from_the_daemon_where_the_registry_has_none() {let space = |id: &str, power: &str| cua_spaces::SpaceInfo {+ hidden: false,id: id.into(),name: id.into(),display_name: String::new(),@@ -4826,6 +4871,7 @@ mod tests {/// Space on that machine.fn space(id: &str, host: &str) -> cua_spaces::SpaceInfo {cua_spaces::SpaceInfo {+ hidden: false,id: id.into(),name: id.into(),display_name: String::new(),@@ -5063,6 +5109,7 @@ mod tests {#[test]fn spaces_list_by_the_name_the_user_typed() {let mut s = cua_spaces::SpaceInfo {+ hidden: false,id: "local:e2e-1005-cli".into(),name: "327b8dc70418".into(),display_name: String::new(),diff --git a/libs/cua/crates/cua-cli/src/resources_view.rs b/libs/cua/crates/cua-cli/src/resources_view.rsindex 21bae6cbda..4d2f0704e7 100644--- a/libs/cua/crates/cua-cli/src/resources_view.rs+++ b/libs/cua/crates/cua-cli/src/resources_view.rs@@ -230,6 +230,7 @@ mod tests {fn info(id: &str) -> SpaceInfo {SpaceInfo {+ hidden: false,id: id.into(),name: id.into(),display_name: String::new(),diff --git a/libs/cua/crates/cua-spaces-app-core/src/host.rs b/libs/cua/crates/cua-spaces-app-core/src/host.rsindex 50e19884cc..16ab5353bc 100644--- a/libs/cua/crates/cua-spaces-app-core/src/host.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/host.rs@@ -125,6 +125,7 @@ pub fn this_machine_status(status: Option<&HostSummaryInput>) -> SpaceStatus {/// The roster entry for this machine.pub fn this_machine_space(status: Option<&HostSummaryInput>, now: i64, os: SpaceOs) -> Space {Space {+ hidden: false,id: THIS_MACHINE_ID.into(),name: os.this_machine().into(),os,diff --git a/libs/cua/crates/cua-spaces-app-core/src/keyvault/view.rs b/libs/cua/crates/cua-spaces-app-core/src/keyvault/view.rsindex 3a0adc0840..09ecd37e22 100644--- a/libs/cua/crates/cua-spaces-app-core/src/keyvault/view.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/keyvault/view.rs@@ -893,6 +893,7 @@ mod sharing_tests {fn space(id: &str, name: &str) -> crate::model::Space {let row = crate::model::SpaceRow {+ hidden: false,id: id.into(),name: name.into(),display_name: None,diff --git a/libs/cua/crates/cua-spaces-app-core/src/model.rs b/libs/cua/crates/cua-spaces-app-core/src/model.rsindex 0585f27d2c..9d5084fe2e 100644--- a/libs/cua/crates/cua-spaces-app-core/src/model.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/model.rs@@ -277,6 +277,13 @@ pub struct Space {/// ([`crate::spaces::access`]). Absent reads as yours with nobody else.#[serde(default, skip_serializing_if = "Option::is_none")]pub access: Option<SpaceAccess>,+ /// The home that warms in the background for Home's prompt box, until a+ /// person writes into it: no list shows it (not the Spaces list, the+ /// sidebar, the palette, the menu bar item or the notch; see+ /// [`crate::spaces::openable_spaces`]). Its own page still opens. The+ /// SDK and `cua spaces ls` still return it, marked.+ #[serde(default, skip_serializing_if = "std::ops::Not::not")]+ pub hidden: bool,}/// Whose a Space is, as the Spaces page groups it.@@ -553,6 +560,10 @@ pub struct SpaceRow {/// `aarch64`, `amd64`, `x86_64`).#[serde(default, skip_serializing_if = "Option::is_none")]pub arch: Option<String>,+ /// The SDK's `SpaceInfo.hidden` (label `cua.hidden`): the home warming+ /// for Home's prompt box. No list shows it ([`Space::hidden`]).+ #[serde(default)]+ pub hidden: bool,/// Answered the last connect.pub reachable: bool,/// Why not.diff --git a/libs/cua/crates/cua-spaces-app-core/src/notch/mod.rs b/libs/cua/crates/cua-spaces-app-core/src/notch/mod.rsindex e49d54e74d..d08faa1ba6 100644--- a/libs/cua/crates/cua-spaces-app-core/src/notch/mod.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/notch/mod.rs@@ -522,10 +522,12 @@ pub fn tiles_matching(spaces: &[Space], targeted: Option<&str>, query: &str) ->/// of another machine even when it cannot be opened now (offline, or no/// longer shared), so a pin is never silently dropped.fn has_tile(space: &Space, pinned: &[String]) -> bool {- !crate::spaces::is_machine_desktop(space)- || (is_remote_desktop(space)- && (desktop_availability(space) == DesktopAvailability::Available- || pinned.contains(&space.id)))+ // Never the home warming for Home's prompt box (`Space::hidden`).+ !space.hidden+ && (!crate::spaces::is_machine_desktop(space)+ || (is_remote_desktop(space)+ && (desktop_availability(space) == DesktopAvailability::Available+ || pinned.contains(&space.id))))}/// [`tiles_matching`] with the pinned Spaces and desktops (`pinned`, in thediff --git a/libs/cua/crates/cua-spaces-app-core/src/onboarding_preview.rs b/libs/cua/crates/cua-spaces-app-core/src/onboarding_preview.rsindex 3f7f34c385..1fb444c90c 100644--- a/libs/cua/crates/cua-spaces-app-core/src/onboarding_preview.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/onboarding_preview.rs@@ -210,6 +210,7 @@ fn scaled(r: NotchRadii, s: f64) -> NotchRadii {fn sample_space(name: &str, os: SpaceOs, os_name: &str, scene: ThumbnailScene) -> Space {Space {+ hidden: false,id: format!("local:{name}"),name: name.into(),os,diff --git a/libs/cua/crates/cua-spaces-app-core/src/phone/directory.rs b/libs/cua/crates/cua-spaces-app-core/src/phone/directory.rsindex a3bbfc668a..98ce0dc57e 100644--- a/libs/cua/crates/cua-spaces-app-core/src/phone/directory.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/phone/directory.rs@@ -229,6 +229,7 @@ pub fn space_row(row: &RelayRow, host_name: Option<&str>) -> SpaceRow {let host = row.host.clone().filter(|h| !h.is_empty());let os = os_of(row);SpaceRow {+ hidden: false,id: format!("relay:{}", row.id),name: if row.name.is_empty() {row.id.clone()diff --git a/libs/cua/crates/cua-spaces-app-core/src/spaces/creating.rs b/libs/cua/crates/cua-spaces-app-core/src/spaces/creating.rsindex 59d0d5d962..59a2275c06 100644--- a/libs/cua/crates/cua-spaces-app-core/src/spaces/creating.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/spaces/creating.rs@@ -1754,6 +1754,7 @@ pub fn pending_space(p: &PendingCreate) -> Space {// The catalog's distribution: the right icon and System from the start.let distro = p.image.as_deref().and_then(crate::wizard::image_distro);Space {+ hidden: false,id: p.id.clone(),name: p.name.clone(),os: p.os,@@ -3391,6 +3392,7 @@ mod tests {fn hosts_record(id: &str, name: &str, host: &str, added_at_ms: Option<i64>) -> Space {let mut s = crate::spaces::row_to_space(&crate::model::SpaceRow {+ hidden: false,id: id.into(),name: name.into(),display_name: None,diff --git a/libs/cua/crates/cua-spaces-app-core/src/spaces/mod.rs b/libs/cua/crates/cua-spaces-app-core/src/spaces/mod.rsindex fb76634c19..c9ec9a6305 100644--- a/libs/cua/crates/cua-spaces-app-core/src/spaces/mod.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/spaces/mod.rs@@ -260,6 +260,7 @@ pub fn row_to_space(row: &SpaceRow, now: i64) -> Space {cloud_place: cloud_place_of(row).map(str::to_string),cloud_delete: text(&row.cloud).and(text(&row.cloud_delete)),access: Some(access),+ hidden: row.hidden,}}@@ -443,7 +444,8 @@ pub fn desktop_availability(space: &Space) -> DesktopAvailability {/// The Spaces the user can open, in `spaces`' order: every Space, and the/// desktops of your other machines while they are there to open/// ([`desktop_availability`] is `Available`): a shared desktop is a Space.-/// Not This machine, even while it provides Spaces, and not a machine that+/// Not a hidden Space ([`Space::hidden`]: the home warming for Home's prompt+/// box, until a person writes into it). Not This machine, even while it provides Spaces, and not a machine that/// has no desktop to open (it only provides Spaces, is off or has not/// answered): the notch listed those as if they were Spaces (#5190). A Space a machine/// provides is listed. The notch's tiles list these (and the desktops a@@ -452,6 +454,7 @@ pub fn desktop_availability(space: &Space) -> DesktopAvailability {pub fn openable_spaces(spaces: &[Space]) -> Vec<Space> {spaces.iter()+ .filter(|s| !s.hidden).filter(|s| {!is_machine_desktop(s)|| (is_remote_desktop(s)@@ -638,6 +641,7 @@ mod tests {fn row() -> SpaceRow {SpaceRow {+ hidden: false,id: "space://direct/10.0.0.5:3211".into(),name: "brave-otter".into(),display_name: None,@@ -666,6 +670,93 @@ mod tests {}}+ /// The home that warms for Home's prompt box (the daemon marks it+ /// `hidden`) is in no top bar view: not the menu bar item's count, the+ /// notch's tab or its tiles. The first message makes it appear (the+ /// daemon clears the mark); a home the record did not prepare is never+ /// hidden; the core's own listing keeps the row, marked.+ #[test]+ fn a_warming_home_is_in_no_top_bar_view_until_the_first_message() {+ use crate::prepare;+ let running = |id: &str, hidden: bool| SpaceRow {+ id: id.into(),+ name: id.trim_start_matches("local:").into(),+ provider: "local".into(),+ hidden,+ ..row()+ };+ let counted = |rows: &[SpaceRow]| {+ let spaces = rows_to_spaces(rows, 0);+ let menu = crate::window::menu(&crate::window::MenuInput {+ spaces: spaces.clone(),+ ..Default::default()+ });+ (+ on_count(&spaces),+ menu[0].label.clone(),+ crate::notch::tab(&spaces).count,+ openable_spaces(&spaces).len(),+ spaces.len(),+ )+ };++ // The app prepares the home: the record names it, the daemon marks it.+ let state = prepare::State {+ wanted: true,+ home_space_id: Some("local:home-claude-code".into()),+ ..Default::default()+ };+ assert_eq!(+ prepare::hidden_spaces(&state),+ ["local:home-claude-code".to_string()]+ );+ let warming = [+ running("local:home-claude-code", true),+ running("local:other", false),+ ];+ let tile_ids = |rows: &[SpaceRow]| -> Vec<String> {+ crate::notch::tiles(&rows_to_spaces(rows, 0), None)+ .into_iter()+ .map(|t| t.id)+ .collect()+ };+ assert!(!tile_ids(&warming).contains(&"local:home-claude-code".to_string()));+ let (on, line, tab, tiles, all) = counted(&warming);+ assert_eq!(+ (on, line.as_str(), tab.as_str(), tiles),+ (1, "1 Space running", "1", 1)+ );+ assert_eq!(all, 2, "the core's listing keeps the hidden row");+ assert!(rows_to_spaces(&warming, 0)[0].hidden);+ assert!(+ !openable_spaces(&rows_to_spaces(&warming, 0))+ .iter()+ .any(|s| s.id == "local:home-claude-code")+ );++ // The first message: the record says asked, the daemon clears the mark.+ let asked = prepare::State {+ asked_ms: Some(5),+ ..state+ };+ assert!(prepare::hidden_spaces(&asked).is_empty());+ let shown = [+ running("local:home-claude-code", false),+ running("local:other", false),+ ];+ assert!(tile_ids(&shown).contains(&"local:home-claude-code".to_string()));+ let (on, line, tab, tiles, _) = counted(&shown);+ assert_eq!(+ (on, line.as_str(), tab.as_str(), tiles),+ (2, "2 Spaces running", "2", 2)+ );++ // A home of the same name the record did not prepare is not hidden.+ let (on, ..) = counted(&[running("local:home-claude-code", false)]);+ assert_eq!(on, 1);+ assert!(prepare::hidden_spaces(&prepare::State::default()).is_empty());+ }+#[test]fn a_renamed_space_shows_its_new_name_and_keeps_its_id() {let renamed = row_to_space(@@ -819,6 +910,7 @@ mod tests {#[test]fn mru_puts_the_most_recent_first() {let mk = |id: &str, t: i64| Space {+ hidden: false,id: id.into(),name: id.into(),os: SpaceOs::Linux,diff --git a/libs/cua/crates/cua-spaces-app-core/src/spaces/sidebar.rs b/libs/cua/crates/cua-spaces-app-core/src/spaces/sidebar.rsindex bda5de80f6..b44364111c 100644--- a/libs/cua/crates/cua-spaces-app-core/src/spaces/sidebar.rs+++ b/libs/cua/crates/cua-spaces-app-core/src/spaces/sidebar.rs@@ -1839,6 +1839,7 @@ mod tests {#[test]fn only_the_identifier_has_a_copy_button() {let row = SpaceRow {+ hidden: false,id: "direct:127.0.0.1:34752".into(),name: "studio".into(),display_name: None,@@ -1890,6 +1891,7 @@ mod tests {#[test]fn a_space_being_deleted_neither_streams_nor_deletes_again() {let row = SpaceRow {+ hidden: false,id: "local:demo".into(),name: "demo".into(),display_name: None,diff --git a/libs/cua/crates/cua-spaces-ext/src/thread_tools.rs b/libs/cua/crates/cua-spaces-ext/src/thread_tools.rsindex 12e2eccb41..6d8cc603a8 100644--- a/libs/cua/crates/cua-spaces-ext/src/thread_tools.rs+++ b/libs/cua/crates/cua-spaces-ext/src/thread_tools.rs@@ -126,6 +126,12 @@ pub(crate) async fn call(}),}).await?;+ // A person writing into a hidden Space (the home warming for+ // Home's prompt box) makes it visible: listed in the apps and on+ // the owner's account from now on.+ if e.author.kind == crate::thread::AuthorKind::Person {+ let _ = spaces.reveal(t.store().space()).await;+ }Ok(ToolOutcome::json(&json!({"entry": e})))}"thread_inbox" => {diff --git a/libs/cua/crates/cua-spaces-ext/tests/hidden_home_thread.rs b/libs/cua/crates/cua-spaces-ext/tests/hidden_home_thread.rsnew file mode 100644index 0000000000..6057d19640--- /dev/null+++ b/libs/cua/crates/cua-spaces-ext/tests/hidden_home_thread.rs@@ -0,0 +1,105 @@+// SPDX-License-Identifier: FSL-1.1-MIT+// Copyright (c) 2026 Cua AI, Inc.++//! The home that warms in the background for Home's prompt box is hidden+//! (label `cua.hidden`) until a person writes into its thread: the first+//! message from a person makes it visible, and nobody else does. Against the+//! in-process spacesd mock and a temporary cua home.++use cua_spaces::Spaces;+use cua_spaces::extension::Caller;+use cua_spaces::mcp::McpServer;+use cua_spacesd_client::testing::{MockAuth, MockServer};+use serde_json::{Value, json};++struct Fx {+ _srv: MockServer,+ _home: tempfile::TempDir,+ spaces: Spaces,+ space: String,+ mcp: McpServer,+}++async fn setup(hidden: bool) -> Fx {+ let srv = MockServer::start(MockAuth::default()).await;+ let home = tempfile::tempdir().unwrap();+ let spaces = cua_spaces_ext::register(+ Spaces::builder().home(home.path()),+ cua_volume::Drive::open_local(home.path()),+ None,+ )+ .build();+ let info = spaces+ .add(+ &format!("http://{}", srv.addr),+ None,+ Some("home-claude-code".into()),+ )+ .await+ .unwrap();+ if hidden {+ spaces+ .registry()+ .update_meta(&info.id, |m| {+ m.labels.insert("cua.hidden".into(), "home".into());+ m.labels.insert("cua.relay".into(), "off".into());+ })+ .unwrap();+ }+ let mcp = McpServer::new(spaces.clone());+ Fx {+ _srv: srv,+ _home: home,+ spaces,+ space: info.id,+ mcp,+ }+}++async fn call(fx: &Fx, tool: &str, args: Value) -> Value {+ let out = Caller::Owner.scope(Box::pin(fx.mcp.call(tool, args))).await;+ cua_spaces::extension::outcome_json(out).unwrap_or_else(|e| panic!("{tool}: {e}"))+}++fn listed(fx: &Fx) -> cua_spaces::SpaceInfo {+ fx.spaces.list().unwrap().into_iter().next().unwrap()+}++#[tokio::test]+async fn the_first_message_from_a_person_makes_a_hidden_home_visible() {+ let fx = setup(true).await;+ assert!(listed(&fx).hidden);+ // The tools list it, marked hidden, while it warms.+ let rows = call(&fx, "list_spaces", json!({})).await;+ assert_eq!(rows[0]["hidden"], true, "{rows}");+ // Reading its thread is not writing into it.+ call(&fx, "thread_read", json!({"space": fx.space})).await;+ assert!(listed(&fx).hidden);++ call(+ &fx,+ "thread_post",+ json!({"space": fx.space, "text": "fix the build"}),+ )+ .await;+ let info = listed(&fx);+ assert!(!info.hidden, "{info:?}");+ assert!(!info.labels.contains_key("cua.hidden"));+ // (This Space was added by address, so it has no relay row to turn on;+ // a local one is listed on the account by `reveal`: see relay_publish.)+ let rows = call(&fx, "list_spaces", json!({})).await;+ assert!(rows[0].get("hidden").is_none(), "{rows}");+}++#[tokio::test]+async fn a_home_the_app_did_not_prepare_is_never_hidden() {+ let fx = setup(false).await;+ assert!(!listed(&fx).hidden);+ call(+ &fx,+ "thread_post",+ json!({"space": fx.space, "text": "hello"}),+ )+ .await;+ assert!(!listed(&fx).hidden);+}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.rsindex 93457dcaaf..ded9a336b2 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@@ -353,6 +353,12 @@ pub struct AppSpace {/// Who it belongs to, who else has it and what you may do with it/// ([`crate::spaces::access`]). Absent reads as yours with nobody else.pub access: Option<AppSpaceAccess>,+ /// The home that warms in the background for Home's prompt box, until a+ /// person writes into it: no list shows it (not the Spaces list, the+ /// sidebar, the palette, the menu bar item or the notch; see+ /// [`crate::spaces::openable_spaces`]). Its own page still opens. The+ /// SDK and `cua spaces ls` still return it, marked.+ pub hidden: bool,}/// One row of the SDK's `list_spaces`.@@ -390,6 +396,9 @@ pub struct AppSpaceRow {/// The guest's CPU architecture, when known (any spelling: `arm64`,/// `aarch64`, `amd64`, `x86_64`).pub arch: Option<String>,+ /// The SDK's `SpaceInfo.hidden` (label `cua.hidden`): the home warming+ /// for Home's prompt box. No list shows it ([`Space::hidden`]).+ pub hidden: bool,/// Answered the last connect.pub reachable: bool,/// Why not.diff --git a/libs/cua/crates/cua-spaces/src/registry.rs b/libs/cua/crates/cua-spaces/src/registry.rsindex 3682ebce15..e5e1ce888c 100644--- a/libs/cua/crates/cua-spaces/src/registry.rs+++ b/libs/cua/crates/cua-spaces/src/registry.rs@@ -190,6 +190,23 @@ impl VolumeSetting {/// (`cua.relay=off`; `--no-relay`).pub const RELAY_LABEL: &str = "cua.relay";+/// The label on a Space no list shows (value [`HIDDEN_HOME`]): the home that+/// warms in the background for Home's prompt box. The app makes it with this+/// label and `cua.relay=off`; it stays out of the apps' lists and off the+/// owner's account until a person writes into its thread+/// ([`crate::Spaces::reveal`]). `cua spaces ls` and the tools still list it.+pub const HIDDEN_LABEL: &str = "cua.hidden";+/// [`HIDDEN_LABEL`]'s value for the home warming for Home's prompt box.+pub const HIDDEN_HOME: &str = "home";++/// What `ls` says of a hidden Space with [`HIDDEN_LABEL`] value `value`.+pub fn hidden_note(value: &str) -> String {+ match value {+ HIDDEN_HOME => "hidden: warming for Home".into(),+ _ => "hidden".into(),+ }+}+/// Whether a Space is listed on the owner's cua.ai account (the phone and/// the owner's other computers see and open it).#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]diff --git a/libs/cua/crates/cua-spaces/src/share/publish.rs b/libs/cua/crates/cua-spaces/src/share/publish.rsindex 55f46fec7a..c928810418 100644--- a/libs/cua/crates/cua-spaces/src/share/publish.rs+++ b/libs/cua/crates/cua-spaces/src/share/publish.rs@@ -263,6 +263,7 @@ impl Spaces {let m = meta.get(&id);if m.is_some_and(|m| {!m.relay.is_on()+ || m.labels.contains_key(crate::registry::HIDDEN_LABEL)|| m.labels.get(crate::registry::RELAY_LABEL).is_some_and(|v| {crate::registry::RelaySetting::parse(v).is_ok_and(|s| !s.is_on())})@@ -727,6 +728,29 @@ impl Spaces {}}+ /// Makes a hidden Space ([`crate::registry::HIDDEN_LABEL`]) visible: the+ /// apps list it from now on and the next publish pass puts it on the+ /// owner's account (`set_on_relay` on). The daemon calls it when a+ /// person writes into the Space's thread. `true` when it was hidden.+ pub async fn reveal(&self, space: &str) -> Result<bool> {+ let id = self.resolve(space)?;+ let canonical = id.to_string();+ let hidden = self+ .inner+ .registry+ .all_meta()+ .get(&canonical)+ .is_some_and(|m| m.labels.contains_key(crate::registry::HIDDEN_LABEL));+ if !hidden {+ return Ok(false);+ }+ self.inner.registry.update_meta(&canonical, |m| {+ m.labels.remove(crate::registry::HIDDEN_LABEL);+ })?;+ self.set_on_relay(space, true).await?;+ Ok(true)+ }+/// Opts a Space in or out of the account's relay (`--no-relay`). Off/// takes it off at once when this computer is signed in.pub async fn set_on_relay(&self, space: &str, on: bool) -> Result<crate::SpaceInfo> {@@ -742,9 +766,14 @@ impl Spaces {} else {crate::registry::RelaySetting::Off};- self.inner- .registry- .update_meta(&canonical, |m| m.relay = setting)?;+ self.inner.registry.update_meta(&canonical, |m| {+ m.relay = setting;+ // The label that opted it out at create (`--label cua.relay=off`)+ // would otherwise keep it off for good.+ if on {+ m.labels.remove(crate::registry::RELAY_LABEL);+ }+ })?;memo(self.home_dir(), |m| m.settled = None);CHANGED.notify_waiters();if !on {diff --git a/libs/cua/crates/cua-spaces/src/space.rs b/libs/cua/crates/cua-spaces/src/space.rsindex 9f72c483f4..c7274db73f 100644--- a/libs/cua/crates/cua-spaces/src/space.rs+++ b/libs/cua/crates/cua-spaces/src/space.rs@@ -690,6 +690,13 @@ pub struct SpaceInfo {/// that created the Space.#[serde(default, skip_serializing_if = "std::collections::BTreeMap::is_empty")]pub labels: std::collections::BTreeMap<String, String>,+ /// The Space no list shows: the home that warms in the background for+ /// Home's prompt box until a person writes into it. `ls` and the tools+ /// still return it, marked here, so it can be found, used, stopped or+ /// deleted; it is not on the owner's account until then+ /// ([`crate::registry::HIDDEN_LABEL`]).+ #[serde(default, skip_serializing_if = "std::ops::Not::not")]+ pub hidden: bool,/// When the Space ends (Unix seconds), as set by/// [`crate::Spaces::set_lifetime`]; 0 when it has no lifetime.#[serde(default, skip_serializing_if = "is_zero")]@@ -836,6 +843,7 @@ impl SpaceInfo {.iter().map(|(k, v)| (k.clone(), v.clone())).collect(),+ hidden: record.labels.contains_key(crate::registry::HIDDEN_LABEL),sharing: record.sharing.clone().map(Into::into),})}diff --git a/libs/cua/crates/cua-spaces/src/spaces.rs b/libs/cua/crates/cua-spaces/src/spaces.rsindex 3ef7844677..7a7f9ab23c 100644--- a/libs/cua/crates/cua-spaces/src/spaces.rs+++ b/libs/cua/crates/cua-spaces/src/spaces.rs@@ -489,6 +489,7 @@ pub(crate) fn relay_info(m: &crate::relay::RelayMachine) -> SpaceInfo {stop_reason: String::new(),volumes: Vec::new(),labels: BTreeMap::new(),+ hidden: false,expires_at_unix: 0,on_expire: String::new(),created_at_unix: 0,@@ -1378,6 +1379,7 @@ impl Spaces {stop_reason: String::new(),volumes: Vec::new(),labels: BTreeMap::new(),+ hidden: false,expires_at_unix: 0,on_expire: String::new(),created_at_unix: 0,@@ -1427,6 +1429,7 @@ impl Spaces {info.display_name = m.display_name.clone();}info.labels = m.labels.clone();+ info.hidden = m.labels.contains_key(crate::registry::HIDDEN_LABEL);if m.created_at_unix > 0 {info.created_at_unix = m.created_at_unix;}@@ -2774,6 +2777,7 @@ impl Spaces {result = Err(e);} else if let Ok(SpaceCreated::Ready { info, .. }) = &mut result {info.labels = labels.clone();+ info.hidden = labels.contains_key(crate::registry::HIDDEN_LABEL);info.created_at_unix = now;info.egress = egress.clone();info.egress_enforced =diff --git a/libs/cua/crates/cua-spaces/tests/relay_publish.rs b/libs/cua/crates/cua-spaces/tests/relay_publish.rsindex 3f4a4c54d2..8def715136 100644--- a/libs/cua/crates/cua-spaces/tests/relay_publish.rs+++ b/libs/cua/crates/cua-spaces/tests/relay_publish.rs@@ -438,6 +438,78 @@ async fn spaces_added_by_address_and_opted_out_ones_stay_off() {assert_eq!(w.rows().await.len(), 1);}+/// The home that warms in the background for Home's prompt box is made+/// hidden (`cua.hidden=home` with `cua.relay=off`, as the app makes it): it+/// stays off the relay (the phone) and `ls` / the tools still return it,+/// marked hidden. A person writing into it (`reveal`) lists it from the+/// next pass; a home of the same name the app did not prepare is never+/// hidden.+#[tokio::test]+async fn a_hidden_home_stays_off_the_relay_until_a_person_writes_into_it() {+ let w = World::new().await;+ for n in ["home-claude-code", "plain-home"] {+ w.driver(n).await;+ }+ let make = |name: &str, labels: &[(&str, &str)]| {+ let spaces = w.spaces.clone();+ let opts = SpaceCreate {+ on: Some(On::Local),+ image: Some("linux".into()),+ name: Some(name.into()),+ timeout: Some(Duration::from_secs(30)),+ labels: labels+ .iter()+ .map(|(k, v)| (k.to_string(), v.to_string()))+ .collect(),+ ..Default::default()+ };+ async move {+ let id = spaces.create(opts).await.unwrap().ready().unwrap().id;+ spaces+ .registry()+ .update_meta(&id, |m| m.created_at_unix = 1)+ .unwrap();+ id+ }+ };+ make(+ "home-claude-code",+ &[("cua.relay", "off"), ("cua.hidden", "home")],+ )+ .await;+ make("plain-home", &[]).await;++ let r = w.spaces.publish_to_relay().await.unwrap();+ assert_eq!(r.published, ["local:plain-home"], "{r:?}");+ assert!(!w.attached("home-claude-code"));+ assert_eq!(w.rows().await.len(), 1);++ // `ls` and the tools keep returning it, marked hidden; the home the app+ // did not prepare is not.+ let list = w.spaces.list().unwrap();+ let flag = |id: &str| list.iter().find(|i| i.id == id).unwrap().hidden;+ assert!(flag("local:home-claude-code"));+ assert!(!flag("local:plain-home"));+ let json = serde_json::to_value(&list).unwrap();+ let hidden_rows: Vec<_> = json+ .as_array()+ .unwrap()+ .iter()+ .filter(|r| r["hidden"] == true)+ .collect();+ assert_eq!(hidden_rows.len(), 1);+ assert_eq!(hidden_rows[0]["id"], "local:home-claude-code");++ // The first message from a person lists it.+ assert!(w.spaces.reveal("local:home-claude-code").await.unwrap());+ assert!(!w.spaces.reveal("local:home-claude-code").await.unwrap());+ assert!(!w.spaces.reveal("local:plain-home").await.unwrap());+ assert!(!w.spaces.list().unwrap().iter().any(|i| i.hidden));+ w.spaces.publish_to_relay().await.unwrap();+ assert_eq!(w.rows().await.len(), 2);+ assert!(w.attached("home-claude-code"));+}+/// A Space that was already here before this release is listed once it/// runs, whichever way it came to be.#[tokio::test]diff --git a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swiftindex daba5839c4..f496aea3c0 100644--- a/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift+++ b/libs/spaces-app-swift/Sources/CuaSpacesFFI/CuaSpacesFFI.swift@@ -38473,6 +38473,14 @@ public struct AppSpace: Equatable, Hashable {* ([`crate::spaces::access`]). Absent reads as yours with nobody else.*/public var access: AppSpaceAccess?+ /**+ * The home that warms in the background for Home's prompt box, until a+ * person writes into it: no list shows it (not the Spaces list, the+ * sidebar, the palette, the menu bar item or the notch; see+ * [`crate::spaces::openable_spaces`]). Its own page still opens. The+ * SDK and `cua spaces ls` still return it, marked.+ */+ public var hidden: Bool// Default memberwise initializers are never public by default, so we// declare one manually.@@ -38563,7 +38571,14 @@ public struct AppSpace: Equatable, Hashable {/*** Who it belongs to, who else has it and what you may do with it* ([`crate::spaces::access`]). Absent reads as yours with nobody else.- */access: AppSpaceAccess?) {+ */access: AppSpaceAccess?,+ /**+ * The home that warms in the background for Home's prompt box, until a+ * person writes into it: no list shows it (not the Spaces list, the+ * sidebar, the palette, the menu bar item or the notch; see+ * [`crate::spaces::openable_spaces`]). Its own page still opens. The+ * SDK and `cua spaces ls` still return it, marked.+ */hidden: Bool) {self.id = idself.name = nameself.os = os@@ -38590,6 +38605,7 @@ public struct AppSpace: Equatable, Hashable {self.cloudPlace = cloudPlaceself.cloudDelete = cloudDeleteself.access = access+ self.hidden = hidden}@@ -38633,7 +38649,8 @@ public struct FfiConverterTypeAppSpace: FfiConverterRustBuffer {cloud: FfiConverterOptionString.read(from: &buf),cloudPlace: FfiConverterOptionString.read(from: &buf),cloudDelete: FfiConverterOptionString.read(from: &buf),- access: FfiConverterOptionTypeAppSpaceAccess.read(from: &buf)+ access: FfiConverterOptionTypeAppSpaceAccess.read(from: &buf),+ hidden: FfiConverterBool.read(from: &buf))}@@ -38664,6 +38681,7 @@ public struct FfiConverterTypeAppSpace: FfiConverterRustBuffer {FfiConverterOptionString.write(value.cloudPlace, into: &buf)FfiConverterOptionString.write(value.cloudDelete, into: &buf)FfiConverterOptionTypeAppSpaceAccess.write(value.access, into: &buf)+ FfiConverterBool.write(value.hidden, into: &buf)}}@@ -40239,6 +40257,11 @@ public struct AppSpaceRow: Equatable, Hashable {* `aarch64`, `amd64`, `x86_64`).*/public var arch: String?+ /**+ * The SDK's `SpaceInfo.hidden` (label `cua.hidden`): the home warming+ * for Home's prompt box. No list shows it ([`Space::hidden`]).+ */+ public var hidden: Bool/*** Answered the last connect.*/@@ -40337,6 +40360,10 @@ public struct AppSpaceRow: Equatable, Hashable {* The guest's CPU architecture, when known (any spelling: `arm64`,* `aarch64`, `amd64`, `x86_64`).*/arch: String?,+ /**+ * The SDK's `SpaceInfo.hidden` (label `cua.hidden`): the home warming+ * for Home's prompt box. No list shows it ([`Space::hidden`]).+ */hidden: Bool,/*** Answered the last connect.*/reachable: Bool,@@ -40389,6 +40416,7 @@ public struct AppSpaceRow: Equatable, Hashable {self.imageDigest = imageDigestself.kind = kindself.arch = arch+ self.hidden = hiddenself.reachable = reachableself.error = errorself.host = host@@ -40432,6 +40460,7 @@ public struct FfiConverterTypeAppSpaceRow: FfiConverterRustBuffer {imageDigest: FfiConverterOptionString.read(from: &buf),kind: FfiConverterOptionTypeAppSpaceKind.read(from: &buf),arch: FfiConverterOptionString.read(from: &buf),+ hidden: FfiConverterBool.read(from: &buf),reachable: FfiConverterBool.read(from: &buf),error: FfiConverterOptionString.read(from: &buf),host: FfiConverterOptionString.read(from: &buf),@@ -40461,6 +40490,7 @@ public struct FfiConverterTypeAppSpaceRow: FfiConverterRustBuffer {FfiConverterOptionString.write(value.imageDigest, into: &buf)FfiConverterOptionTypeAppSpaceKind.write(value.kind, into: &buf)FfiConverterOptionString.write(value.arch, into: &buf)+ FfiConverterBool.write(value.hidden, into: &buf)FfiConverterBool.write(value.reachable, into: &buf)FfiConverterOptionString.write(value.error, into: &buf)FfiConverterOptionString.write(value.host, into: &buf)