feat(desktop): add prevent-sleep settings toggle

The desktop app unconditionally started a powerSaveBlocker at launch with
no user-facing way to opt out. Add a "Prevent system sleep" switch under
a new Power section in General settings (desktop only).

- main: persist preventSleep in the settings store; default stays enabled
  (only explicit false opts out) so existing installs keep the historical
  always-on behavior; set-prevent-sleep IPC starts/stops the blocker live
  and broadcasts to all windows
- preload/renderer/app: bridge get/setPreventSleepEnabled through the
  platform context, mirroring the pinchZoom pattern
- i18n: translate the new section and row across all 18 locales
- tests: unit-cover the persisted-setting resolution (Electron-free, same
  split as close-to-tray); add prevent-sleep-smoke, a Playwright-driven
  dynamic test that clicks the real Settings switch and asserts macOS
  pmset NoIdleSleepAssertion across default-on, disable, relaunch
  persistence, and re-enable
- ci: run the smoke in a new desktop-smoke (macos) job in test.yml

Signed-off-by: thomas-yanga <odie_majere@outlook.com>

Author: thomas-yanga

.github/workflows/test.yml

@@ -96,6 +96,38 @@ jobs:
           retention-days: 7
           path: packages/*/.artifacts/unit/junit.xml
 
+  desktop-smoke:
+    name: desktop-smoke (macos)
+    # The prevent-sleep smoke drives the real packaged main bundle through Playwright and asserts
+    # against pmset, so it needs a macOS runner with a window server; keep it out of the unit matrix.
+    runs-on: macos-14
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: "24"
+
+      - name: Setup Bun
+        uses: ./.github/actions/setup-bun
+
+      - name: Build desktop main bundle
+        working-directory: packages/desktop
+        run: bun run build
+        timeout-minutes: 15
+
+      - name: Run prevent-sleep smoke
+        working-directory: packages/desktop
+        run: bun run test:prevent-sleep-smoke
+        timeout-minutes: 10
+
   e2e:
     name: e2e (${{ matrix.settings.name }})
     strategy:

packages/app/src/components/settings-v2/general.tsx

@@ -132,6 +132,12 @@ export const SettingsGeneralV2: Component = () => {
     { initialValue: false },
   )
 
+  const [preventSleep, { mutate: setPreventSleep }] = createResource(
+    () => (desktop() && platform.getPreventSleepEnabled ? true : false),
+    () => Promise.resolve(platform.getPreventSleepEnabled?.() ?? true).catch(() => true),
+    { initialValue: true },
+  )
+
   onMount(() => {
     void theme.loadThemes()
   })
@@ -252,6 +258,13 @@ export const SettingsGeneralV2: Component = () => {
     void update.catch(() => setPinchZoom(!checked))
   }
 
+  const onPreventSleepChange = (checked: boolean) => {
+    setPreventSleep(checked)
+    const update = platform.setPreventSleepEnabled?.(checked)
+    if (!update) return
+    void update.catch(() => setPreventSleep(!checked))
+  }
+
   const colorSchemeOptions = createMemo((): { value: ColorScheme; label: string }[] => [
     { value: "system", label: language.t("theme.scheme.system") },
     { value: "light", label: language.t("theme.scheme.light") },
@@ -915,6 +928,25 @@ export const SettingsGeneralV2: Component = () => {
     </Show>
   )
 
+  const PowerSection = () => (
+    <Show when={desktop()}>
+      <div class="settings-v2-section">
+        <h3 class="settings-v2-section-title">{language.t("settings.general.section.power")}</h3>
+
+        <SettingsListV2>
+          <SettingsRowV2
+            title={language.t("settings.general.row.preventSleep.title")}
+            description={language.t("settings.general.row.preventSleep.description")}
+          >
+            <div data-action="settings-prevent-sleep">
+              <Switch checked={preventSleep.latest} onChange={onPreventSleepChange} />
+            </div>
+          </SettingsRowV2>
+        </SettingsListV2>
+      </div>
+    </Show>
+  )
+
   return (
     <>
       <div class="settings-v2-tab-header">
@@ -940,6 +972,8 @@ export const SettingsGeneralV2: Component = () => {
 
         <DisplaySection />
 
+        <PowerSection />
+
         <ImportSection />
       </div>
     </>

packages/app/src/context/platform.tsx

@@ -122,6 +122,12 @@ type PlatformBase = {
   /** Allow native pinch/Ctrl-scroll zoom gestures (desktop only) */
   setPinchZoomEnabled?(enabled: boolean): Promise<void> | void
 
+  /** Get whether the app keeps the system awake while running (desktop only) */
+  getPreventSleepEnabled?(): Promise<boolean> | boolean
+
+  /** Keep the system awake while the app is running (desktop only) */
+  setPreventSleepEnabled?(enabled: boolean): Promise<void> | void
+
   /** Run a desktop-only menu action from the app chrome */
   runDesktopMenuAction?(action: DesktopMenuAction): Promise<void> | void
 

packages/app/src/i18n/ar.ts

@@ -560,6 +560,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "تفعيل لجنة الخبراء افتراضيًا",
   "settings.general.row.expertPanelDefault.description": "بدء المحادثات الجديدة مع تفعيل لجنة الخبراء، بحيث يبدأ زرها مراجعة السياق الحالي عند الطلب.",
   "settings.general.section.display": "شاشة العرض",
+  "settings.general.section.power": "الطاقة",
   "settings.general.row.language.title": "اللغة",
   "settings.general.row.language.description": "تغيير لغة العرض لـ DeepAgent Code",
   "settings.general.row.appearance.title": "المظهر",
@@ -930,6 +931,8 @@ export const dict = {
     "تفعيل التخطيط والصفحة الرئيسية والمحرر وواجهة الجلسة المعاد تصميمها",
   "settings.general.row.pinchZoom.title": "التكبير بالقرص",
   "settings.general.row.pinchZoom.description": "السماح بإيماءات قرص لوحة اللمس و Ctrl-تمرير للتكبير",
+  "settings.general.row.preventSleep.title": "منع سكون النظام",
+  "settings.general.row.preventSleep.description": "إبقاء النظام مستيقظًا أثناء تشغيل التطبيق؛ ويمكن أن تنطفئ الشاشة",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "جار التنزيل...",

packages/app/src/i18n/br.ts

@@ -567,6 +567,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "Ativar painel de especialistas por padrão",
   "settings.general.row.expertPanelDefault.description": "Iniciar novas conversas com o painel de especialistas ativado, para que seu botão inicie uma revisão do contexto atual sob demanda.",
   "settings.general.section.display": "Tela",
+  "settings.general.section.power": "Energia",
   "settings.general.row.language.title": "Idioma",
   "settings.general.row.language.description": "Alterar o idioma de exibição do DeepAgent Code",
   "settings.general.row.appearance.title": "Aparência",
@@ -954,6 +955,8 @@ export const dict = {
   "settings.general.row.pinchZoom.title": "Pinçar para zoom",
   "settings.general.row.pinchZoom.description":
     "Permitir gestos de pellizco en trackpad y Ctrl-desplazamiento para ampliar",
+  "settings.general.row.preventSleep.title": "Impedir suspensão do sistema",
+  "settings.general.row.preventSleep.description": "Manter o sistema ativo enquanto o app está em execução; a tela ainda pode desligar",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "Baixando...",

packages/app/src/i18n/bs.ts

@@ -632,6 +632,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "Zadano uključi ekspertni panel",
   "settings.general.row.expertPanelDefault.description": "Pokreni nove razgovore s uključenim ekspertnim panelom, tako da njegovo dugme po potrebi pokreće pregled trenutnog konteksta.",
   "settings.general.section.display": "Prikaz",
+  "settings.general.section.power": "Napajanje",
 
   "settings.general.row.language.title": "Jezik",
   "settings.general.row.language.description": "Promijeni jezik prikaza u DeepAgent Code-u",
@@ -1027,6 +1028,8 @@ export const dict = {
   "settings.general.row.pinchZoom.title": "Powiększanie gestem szczypania",
   "settings.general.row.pinchZoom.description":
     "Zezwól na powiększanie gestem szczypania na trackpadzie i Ctrl-przewijaniem",
+  "settings.general.row.preventSleep.title": "Spriječi mirovanje sistema",
+  "settings.general.row.preventSleep.description": "Zadržava sistem budnim dok je aplikacija pokrenuta; ekran se i dalje može ugasiti",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "Preuzimanje...",

packages/app/src/i18n/da.ts

@@ -627,6 +627,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "Aktivér ekspertpanel som standard",
   "settings.general.row.expertPanelDefault.description": "Start nye samtaler med ekspertpanelet aktiveret, så knappen kan gennemgå den aktuelle kontekst efter behov.",
   "settings.general.section.display": "Skærm",
+  "settings.general.section.power": "Strøm",
 
   "settings.general.row.language.title": "Sprog",
   "settings.general.row.language.description": "Ændr visningssproget for DeepAgent Code",
@@ -1016,6 +1017,8 @@ export const dict = {
   "settings.general.row.newLayoutDesigns.description": "Aktivér det redesignede layout, hjem, composer og sessions-UI",
   "settings.general.row.pinchZoom.title": "Knib for at zoome",
   "settings.general.row.pinchZoom.description": "Tillad trackpad-knib og Ctrl-scroll til zoom",
+  "settings.general.row.preventSleep.title": "Forhindr dvale",
+  "settings.general.row.preventSleep.description": "Hold systemet vågent, mens appen kører; skærmen kan stadig slukkes",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "Downloader...",

packages/app/src/i18n/de.ts

@@ -576,6 +576,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "Expertengremium standardmäßig aktivieren",
   "settings.general.row.expertPanelDefault.description": "Neue Unterhaltungen mit aktiviertem Expertengremium starten, damit dessen Schaltfläche den aktuellen Kontext bei Bedarf prüft.",
   "settings.general.section.display": "Anzeige",
+  "settings.general.section.power": "Energie",
   "settings.general.row.language.title": "Sprache",
   "settings.general.row.language.description": "Die Anzeigesprache für DeepAgent Code ändern",
   "settings.general.row.appearance.title": "Erscheinungsbild",
@@ -961,6 +962,8 @@ export const dict = {
     "Überarbeitetes Layout, Startseite, Composer und Sitzungs-UI aktivieren",
   "settings.general.row.pinchZoom.title": "Zum Zoomen kneifen",
   "settings.general.row.pinchZoom.description": "Trackpad-Kneifen und Strg-Scrollen zum Zoomen erlauben",
+  "settings.general.row.preventSleep.title": "Ruhezustand des Systems verhindern",
+  "settings.general.row.preventSleep.description": "Hält das System wach, solange die App läuft; der Bildschirm kann sich weiterhin ausschalten",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "Wird heruntergeladen...",

packages/app/src/i18n/en.ts

@@ -1204,6 +1204,7 @@ export const dict = {
   "settings.general.section.sounds": "Sound effects",
   "settings.general.section.feed": "Feed",
   "settings.general.section.display": "Display",
+  "settings.general.section.power": "Power",
   "settings.general.section.sharing": "Sharing",
 
   "settings.general.row.language.title": "Language",
@@ -1367,6 +1368,8 @@ export const dict = {
   "settings.general.row.newLayoutDesigns.description": "Enable the redesigned layout, home, composer, and session UI",
   "settings.general.row.pinchZoom.title": "Pinch to zoom",
   "settings.general.row.pinchZoom.description": "Allow trackpad pinch and Ctrl-scroll gestures to zoom",
+  "settings.general.row.preventSleep.title": "Prevent system sleep",
+  "settings.general.row.preventSleep.description": "Keep the system awake while the app is running; the display can still turn off",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
 

packages/app/src/i18n/es.ts

@@ -635,6 +635,7 @@ export const dict = {
   "settings.general.row.expertPanelDefault.title": "Activar el panel de expertos por defecto",
   "settings.general.row.expertPanelDefault.description": "Iniciar nuevas conversaciones con el panel de expertos activado, para que su botón revise el contexto actual cuando se solicite.",
   "settings.general.section.display": "Pantalla",
+  "settings.general.section.power": "Energía",
 
   "settings.general.row.language.title": "Idioma",
   "settings.general.row.language.description": "Cambiar el idioma de visualización para DeepAgent Code",
@@ -1037,6 +1038,8 @@ export const dict = {
   "settings.general.row.pinchZoom.title": "Pellizcar para ampliar",
   "settings.general.row.pinchZoom.description":
     "Permitir gestos de pellizco en trackpad y Ctrl-desplazamiento para ampliar",
+  "settings.general.row.preventSleep.title": "Evitar la suspensión del sistema",
+  "settings.general.row.preventSleep.description": "Mantener el sistema activo mientras la app está en ejecución; la pantalla aún puede apagarse",
   "settings.general.row.zoom.title": "Zoom level",
   "settings.general.row.zoom.description": "Set the interface zoom level",
   "settings.updates.action.downloading": "Descargando...",