The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
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.tsxindex 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.tsxindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mdindex 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 fromapps through the `tinycomputer` module's accessibility layer, with Jev pickingactions. 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`, anddiff --git a/crates/openhuman-core/src/desktop/control/ops.rs b/crates/openhuman-core/src/desktop/control/ops.rsindex 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 @@ wherereason: 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.mdindex 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.mdindex 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 mostDesktop 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.