chore: merge dev branch fix/macos backend-install-ux

extensions/llamacpp-extension/settings.json

@@ -1,8 +1,19 @@
 [
   {
-    "key": "version_backend",
-    "title": "Version & Backend",
-    "description": "Version and Backend for llama.cpp",
+    "key": "llamacpp_version",
+    "title": "Version",
+    "description": "llama.cpp release version",
+    "controllerType": "dropdown",
+    "controllerProps": {
+      "value": "none",
+      "options": [],
+      "recommended": ""
+    }
+  },
+  {
+    "key": "llamacpp_backend",
+    "title": "Backend",
+    "description": "Hardware backend for llama.cpp (CUDA, Vulkan, CPU, etc.)",
     "controllerType": "dropdown",
     "controllerProps": {
       "value": "none",
@@ -22,10 +33,24 @@
       "textAlign": "right"
     }
   },
+  {
+    "key": "check_for_updates",
+    "title": "Check for updates",
+    "description": "Fetch the remote llama.cpp release list. Required for the version dropdown to show releases beyond what's installed locally, and for update notifications.",
+    "controllerType": "checkbox",
+    "controllerProps": { "value": true }
+  },
   {
     "key": "auto_update_engine",
     "title": "Auto update engine",
-    "description": "Automatically update llamacpp engine to latest version",
+    "description": "Automatically download and switch to the latest llamacpp engine when available. Requires \"Check for updates\" to be on.",
+    "controllerType": "checkbox",
+    "controllerProps": { "value": true }
+  },
+  {
+    "key": "verify_backend_deps",
+    "title": "Verify backend dependencies",
+    "description": "Check that GPU backend shared libraries (CUDA, Vulkan, etc.) resolve on startup and warn if any are missing.",
     "controllerType": "checkbox",
     "controllerProps": { "value": true }
   },

extensions/llamacpp-extension/src/backend.ts

@@ -32,39 +32,43 @@ export async function getLocalInstalledBackends(): Promise<
 // <Jan's data folder>/llamacpp/backends/<backend_version>/<backend_type>
 
 // what should be available to the user for selection?
-export async function listSupportedBackends(): Promise<BackendVersion[]> {
+/**
+ * Hardware-supported backends published by upstream. Excludes
+ * locally-installed-only entries, so the "recommended backend" calculation
+ * isn't biased by user side-loads.
+ */
+export async function fetchRemoteBackends(): Promise<BackendVersion[]> {
   const sysInfo = await getSystemInfo()
   const rawFeatures = await getSupportedFeaturesFromRust(
     sysInfo.os_type,
     sysInfo.cpu.extensions,
     sysInfo.gpus
   )
   const features = normalizeFeatures(rawFeatures)
-
-  // Get supported backend names from Rust
   const supportedBackends = await determineSupportedBackends(
     sysInfo.os_type,
     sysInfo.cpu.arch,
     features
   )
 
-  // Get remote backends via Rust (handles GitHub + CDN fallback)
-  let remoteBackendVersions: BackendVersion[] = []
   try {
-    remoteBackendVersions = await invoke(
+    return await invoke<BackendVersion[]>(
       'plugin:llamacpp|fetch_remote_supported_backends',
       { supportedBackends, proxy: getProxyConfig() }
     )
   } catch (e) {
     console.debug(
       `Not able to get remote backends, Jan might be offline or network problem: ${String(e)}`
     )
+    return []
   }
+}
 
-  // Get locally installed versions
+export async function listSupportedBackends(
+  checkRemote: boolean = true
+): Promise<BackendVersion[]> {
+  const remoteBackendVersions = checkRemote ? await fetchRemoteBackends() : []
   const localBackendVersions = await getLocalInstalledBackends()
-
-  // Merge & sort via Rust
   return listSupportedBackendsFromRust(remoteBackendVersions, localBackendVersions)
 }