fix(release): restore desktop release inputs

Author: Shaw

docs/apps/desktop/release-heavy-inventory.md

@@ -0,0 +1,48 @@
+# Desktop Release Regression Inventory
+
+This inventory records desktop regression coverage that is intentionally outside
+the deterministic PR gate. The release matrix validator keeps these entries
+visible so they are reviewed before a production desktop release.
+
+## Packaged and E2E Coverage
+
+- gameOpenWindow — full round-trip with openGameWindow mock (needs canvas mock update)
+- Abnormal window position (off-screen) is corrected to safe defaults (e2e)
+- Deep link received while app is closed causes app to launch (e2e)
+- Deep link received while app is open does not launch second instance (e2e)
+- Shortcuts survive window focus changes (e2e)
+- App launches automatically after system restart (e2e)
+- Auto-launch survives app updates (e2e)
+- Keyboard shortcut Cmd+Q triggers quit (e2e)
+- Keyboard shortcut Cmd+R triggers reload (e2e)
+- Keyboard shortcut Cmd+Option+I opens devtools (e2e)
+- Gateway discovery sends gatewayDiscovery push event to renderer (integration)
+- Canvas window is sandboxed — cannot access main app origin (integration)
+- Canvas navigate blocks external URLs (integration)
+- Agent port is reachable via HTTP after status reaches 'running' (integration)
+- Agent crash triggers automatic restart (integration)
+- Stopping agent while starting does not leave zombie process (integration)
+- Check for updates contacts the release server (network)
+- Applying update relaunches the app (e2e)
+- Update check works on both canary and stable channels (network)
+- Tray icon persists after main window is closed (e2e)
+- Main window has native vibrancy effect on macOS (e2e)
+- Context menu closes when clicking elsewhere (e2e)
+
+## Hardware and Manual Coverage
+
+- Microphone input works after permission is granted (hardware)
+- Swabble fires 'wakeWordDetected' event when wake word is spoken (hardware)
+- Audio transcription produces non-empty text for clear speech (hardware)
+- Camera preview renders in the UI when stream is started (hardware)
+- Switching between front/rear camera works (hardware)
+- takeScreenshot returns a non-empty base64 PNG (hardware)
+- Frame capture mode streams frames at configured interval (hardware)
+- Left-clicking the tray icon opens the companion window (visual)
+- Right-clicking the tray icon shows the tray context menu (visual)
+- Window can be dragged by clicking the header region (visual)
+- Photo quality is acceptable at default settings (hardware)
+- Requesting accessibility opens System Preferences (OS interaction)
+- Permission status reflects actual system state (OS interaction)
+- Context menu appears at cursor position (visual)
+- Power state reflects actual battery status (hardware)

docs/apps/desktop/release-regression-checklist.md

@@ -0,0 +1,13 @@
+# Desktop Release Regression Checklist
+
+Complete these manual checks for desktop release candidates after packaged smoke
+tests pass on the target platform.
+
+- [ ] Left-clicking the tray icon opens the companion window (visual)
+- [ ] Right-clicking the tray icon shows the tray context menu (visual)
+- [ ] Window can be dragged by clicking the header region (visual)
+- [ ] Photo quality is acceptable at default settings (hardware)
+- [ ] Requesting accessibility opens System Preferences (OS interaction)
+- [ ] Permission status reflects actual system state (OS interaction)
+- [ ] Context menu appears at cursor position (visual)
+- [ ] Power state reflects actual battery status (hardware)

packages/app-core/scripts/desktop-build.mjs

@@ -63,6 +63,7 @@ const CORE_PACKAGE_DIR = resolveWorkspacePackageDir("core");
 const ELECTROBUN_CARROTS_PACKAGE_DIR =
   resolveWorkspacePackageDir("electrobun-carrots");
 const SHARED_PACKAGE_DIR = resolveWorkspacePackageDir("shared");
+const UI_PACKAGE_DIR = resolveWorkspacePackageDir("ui");
 const VAULT_PACKAGE_DIR = resolveWorkspacePackageDir("vault");
 
 const argv = process.argv.slice(2);
@@ -598,6 +599,13 @@ function ensureWorkspaceRuntimePackagesBuilt() {
   ensureWorkspaceRuntimePackageBuilt("@elizaos/app-core", APP_CORE_PACKAGE_DIR);
 }
 
+function ensureUiGeneratedAssets() {
+  runBun(["run", "generate:css-strings"], {
+    cwd: UI_PACKAGE_DIR,
+    label: "Generating @elizaos/ui CSS string modules",
+  });
+}
+
 function stageDesktopBuild() {
   ensureAppDirs();
 
@@ -648,6 +656,8 @@ function stageDesktopBuild() {
     allowFailure: true,
   });
 
+  ensureUiGeneratedAssets();
+
   runPackageBinary("vite", ["build"], {
     cwd: APP_DIR,
     env: {

packages/app-core/scripts/run-mobile-build.mjs

@@ -52,7 +52,7 @@ import {
   findForbiddenRuntimeImportGroups,
   findForbiddenRuntimeStrings,
   formatForbiddenRuntimeFindings,
-} from "../../bun-ios-runtime/scripts/ios-app-store-runtime-policy.mjs";
+} from "../../native/bun-runtime/scripts/ios-app-store-runtime-policy.mjs";
 import {
   loadAospVariantConfig,
   resolveAppConfigPath,

packages/scripts/patch-llama-cpp-capacitor.mjs

@@ -19,8 +19,8 @@
  * when already applied, which is treated as success.
  */
 
-import { execFileSync, spawnSync } from "node:child_process";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -84,6 +84,7 @@ for (const { label, dir: pkgDir } of candidates) {
     try {
       const contents = readFileSync(buildGradle, "utf8");
       if (contents.includes("'arm64-v8a', 'riscv64'")) {
+        ensureAndroidSkipPatch(pkgDir);
         skipped++;
         continue;
       }
@@ -102,6 +103,7 @@ for (const { label, dir: pkgDir } of candidates) {
   );
 
   if (result.status === 0 || result.status === 1) {
+    ensureAndroidSkipPatch(pkgDir);
     patched++;
   } else {
     failed++;
@@ -116,3 +118,27 @@ if (patched > 0 || skipped > 0 || failed > 0) {
     `[patch-llama-cpp-capacitor] patched=${patched} already-applied=${skipped} failed=${failed}`,
   );
 }
+
+function ensureAndroidSkipPatch(pkgDir) {
+  const cmakeLists = join(pkgDir, "android", "src", "main", "CMakeLists.txt");
+  if (!existsSync(cmakeLists)) return;
+  const current = readFileSync(cmakeLists, "utf8");
+  if (current.includes("ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB")) return;
+  const marker =
+    'if(NOT DEFINED ELIZA_REPO_ROOT)\n    message(FATAL_ERROR "ELIZA_REPO_ROOT is required for the Eliza DFlash Android JNI bridge")\nendif()\n';
+  if (!current.includes(marker)) return;
+  const skipBlock =
+    'if(DEFINED ENV{ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB} AND "$ENV{ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB}" STREQUAL "1")\n' +
+    '    file(WRITE "${CMAKE_BINARY_DIR}/eliza-dflash-smoke-stub.cpp" "extern \\"C\\" int eliza_dflash_smoke_stub() { return 0; }\\n")\n' +
+    '    add_library(llama-cpp-arm64 SHARED "${CMAKE_BINARY_DIR}/eliza-dflash-smoke-stub.cpp")\n' +
+    '    set_target_properties(\n' +
+    '        llama-cpp-arm64\n' +
+    '        PROPERTIES\n' +
+    '        OUTPUT_NAME "llama-cpp-arm64"\n' +
+    '        LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/jniLibs/arm64-v8a"\n' +
+    '    )\n' +
+    '    message(STATUS "Skipping Eliza DFlash JNI bridge for Android smoke build")\n' +
+    '    return()\n' +
+    'endif()\n\n';
+  writeFileSync(cmakeLists, current.replace(marker, skipBlock + marker));
+}

patches/llama-cpp-capacitor@0.1.5.patch

@@ -65,22 +65,28 @@ diff --git a/android/build.gradle b/android/build.gradle
      externalNativeBuild {
          cmake {
              path "src/main/CMakeLists.txt"
-@@ -40,23 +81,23 @@
-             ndkVersion = "29.0.13113456"
+@@ -40,25 +81,25 @@
+-            version "3.22.1"
++            version = "3.22.1"
+             // Explicitly set NDK version to avoid Windows dependencies
+-            ndkVersion "29.0.13113456"
++            ndkVersion = "29.0.13113456"
          }
      }
 -    
 +
      buildTypes {
          release {
              minifyEnabled false
-             proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+-            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
++            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          }
      }
 -    
 +
      lintOptions {
-         abortOnError = false
+-        abortOnError false
++        abortOnError = false
      }
 -    
 +
@@ -110,7 +116,7 @@ diff --git a/android/build.gradle b/android/build.gradle
 diff --git a/android/src/main/CMakeLists.txt b/android/src/main/CMakeLists.txt
 --- a/android/src/main/CMakeLists.txt
 +++ b/android/src/main/CMakeLists.txt
-@@ -1,131 +1,129 @@
+@@ -1,131 +1,142 @@
 -cmake_minimum_required(VERSION 3.10)
 +cmake_minimum_required(VERSION 3.22)
 
@@ -120,6 +126,19 @@ diff --git a/android/src/main/CMakeLists.txt b/android/src/main/CMakeLists.txt
  set(CMAKE_CXX_STANDARD 17)
 -set(LLAMACPP_LIB_DIR ${CMAKE_SOURCE_DIR}/../../../cpp)
 +set(CMAKE_CXX_STANDARD_REQUIRED ON)
++
++if(DEFINED ENV{ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB} AND "$ENV{ELIZA_ANDROID_SKIP_FORK_LLAMA_LIB}" STREQUAL "1")
++    file(WRITE "${CMAKE_BINARY_DIR}/eliza-dflash-smoke-stub.cpp" "extern \"C\" int eliza_dflash_smoke_stub() { return 0; }\n")
++    add_library(llama-cpp-arm64 SHARED "${CMAKE_BINARY_DIR}/eliza-dflash-smoke-stub.cpp")
++    set_target_properties(
++        llama-cpp-arm64
++        PROPERTIES
++        OUTPUT_NAME "llama-cpp-arm64"
++        LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/jniLibs/arm64-v8a"
++    )
++    message(STATUS "Skipping Eliza DFlash JNI bridge for Android smoke build")
++    return()
++endif()
 
 -include_directories(
 -    ${LLAMACPP_LIB_DIR}