Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

fix(desktop): report native desktop control as unsupported on Windows

M3gA-Mindc9eba2d0bdb8
diff --git a/app/src/components/desktop/DesktopConnectionPage.test.tsx b/app/src/components/desktop/DesktopConnectionPage.test.tsx
index 626525ae32..b9e38cb5f1 100644
--- a/app/src/components/desktop/DesktopConnectionPage.test.tsx
+++ b/app/src/components/desktop/DesktopConnectionPage.test.tsx
@@ -82,6 +82,22 @@ describe('Desktop connection', () => {
expect(screen.queryByRole('button', { name: 'Enable' })).not.toBeInTheDocument();
});
+ it('says desktop control is not available on Windows yet', async () => {
+ vi.mocked(callCoreRpc).mockResolvedValue({
+ ...enabled,
+ supported: false,
+ enabled: false,
+ platform: 'windows',
+ });
+ renderWithProviders(<DesktopConnectionPage />);
+ expect(
+ await screen.findByText(
+ "Desktop control isn't available on Windows yet. Browser Control works on Windows today."
+ )
+ ).toBeInTheDocument();
+ expect(screen.queryByRole('button', { name: 'Enable' })).not.toBeInTheDocument();
+ });
+
it('does not offer a remote or browser client control over its core host', async () => {
vi.mocked(isLocalDesktopHost).mockResolvedValue(false);
renderWithProviders(<DesktopConnectionPage />);
diff --git a/app/src/components/desktop/DesktopConnectionPage.tsx b/app/src/components/desktop/DesktopConnectionPage.tsx
index 735a452f83..6c7f6df0a8 100644
--- a/app/src/components/desktop/DesktopConnectionPage.tsx
+++ b/app/src/components/desktop/DesktopConnectionPage.tsx
@@ -291,7 +291,11 @@ export default function DesktopConnectionPage({
{status && !status.supported && (
<Alert variant="info" density="compact">
- <AlertDescription>{t('desktop.unsupported')}</AlertDescription>
+ <AlertDescription>
+ {t(
+ status.platform === 'windows' ? 'desktop.unsupportedWindows' : 'desktop.unsupported'
+ )}
+ </AlertDescription>
</Alert>
)}
diff --git a/app/src/lib/i18n/ar.ts b/app/src/lib/i18n/ar.ts
index 9c2d6d26aa..4286aae07c 100644
--- a/app/src/lib/i18n/ar.ts
+++ b/app/src/lib/i18n/ar.ts
@@ -570,6 +570,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'تعذر تحميل موافقات سطح المكتب المعلقة. حدّث الصفحة للمحاولة مجددًا.',
'desktop.unsupported': 'التحكم بسطح المكتب غير متاح في بيئة التشغيل هذه.',
+ 'desktop.unsupportedWindows':
+ 'التحكم بسطح المكتب غير متاح على Windows بعد. يعمل التحكم بالمتصفح على Windows حاليًا.',
'desktop.localOnly': 'ينطبق هذا الإعداد على هذا الكمبيوتر فقط.',
'desktop.permissions': 'أذونات النظام',
'desktop.openSettings': 'فتح الإعدادات',
diff --git a/app/src/lib/i18n/bn.ts b/app/src/lib/i18n/bn.ts
index 853554fb7e..866aa510cd 100644
--- a/app/src/lib/i18n/bn.ts
+++ b/app/src/lib/i18n/bn.ts
@@ -578,6 +578,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'অপেক্ষমাণ ডেস্কটপ অনুমোদন লোড করা যায়নি। আবার চেষ্টা করতে রিফ্রেশ করুন।',
'desktop.unsupported': 'এই পরিবেশে ডেস্কটপ নিয়ন্ত্রণ উপলব্ধ নয়।',
+ 'desktop.unsupportedWindows':
+ 'Windows-এ ডেস্কটপ নিয়ন্ত্রণ এখনও উপলব্ধ নয়। ব্রাউজার নিয়ন্ত্রণ এখনই Windows-এ কাজ করে।',
'desktop.localOnly': 'এই সেটিং শুধু এই কম্পিউটারে প্রযোজ্য।',
'desktop.permissions': 'সিস্টেম অনুমতি',
'desktop.openSettings': 'সেটিংস খুলুন',
diff --git a/app/src/lib/i18n/de.ts b/app/src/lib/i18n/de.ts
index 20fc2109b0..025323e0f5 100644
--- a/app/src/lib/i18n/de.ts
+++ b/app/src/lib/i18n/de.ts
@@ -600,6 +600,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Ausstehende Desktopfreigaben konnten nicht geladen werden. Aktualisiere die Seite und versuche es erneut.',
'desktop.unsupported': 'Die Desktopsteuerung ist in dieser Laufzeit nicht verfügbar.',
+ 'desktop.unsupportedWindows':
+ 'Die Desktopsteuerung ist unter Windows noch nicht verfügbar. Die Browsersteuerung funktioniert unter Windows bereits.',
'desktop.localOnly': 'Diese Einstellung gilt nur für diesen Computer.',
'desktop.permissions': 'Systemberechtigungen',
'desktop.openSettings': 'Einstellungen öffnen',
diff --git a/app/src/lib/i18n/en.ts b/app/src/lib/i18n/en.ts
index 2a8d76d251..7bab159f00 100644
--- a/app/src/lib/i18n/en.ts
+++ b/app/src/lib/i18n/en.ts
@@ -540,6 +540,8 @@ const en: TranslationMap = {
'desktop.moduleUnavailable': 'The desktop module is unavailable. Check its status and try again.',
'desktop.pendingUnavailable': 'Could not load pending desktop approvals. Refresh to try again.',
'desktop.unsupported': 'Desktop control is unavailable in this runtime.',
+ 'desktop.unsupportedWindows':
+ "Desktop control isn't available on Windows yet. Browser Control works on Windows today.",
'desktop.localOnly': 'This setting applies only to this computer.',
'desktop.permissions': 'System permissions',
'desktop.openSettings': 'Open settings',
diff --git a/app/src/lib/i18n/es.ts b/app/src/lib/i18n/es.ts
index f59e3901a5..b01a514035 100644
--- a/app/src/lib/i18n/es.ts
+++ b/app/src/lib/i18n/es.ts
@@ -596,6 +596,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'No se pudieron cargar las aprobaciones pendientes del escritorio. Actualiza para reintentarlo.',
'desktop.unsupported': 'El control del escritorio no está disponible en este entorno.',
+ 'desktop.unsupportedWindows':
+ 'El control del escritorio aún no está disponible en Windows. El control del navegador ya funciona en Windows.',
'desktop.localOnly': 'Este ajuste solo se aplica a este equipo.',
'desktop.permissions': 'Permisos del sistema',
'desktop.openSettings': 'Abrir ajustes',
diff --git a/app/src/lib/i18n/fr.ts b/app/src/lib/i18n/fr.ts
index 9da53a8290..6ea25a63c2 100644
--- a/app/src/lib/i18n/fr.ts
+++ b/app/src/lib/i18n/fr.ts
@@ -600,6 +600,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Impossible de charger les approbations du bureau en attente. Actualisez pour réessayer.',
'desktop.unsupported': 'Le contrôle du bureau n’est pas disponible dans cet environnement.',
+ 'desktop.unsupportedWindows':
+ 'Le contrôle du bureau n’est pas encore disponible sous Windows. Le contrôle du navigateur fonctionne déjà sous Windows.',
'desktop.localOnly': 'Ce réglage ne s’applique qu’à cet ordinateur.',
'desktop.permissions': 'Autorisations système',
'desktop.openSettings': 'Ouvrir les réglages',
diff --git a/app/src/lib/i18n/hi.ts b/app/src/lib/i18n/hi.ts
index 397f08e6a0..b49e88bccb 100644
--- a/app/src/lib/i18n/hi.ts
+++ b/app/src/lib/i18n/hi.ts
@@ -583,6 +583,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'लंबित डेस्कटॉप अनुमोदन लोड नहीं हो सके। फिर कोशिश करने के लिए रीफ़्रेश करें।',
'desktop.unsupported': 'इस रनटाइम में डेस्कटॉप नियंत्रण उपलब्ध नहीं है।',
+ 'desktop.unsupportedWindows':
+ 'Windows पर डेस्कटॉप नियंत्रण अभी उपलब्ध नहीं है। ब्राउज़र नियंत्रण Windows पर अभी काम करता है।',
'desktop.localOnly': 'यह सेटिंग केवल इस कंप्यूटर पर लागू होती है।',
'desktop.permissions': 'सिस्टम अनुमतियाँ',
'desktop.openSettings': 'सेटिंग्स खोलें',
diff --git a/app/src/lib/i18n/id.ts b/app/src/lib/i18n/id.ts
index 15ced87273..087e2aad92 100644
--- a/app/src/lib/i18n/id.ts
+++ b/app/src/lib/i18n/id.ts
@@ -589,6 +589,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Persetujuan desktop yang tertunda tidak dapat dimuat. Segarkan untuk mencoba lagi.',
'desktop.unsupported': 'Kontrol desktop tidak tersedia di lingkungan ini.',
+ 'desktop.unsupportedWindows':
+ 'Kontrol desktop belum tersedia di Windows. Kontrol Browser sudah berfungsi di Windows.',
'desktop.localOnly': 'Pengaturan ini hanya berlaku untuk komputer ini.',
'desktop.permissions': 'Izin sistem',
'desktop.openSettings': 'Buka pengaturan',
diff --git a/app/src/lib/i18n/it.ts b/app/src/lib/i18n/it.ts
index 983f43fcd2..f8c9173ea7 100644
--- a/app/src/lib/i18n/it.ts
+++ b/app/src/lib/i18n/it.ts
@@ -596,6 +596,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Impossibile caricare le approvazioni desktop in attesa. Aggiorna per riprovare.',
'desktop.unsupported': 'Il controllo desktop non è disponibile in questo ambiente.',
+ 'desktop.unsupportedWindows':
+ 'Il controllo desktop non è ancora disponibile su Windows. Il controllo del browser funziona già su Windows.',
'desktop.localOnly': 'Questa impostazione vale solo per questo computer.',
'desktop.permissions': 'Autorizzazioni di sistema',
'desktop.openSettings': 'Apri impostazioni',
diff --git a/app/src/lib/i18n/ja.ts b/app/src/lib/i18n/ja.ts
index 552c63e898..bd6c1cfe85 100644
--- a/app/src/lib/i18n/ja.ts
+++ b/app/src/lib/i18n/ja.ts
@@ -531,6 +531,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'保留中のデスクトップ承認を読み込めませんでした。更新して再試行してください。',
'desktop.unsupported': 'このランタイムではデスクトップ制御は利用できません。',
+ 'desktop.unsupportedWindows':
+ 'Windows ではデスクトップ制御はまだ利用できません。ブラウザ制御は Windows でも利用できます。',
'desktop.localOnly': 'この設定はこのコンピュータにのみ適用されます。',
'desktop.permissions': 'システム権限',
'desktop.openSettings': '設定を開く',
diff --git a/app/src/lib/i18n/ko.ts b/app/src/lib/i18n/ko.ts
index 790b79160b..5c14753ce6 100644
--- a/app/src/lib/i18n/ko.ts
+++ b/app/src/lib/i18n/ko.ts
@@ -574,6 +574,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'대기 중인 데스크톱 승인을 불러올 수 없습니다. 새로고침 후 다시 시도하세요.',
'desktop.unsupported': '이 실행 환경에서는 데스크톱 제어를 사용할 수 없습니다.',
+ 'desktop.unsupportedWindows':
+ 'Windows에서는 아직 데스크톱 제어를 사용할 수 없습니다. 브라우저 제어는 현재 Windows에서 사용할 수 있습니다.',
'desktop.localOnly': '이 설정은 이 컴퓨터에만 적용됩니다.',
'desktop.permissions': '시스템 권한',
'desktop.openSettings': '설정 열기',
diff --git a/app/src/lib/i18n/pl.ts b/app/src/lib/i18n/pl.ts
index 84e0ce5643..1fac68e001 100644
--- a/app/src/lib/i18n/pl.ts
+++ b/app/src/lib/i18n/pl.ts
@@ -591,6 +591,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Nie udało się wczytać oczekujących zgód na dostęp do pulpitu. Odśwież, aby spróbować ponownie.',
'desktop.unsupported': 'Sterowanie pulpitem jest niedostępne w tym środowisku.',
+ 'desktop.unsupportedWindows':
+ 'Sterowanie pulpitem nie jest jeszcze dostępne w systemie Windows. Sterowanie przeglądarką już działa w systemie Windows.',
'desktop.localOnly': 'To ustawienie dotyczy tylko tego komputera.',
'desktop.permissions': 'Uprawnienia systemowe',
'desktop.openSettings': 'Otwórz ustawienia',
diff --git a/app/src/lib/i18n/pt.ts b/app/src/lib/i18n/pt.ts
index 1502f956ee..1898e15252 100644
--- a/app/src/lib/i18n/pt.ts
+++ b/app/src/lib/i18n/pt.ts
@@ -590,6 +590,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Não foi possível carregar as aprovações de desktop pendentes. Atualize para tentar novamente.',
'desktop.unsupported': 'O controle do computador não está disponível neste ambiente.',
+ 'desktop.unsupportedWindows':
+ 'O controle do computador ainda não está disponível no Windows. O controle do navegador já funciona no Windows.',
'desktop.localOnly': 'Esta configuração vale apenas para este computador.',
'desktop.permissions': 'Permissões do sistema',
'desktop.openSettings': 'Abrir configurações',
diff --git a/app/src/lib/i18n/ru.ts b/app/src/lib/i18n/ru.ts
index e18439dbc4..be35340122 100644
--- a/app/src/lib/i18n/ru.ts
+++ b/app/src/lib/i18n/ru.ts
@@ -587,6 +587,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Не удалось загрузить ожидающие подтверждения действий на рабочем столе. Обновите страницу и повторите попытку.',
'desktop.unsupported': 'Управление рабочим столом недоступно в этой среде.',
+ 'desktop.unsupportedWindows':
+ 'Управление рабочим столом пока недоступно в Windows. Управление браузером в Windows уже работает.',
'desktop.localOnly': 'Эта настройка действует только на этом компьютере.',
'desktop.permissions': 'Системные разрешения',
'desktop.openSettings': 'Открыть настройки',
diff --git a/app/src/lib/i18n/tr.ts b/app/src/lib/i18n/tr.ts
index 0dc6df510f..5919ea322d 100644
--- a/app/src/lib/i18n/tr.ts
+++ b/app/src/lib/i18n/tr.ts
@@ -487,6 +487,8 @@ const messages: TranslationMap = {
'desktop.pendingUnavailable':
'Bekleyen masaüstü onayları yüklenemedi. Yeniden denemek için yenileyin.',
'desktop.unsupported': 'Masaüstü denetimi bu çalışma ortamında kullanılamıyor.',
+ 'desktop.unsupportedWindows':
+ "Masaüstü denetimi henüz Windows'ta kullanılamıyor. Tarayıcı denetimi Windows'ta şu anda çalışıyor.",
'desktop.localOnly': 'Bu ayar yalnızca bu bilgisayar için geçerlidir.',
'desktop.permissions': 'Sistem izinleri',
'desktop.openSettings': 'Ayarları aç',
diff --git a/app/src/lib/i18n/zh-CN.ts b/app/src/lib/i18n/zh-CN.ts
index 0f201405aa..ecf89545d6 100644
--- a/app/src/lib/i18n/zh-CN.ts
+++ b/app/src/lib/i18n/zh-CN.ts
@@ -546,6 +546,7 @@ const messages: TranslationMap = {
'desktop.moduleUnavailable': '桌面模块不可用。请检查其状态并重试。',
'desktop.pendingUnavailable': '无法加载待处理的桌面操作审批。请刷新后重试。',
'desktop.unsupported': '此运行环境不支持桌面控制。',
+ 'desktop.unsupportedWindows': 'Windows 上暂不支持桌面控制。浏览器控制目前已可在 Windows 上使用。',
'desktop.localOnly': '此设置仅适用于这台电脑。',
'desktop.permissions': '系统权限',
'desktop.openSettings': '打开设置',
diff --git a/crates/openhuman-core/src/desktop/README.md b/crates/openhuman-core/src/desktop/README.md
index ec3efc61fd..37a4d04ac2 100644
--- a/crates/openhuman-core/src/desktop/README.md
+++ b/crates/openhuman-core/src/desktop/README.md
@@ -52,11 +52,11 @@ which translates selected `DomainEvent`s; it is registered at startup from
apps through the `tinycomputer` module's accessibility layer, with Jev picking
actions. It is opt-in per computer. The enabled flag lives in
`<workspace>/state/desktop-control.json` and fails closed when the file is
-missing or corrupt. Control is only supported on macOS and Windows, and only
-when the core's HTTP listener is bound to loopback
+missing or corrupt. Control is only supported on macOS (the TinyComputer engine has no
+Windows or Linux desktop backend yet, #7164), and only when the core's HTTP listener is bound to loopback
(`set_listener_is_loopback`, set from [`core/runtime/builder.rs`](../core/runtime/builder.rs) once the
-address is known). The tools refuse to run when the listener is not loopback
-or control is disabled.
+address is known). The tools refuse to run on an unsupported platform, when the listener is not
+loopback, or when control is disabled.
The agent tools are `desktop_list_apps`, `desktop_list_windows`,
`desktop_launch`, `desktop_snapshot`, `desktop_find`, `desktop_goal`, and
diff --git a/crates/openhuman-core/src/desktop/control/ops.rs b/crates/openhuman-core/src/desktop/control/ops.rs
index 28ce36399b..c64070e1e8 100644
--- a/crates/openhuman-core/src/desktop/control/ops.rs
+++ b/crates/openhuman-core/src/desktop/control/ops.rs
@@ -171,17 +171,24 @@ fn save(config: &Config, value: bool) -> Result<(), String> {
pub async fn set_enabled(config: &Config, value: bool) -> Result<DesktopStatus, String> {
if value && !supported() {
- return Err(
- "desktop control requires macOS or Windows and a loopback core listener".to_owned(),
- );
+ return Err(UNSUPPORTED_REASON.to_owned());
}
save(config, value)?;
tracing::info!(enabled = value, "[desktop] local enablement changed");
Ok(status(config).await)
}
+const UNSUPPORTED_REASON: &str = "desktop control requires macOS and a loopback core listener";
+
+/// macOS only. The Windows and Linux backends in the pinned TinyComputer
+/// engine implement no desktop surfaces yet, so every call there would fail
+/// with `PLATFORM_NOT_SUPPORTED` (#7164).
+pub(super) const fn platform_supported() -> bool {
+ cfg!(target_os = "macos")
+}
+
fn supported() -> bool {
- cfg!(any(target_os = "macos", target_os = "windows")) && listener_is_loopback()
+ platform_supported() && listener_is_loopback()
}
fn permission(data: &serde_json::Value, field: &str) -> String {
@@ -239,9 +246,7 @@ where
reason: None,
};
if !result.supported {
- reason = Some(
- "desktop control requires macOS or Windows and a loopback core listener".to_owned(),
- );
+ reason = Some(UNSUPPORTED_REASON.to_owned());
} else if local_enabled {
match permissions().await {
Ok(response) if response.ok => {
diff --git a/crates/openhuman-core/src/desktop/control/ops_tests.rs b/crates/openhuman-core/src/desktop/control/ops_tests.rs
index afa3f34bcf..db874f0d4e 100644
--- a/crates/openhuman-core/src/desktop/control/ops_tests.rs
+++ b/crates/openhuman-core/src/desktop/control/ops_tests.rs
@@ -74,14 +74,17 @@ async fn disabled_status_reports_local_setting_without_contacting_module() {
.contains("loopback core listener"));
}
-#[cfg(target_os = "linux")]
+// Windows included: its desktop backend has no surfaces yet (#7164).
+#[cfg(not(target_os = "macos"))]
#[tokio::test]
async fn enable_request_fails_closed_on_unsupported_platform_without_persisting() {
+ let _loopback = test_loopback_guard();
let dir = tempfile::tempdir().unwrap();
let mut config = Config::default();
config.workspace_dir = dir.path().to_path_buf();
let error = set_enabled(&config, true).await.unwrap_err();
- assert!(error.contains("macOS or Windows"));
+ assert!(error.contains("requires macOS"));
+ assert!(!error.contains("Windows"));
assert!(!enabled(&config));
}
diff --git a/crates/openhuman-core/src/desktop/control/tools.rs b/crates/openhuman-core/src/desktop/control/tools.rs
index 90c66c11e6..c950b6a0e2 100644
--- a/crates/openhuman-core/src/desktop/control/tools.rs
+++ b/crates/openhuman-core/src/desktop/control/tools.rs
@@ -112,6 +112,11 @@ impl Tool for DesktopTool {
let thread_id = context
.and_then(ToolRunContext::thread_id)
.filter(|thread_id| !thread_id.is_empty());
+ if !super::ops::platform_supported() {
+ return Ok(ToolResult::error(
+ "Desktop control is not available on this platform yet.",
+ ));
+ }
if !super::ops::listener_is_loopback() || !super::ops::enabled(&self.config) {
return Ok(ToolResult::error(
"Desktop control is disabled in Connections.",
diff --git a/crates/openhuman-core/src/desktop/control/tools_tests.rs b/crates/openhuman-core/src/desktop/control/tools_tests.rs
index 6b2c2b0918..28445ee49c 100644
--- a/crates/openhuman-core/src/desktop/control/tools_tests.rs
+++ b/crates/openhuman-core/src/desktop/control/tools_tests.rs
@@ -9,7 +9,12 @@ async fn deferred_tool_is_discoverable_but_fails_closed_when_disabled() {
let tool = DesktopTool::new(Arc::new(config), DesktopToolKind::Apps);
assert_eq!(tool.exposure(), ToolExposure::Deferred);
let result = tool.execute(json!({})).await.unwrap();
- assert!(result.output().contains("disabled in Connections"));
+ let expected = if cfg!(target_os = "macos") {
+ "disabled in Connections"
+ } else {
+ "not available on this platform"
+ };
+ assert!(result.output().contains(expected), "{}", result.output());
}
#[test]
diff --git a/crates/openhuman-core/src/platform/about_app/catalog_localai_settings_mobile.rs b/crates/openhuman-core/src/platform/about_app/catalog_localai_settings_mobile.rs
index 32f31889fb..1dbaa0566f 100644
--- a/crates/openhuman-core/src/platform/about_app/catalog_localai_settings_mobile.rs
+++ b/crates/openhuman-core/src/platform/about_app/catalog_localai_settings_mobile.rs
@@ -81,7 +81,7 @@ Capability {
name: "Desktop Control",
domain: "desktop",
category: CapabilityCategory::Settings,
- description: "Let agents inspect and control native desktop apps through a local, permission-aware connection. Desktop actions are discovered on demand. Switched off by [components] computer = false, which unregisters the desktop tools and answers the desktop.* RPCs with COMPONENT_DISABLED:computer while keeping this machine's own consent setting untouched.",
+ description: "Let agents inspect and control native desktop apps through a local, permission-aware connection. macOS only for now; Windows and Linux are not supported yet. Desktop actions are discovered on demand. Switched off by [components] computer = false, which unregisters the desktop tools and answers the desktop.* RPCs with COMPONENT_DISABLED:computer while keeping this machine's own consent setting untouched.",
how_to: "Connections → Computer → Desktop; enable access and grant operating system permissions when requested",
status: CapabilityStatus::Beta,
privacy: DESKTOP_TO_JEV,
diff --git a/docs/RELEASE-MANUAL-SMOKE.md b/docs/RELEASE-MANUAL-SMOKE.md
index 4560282616..41eb194c4e 100644
--- a/docs/RELEASE-MANUAL-SMOKE.md
+++ b/docs/RELEASE-MANUAL-SMOKE.md
@@ -51,7 +51,7 @@ Use a disposable staging account/workspace and synthetic facts. Keep inference r
### Native desktop control
-- [ ] **Connections enables the published desktop module on an unlocked macOS or Windows session** — Open Connections → Integrations → Desktop Control, verify the Early Alpha notice, enable it, grant Accessibility if prompted, and run the read-only test. Expected: the module loads from the pinned release, the panel reports the actual permission state, and the test sees an accessibility snapshot. Screen Recording is required only when testing capture. A locked macOS screen must not be reported as a successful probe.
+- [ ] **Connections enables the published desktop module on an unlocked macOS session** — Open Connections → Integrations → Desktop Control, verify the Early Alpha notice, enable it, grant Accessibility if prompted, and run the read-only test. Expected: the module loads from the pinned release, the panel reports the actual permission state, and the test sees an accessibility snapshot. Screen Recording is required only when testing capture. A locked macOS screen must not be reported as a successful probe.
- [ ] **An agent completes a disposable desktop task without an approval wait by default** — In a fresh thread, ask the orchestrator to use a harmless app such as TextEdit or Calculator, make one visible change, and verify it through a new accessibility snapshot. Expected: `tool_search` discovers the deferred desktop tool, the released module performs the action, no approval card parks the turn, and the observed app state matches the request. Disable Desktop afterward and verify a subsequent tool call is refused.
- [ ] **A scoped message goal sends exact text once** — With a consenting test contact and an unlocked desktop session, ask the agent to send one unique message through the native chat app. Expected: it confirms the active conversation header, preserves the requested text exactly, and verifies the outgoing message inside that conversation. A chat-list row alone must not count as success; an unverified delivered send must stop as uncertain without a second click. Inspect the chat independently for duplicates.
@@ -96,7 +96,7 @@ Use a disposable staging account/workspace and synthetic facts. Keep inference r
### Windows
-- [ ] **Bundled native modules work offline** — Install from the signed MSI or NSIS package on a fresh Windows account, disconnect the network, then open Desktop Control and Browser Control and load their modules. Expected: both modules reach Ready without a GitHub request, and the log records `[modules] loaded '<id>' from the installer bundle`. Reconnect before testing hosted features. Check both installer formats when both are shipped.
+- [ ] **Bundled native modules work offline** — Install from the signed MSI or NSIS package on a fresh Windows account, disconnect the network, then open Browser Control and load its module. Desktop Control should say it isn't available on Windows yet. Expected: the browser module reaches Ready without a GitHub request, and the log records `[modules] loaded '<id>' from the installer bundle`. Reconnect before testing hosted features. Check both installer formats when both are shipped.
- [ ] **Custom window frame and exit** — Launch with no saved window geometry. Expected: the window opens near 800 × 720 with compact rounded corners; the top-right controls minimize, maximize/restore, and close. Drag the window from the top strip on both the loading screen and main app. Closing exits the host and its embedded core (no lingering `OpenHuman.exe` or core listener).
- [ ] **SmartScreen does not block install** — Run the installer from a fresh download. Expected: SmartScreen passes (signed binary). If `Windows protected your PC` appears, the EV signature is missing or the reputation has not built up — escalate before shipping.
- [ ] **Installer creates Start Menu + Desktop shortcuts** — Defaults preserved. Expected: both shortcuts launch the app.
diff --git a/docs/gitbooks/en/features/native-tools/browser-and-computer.md b/docs/gitbooks/en/features/native-tools/browser-and-computer.md
index 7f9f578fcc..1b354e9f0f 100644
--- a/docs/gitbooks/en/features/native-tools/browser-and-computer.md
+++ b/docs/gitbooks/en/features/native-tools/browser-and-computer.md
@@ -36,6 +36,8 @@ Sessions are bounded. The module allows up to 8 at once. OpenHuman keeps at most
Desktop control reads the operating system's accessibility tree, the same interface a screen reader uses. It covers running apps, windows, displays, Notification Center entries, the clipboard and screenshots.
+Desktop control works on macOS only for now. Windows and Linux aren't supported yet; use the browser there.
+
Actions go through the accessibility API and not through synthesized input. By default they don't steal focus, move your cursor or touch the clipboard, so a run can continue while you use the machine. A headed mode and real mouse and key events exist for apps that need them, but they are the exception.
For dense apps, a skeleton snapshot stops at three levels and returns structure without leaf detail. That is the difference between tens of thousands of tokens and a few hundred.