arcane-os 0.5.9 → 0.5.10

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.5.10
+
+- Show one Windows performance-GPU flag advisory for the current Chromium
+  browser, including Edge, Brave, Opera, and Vivaldi. Browsers that conceal
+  their identity use their own flags page through the generic `about://` address.
+- Make the notice conditional on having multiple GPUs, cover every observed
+  GPU vendor, and omit the notice on Firefox, Safari, mobile, and non-Windows
+  platforms. No additional GPU flags or automatic settings changes are included.
+
 ## 0.5.9
 
 - Renamed the built-in TWiN Cloud provider and default-model preference sentinel

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.5.9` SDK contract. Applications pin one exact npm
+This checkout defines the `0.5.10` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 
@@ -204,7 +204,7 @@ uses the same controller for automatic memory extraction.
 Create a new repository-shaped Arcane application with the exact stable SDK:
 
 ```bash
-npx arcane-os@0.5.9 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.5.10 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run check
@@ -215,7 +215,7 @@ To enroll an existing repository, install the exact SDK and initialize only
 missing Arcane files:
 
 ```bash
-npm install --save-dev --save-exact arcane-os@0.5.9
+npm install --save-dev --save-exact arcane-os@0.5.10
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -231,7 +231,7 @@ npm exec -- arcane-os targets
 No global SDK install or standalone Arcane CLI is required. The application
 repository's exact npm dependency and lockfile own the CLI and toolchain version.
 
-Use `npx arcane-os@0.5.9` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.5.10` for the initial bootstrap because it names this npm
 package explicitly; bare `npx arcane` outside an installed project could resolve
 a different package. Both installed commands invoke the same headless toolchain.
 Project-local npm scripts use the SDK pinned by that app's `package-lock.json`,
@@ -252,7 +252,7 @@ node ./bin/arcane.mjs new local-app --path ../local-app --target portable --git
 
 # From the generated app repository
 cd ../local-app
-npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.5.9.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.5.10.tgz
 npm run check
 npm ci
 ```
@@ -262,7 +262,7 @@ same location. The lockfile retains the selected package dependency while
 Arcane uses the installed package name and version. Local directory `file:` dependencies are not
 accepted because npm may install them as links; use a packed `.tgz`. A GitHub
 runner also needs that tarball at the locked path. After publication, replace
-the local declaration with the exact `arcane-os@0.5.9` registry package and
+the local declaration with the exact `arcane-os@0.5.10` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -400,7 +400,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.5.9` exposes one browser target and five explicitly paired
+Version `0.5.10` exposes one browser target and five explicitly paired
 native development targets: a non-runnable portable directory, a
 Windows x64 unsigned-local-test EXE bundle, Linux x64 and Linux ARM64
 unsigned-local-test DEBs, and an Android development-signed APK. The

package/browser-runtime/ai/browser-wasm-llm-provider.mjs

@@ -20,15 +20,12 @@ const AI_PROVIDER_PROTOCOL = "arcane-ai-provider/2";
 const AI_MODEL_AUTHORITY_PROTOCOL = "arcane-ai-model-authority/1";
 const WEBGPU_ADAPTER_SELECTED_EVENT = "arcane.ai.browser-wasm.webgpu.adapter.selected";
 const WEBGPU_ADAPTER_SELECTION_PROTOCOL = "arcane-ai-webgpu-adapter-selection/1";
-const CHROME_HIGH_PERFORMANCE_GPU_FLAG_URL =
-  "chrome://flags/#force-high-performance-gpu";
 const MODEL_LOAD_HEARTBEAT_MS = 5_000;
 const DEFAULT_MODEL_DOWNLOAD_CONCURRENCY = 4;
 const MODEL_DOWNLOAD_PROGRESS_INTERVAL_MS = 250;
 const MODEL_DOWNLOAD_SPEED_WINDOW_MS = 5_000;
 const MODEL_DOWNLOAD_MAX_RANGE_PARTS = 4_096;
 const MODEL_DOWNLOAD_TARGET_RANGE_BYTES = 4_000_000;
-const INTEL_VENDOR_ID = 0x8086;
 const CAPABILITY_POLICY_PROTOCOL = "arcane-ai-browser-capability-policy/1";
 let highPerformanceGpuNoticeShown = false;
 
@@ -263,44 +260,71 @@ function publicDescriptor(source) {
   return modelDescriptor(source);
 }
 
-function isChromeBrowser() {
-  const userAgent = String(globalThis.navigator?.userAgent ?? "");
-  return /\b(?:Chrome|Chromium)\//u.test(userAgent)
-    && !/\b(?:Edg|OPR)\//u.test(userAgent);
-}
+function highPerformanceGpuBrowser() {
+    const navigatorObject = globalThis.navigator;
+    const userAgent = String(navigatorObject?.userAgent ?? "");
+    const clientHints = navigatorObject?.userAgentData;
+    const platform = String(clientHints?.platform || navigatorObject?.platform || userAgent);
+    if (
+        !/\b(?:Windows|Win32|Win64)\b/iu.test(platform)
+        || clientHints?.mobile === true
+        || /\b(?:Android|iPhone|iPad|iPod|Mobile)\b/iu.test(userAgent)
+    ) {
+        return null;
+    }
 
-function isLowerPowerIntelAdapter(adapter) {
-  const identity = [
-    adapter.vendor,
-    adapter.architecture,
-    adapter.name,
-    adapter.description,
-  ].filter(Boolean).join(" ");
-  if (adapter?.vendorId !== INTEL_VENDOR_ID && !/\bintel\b/iu.test(identity)) return false;
-  return /(?:intel|integrated|xe-lp)/iu.test(identity);
+    const brands = new Set();
+    for (const entry of clientHints?.brands ?? []) {
+        brands.add(entry.brand);
+    }
+    // Vivaldi can append its identity while also identifying as Edge or Chrome.
+    if (brands.has("Vivaldi") || /\bVivaldi\//u.test(userAgent)) {
+        return { name: "Vivaldi", url: "vivaldi://flags/#force-high-performance-gpu" };
+    }
+    if (brands.has("Brave") || typeof navigatorObject?.brave?.isBrave === "function") {
+        return { name: "Brave", url: "brave://flags/#force-high-performance-gpu" };
+    }
+    if (brands.has("Opera") || /\bOPR\//u.test(userAgent)) {
+        return { name: "Opera", url: "opera://flags/#force-high-performance-gpu" };
+    }
+    if (brands.has("Microsoft Edge") || /\bEdg\//u.test(userAgent)) {
+        return { name: "Microsoft Edge", url: "edge://flags/#force-high-performance-gpu" };
+    }
+    if (
+        brands.has("Chromium")
+        || brands.has("Google Chrome")
+        || /\b(?:Chrome|Chromium)\//u.test(userAgent)
+    ) {
+        // Some Chromium browsers mask their brand. about:// uses their own flags page.
+        return { name: "your browser", url: "about://flags/#force-high-performance-gpu" };
+    }
+    return null;
 }
 
-function notifyChromeHighPerformanceGpu(adapter) {
-  if (
-    highPerformanceGpuNoticeShown
-    || !isChromeBrowser()
-    || !isLowerPowerIntelAdapter(adapter)
-  ) return;
-  highPerformanceGpuNoticeShown = true;
-  try {
-    globalThis.open?.(CHROME_HIGH_PERFORMANCE_GPU_FLAG_URL, "_blank", "noopener,noreferrer");
-  } catch {
-    // Chrome may reject internal-page navigation from web content.
-  }
-  const adapterName = adapter.description || adapter.name
-    || [adapter.vendor, adapter.architecture].filter(Boolean).join(" ")
-    || "a lower-power Intel adapter";
-  globalThis.alert?.(
-    `Arcane selected the lower-power WebGPU adapter: ${adapterName}.\n\n`
-    + "Enable “Force High Performance GPU” in the Chrome flags window. "
-    + "Then completely close every Chrome window and reopen Chrome before loading the model again.\n\n"
-    + `If the flags window did not open, paste ${CHROME_HIGH_PERFORMANCE_GPU_FLAG_URL} into Chrome.`,
-  );
+function notifyHighPerformanceGpu(adapter) {
+    if (highPerformanceGpuNoticeShown) {
+        return;
+    }
+    const browser = highPerformanceGpuBrowser();
+    if (!browser) {
+        return;
+    }
+    highPerformanceGpuNoticeShown = true;
+    try {
+        globalThis.open?.(browser.url, "_blank", "noopener,noreferrer");
+    } catch {
+        // Browsers may reject internal-page navigation from web content.
+    }
+    const adapterName = adapter.description || adapter.name
+        || [adapter.vendor, adapter.architecture].filter(Boolean).join(" ")
+        || "the available WebGPU adapter";
+    globalThis.alert?.(
+        `Selected WebGPU adapter: ${adapterName}.\n\n`
+        + `If this computer has multiple GPUs, enable “Force High Performance GPU” in ${browser.name} `
+        + "to request the high-performance GPU when available. "
+        + `Then completely close and reopen ${browser.name} before loading the model again.\n\n`
+        + `If the flags page did not open, paste ${browser.url} into the address bar.`,
+    );
 }
 
 function emitWebgpuAdapterSelection(source, runtime) {
@@ -322,7 +346,7 @@ function emitWebgpuAdapterSelection(source, runtime) {
       category: "capability",
     }));
   } finally {
-    notifyChromeHighPerformanceGpu(webgpu.adapter);
+    notifyHighPerformanceGpu(webgpu.adapter);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.5.9",
+  "version": "0.5.10",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -54,7 +54,7 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/contracts.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dev-server.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/packaging.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/site.test.mjs test/update-check.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dev-server.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/packaging.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/site.test.mjs test/update-check.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/native-provider-generation.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",