fix(desktop): reconcile the Windows parts after merge

Gate computer use through the platform feature table, guard the now-optional
terminal bridge in the e2e specs, and name the Windows File/Help menus in the
self-hosting docs and sim-setup output.

Author: waleedlatif1

apps/desktop/e2e/browser-tools.spec.ts

@@ -1309,18 +1309,22 @@ test.describe('browser tools', () => {
   })
   test('local terminal executes through its native PTY and refuses repeated authorization', async () => {
     await window.evaluate(async (scope) => {
-      const api = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
-      await api.terminal.activateScope(scope)
-      await api.terminal.openTerminal(undefined, scope)
+      const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
+        .terminal
+      if (!terminal) throw new Error('No agent terminal on this platform')
+      await terminal.activateScope(scope)
+      await terminal.openTerminal(undefined, scope)
     }, SCOPE)
     calls.set('local-cwd', {
       chatId: SCOPE,
       toolName: 'terminal',
       args: { operation: 'cwd', args: {} },
     })
     const cwd = await window.evaluate(async (scope) => {
-      const api = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
-      return api.terminal.executeTool('local-cwd', 'cwd', {}, scope)
+      const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
+        .terminal
+      if (!terminal) throw new Error('No agent terminal on this platform')
+      return terminal.executeTool('local-cwd', 'cwd', {}, scope)
     }, SCOPE)
     expect(cwd.ok).toBe(true)
     calls.set('local-run', {
@@ -1329,14 +1333,18 @@ test.describe('browser tools', () => {
       args: { operation: 'run', args: { command: "printf 'SIM_NATIVE_TERMINAL_VERIFIED\\n'" } },
     })
     const result = await window.evaluate(async (scope) => {
-      const api = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
-      return api.terminal.executeTool('local-run', 'run', {}, scope)
+      const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
+        .terminal
+      if (!terminal) throw new Error('No agent terminal on this platform')
+      return terminal.executeTool('local-run', 'run', {}, scope)
     }, SCOPE)
     expect(result.ok).toBe(true)
     expect(JSON.stringify(result)).toContain('SIM_NATIVE_TERMINAL_VERIFIED')
     const replay = await window.evaluate(async (scope) => {
-      const api = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
-      return api.terminal.executeTool('local-run', 'run', {}, scope)
+      const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi }).simDesktop
+        .terminal
+      if (!terminal) throw new Error('No agent terminal on this platform')
+      return terminal.executeTool('local-run', 'run', {}, scope)
     }, SCOPE)
     expect(replay.ok).toBe(false)
   })

apps/desktop/e2e/desktop-tools-live-sim.spec.ts

@@ -672,10 +672,13 @@ test.describe('desktop tools against a live Sim', () => {
     // stays pending and unclaimed. Whether a handed-over command then runs depends on a terminal
     // being open for the chat, which this test does not set up, so it checks the claim only.
     const response = await page.evaluate(
-      ({ toolCallId, command }) =>
-        (globalThis as DesktopWindow).simDesktop.terminal
+      ({ toolCallId, command }) => {
+        const terminal = (globalThis as DesktopWindow).simDesktop.terminal
+        if (!terminal) throw new Error('No agent terminal on this platform')
+        return terminal
           .executeTool(toolCallId, 'run', { command }, 'unapproved-e2e')
-          .catch((error: unknown) => ({ ok: false, error: String(error) })),
+          .catch((error: unknown) => ({ ok: false, error: String(error) }))
+      },
       { toolCallId: run.toolCallId, command }
     )
     expect(response).toMatchObject({ ok: false })

apps/desktop/e2e/terminal-cancel.spec.ts

@@ -158,6 +158,7 @@ function bridge(window: Page) {
       const terminalId = await window.evaluate(async (scopeId) => {
         const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi })
           .simDesktop.terminal
+        if (!terminal) throw new Error('No agent terminal on this platform')
         await terminal.activateScope(scopeId)
         terminal.setVisible?.(true, scopeId)
         terminal.setFocused(true, scopeId)
@@ -171,7 +172,7 @@ function bridge(window: Page) {
         ([id, text, scopeId]) =>
           (
             globalThis as typeof globalThis & { simDesktop: SimDesktopApi }
-          ).simDesktop.terminal.write(id, text, scopeId),
+          ).simDesktop.terminal?.write(id, text, scopeId),
         [terminalId, `${command}\r`, scope] as const
       )
     },
@@ -180,6 +181,7 @@ function bridge(window: Page) {
       return window.evaluate(async (scopeId) => {
         const terminal = (globalThis as typeof globalThis & { simDesktop: SimDesktopApi })
           .simDesktop.terminal
+        if (!terminal) throw new Error('No agent terminal on this platform')
         await terminal.activateScope(scopeId)
         return terminal.suspendScope(scopeId)
       }, scope)

apps/desktop/src/main/index.ts

@@ -117,6 +117,7 @@ import { checkForUpdatesInteractive, initUpdater, type UpdaterHandle } from '@/m
 import { installBrowserUserAgent } from '@/main/user-agent'
 import { createMainWindow, handleSecondInstance, setupPermissionHandlers } from '@/main/window'
 import { attachWindowOpenPolicy, isPopupContents } from '@/main/windows'
+import { desktopFeatures } from '@/shared/platform-features'
 
 const logger = createLogger('DesktopMain')
 
@@ -184,7 +185,8 @@ function main(): void {
   const computerStopShortcut = 'CommandOrControl+Shift+Escape'
   const computerUse = new ComputerUseService({
     config,
-    supported: process.platform === 'darwin' && Number.parseInt(release(), 10) >= 23,
+    supported:
+      desktopFeatures(process.platform).computerUse && Number.parseInt(release(), 10) >= 23,
     native: computerNative,
     openPermissionSettings: (permission) =>
       shell.openExternal(

apps/docs/content/docs/desktop/index.mdx

@@ -165,7 +165,7 @@ This section also shows the installed version and a downloaded version waiting f
 
 Use **Let Chat run commands** to enable or disable Terminal. **Theme** and **Default zoom** control its appearance.
 
-The **Sim** menu also contains **Settings…**, **Server…**, **Check for Updates…**, and **Sign Out**.
+The **Sim** menu also contains **Settings…**, **Server…**, **Check for Updates…**, and **Sign Out**. On Windows, **Settings…**, **Server…** and **Sign Out** are in the **File** menu and **Check for Updates…** is in **Help**; press Alt to show the menu bar.
 
 ## Keyboard shortcuts
 

apps/docs/content/docs/platform/self-hosting/desktop.mdx

@@ -53,7 +53,7 @@ On macOS, open the `.dmg` and drag Sim to **Applications**. On Windows, run the
 
 ### Connect to your server
 
-Launch Sim, choose **Sim → Server…** (on Windows, **Server…** in the **Sim** menu), enter your deployment origin, and select **Connect**. The app relaunches against that server and saves the setting across updates.
+Launch Sim, choose **Sim → Server…** (on Windows, **File → Server…**; press Alt to show the menu bar), enter your deployment origin, and select **Connect**. The app relaunches against that server and saves the setting across updates.
 
 </Step>
 </Steps>

packages/sim-setup/README.md

@@ -167,7 +167,7 @@ npx sim-setup desktop --no-open
 The desktop app is not tied to sim.ai — it bakes in only a default server, and
 every Sim deployment already serves `/api/desktop/update/download` and the
 update feed installed apps poll. Install the signed build, then point it at your
-deployment with **Server…** in the Sim menu. Nothing has to be built or signed by you.
+deployment with **Server…** (in the Sim menu on macOS, the File menu on Windows). Nothing has to be built or signed by you.
 
 ### Add or change capabilities
 

packages/sim-setup/src/desktop.ts

@@ -24,8 +24,8 @@ const DESKTOP_PLATFORMS = {
   windows: {
     downloadPath: '/api/desktop/update/download?platform=windows',
     feedPath: '/api/desktop/update/latest.yml',
-    serverCommand: 'Server…',
-    serverCommandWhere: 'from the Sim menu',
+    serverCommand: 'File → Server…',
+    serverCommandWhere: 'in the menu bar (press Alt to show it)',
   },
 } as const