arcane-os 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.7.2
+
+- Keep both supported browser NPU and GPU flag address copy controls available
+  regardless of API availability, GPU classification, or detection failure.
+  Use one short explanation per flag and one shared paste/enable/relaunch
+  instruction. Preserve browser-reported statuses and the GPU-only chat notice.
+
 ## 0.7.1
 
 - Make Profile NPU and GPU setup concise and copy-only, with **Copy NPU flag

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.7.1` SDK contract. Applications pin one exact npm
+This checkout defines the `0.7.2` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 
@@ -35,7 +35,7 @@ Create one browser application, install its pinned SDK, and start its source
 server:
 
 ```bash
-npx arcane-os@0.7.1 new hello-speech --path ./hello-speech --target browser
+npx arcane-os@0.7.2 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -378,7 +378,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.7.1 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.7.2 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run dev
@@ -388,7 +388,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.7.1
+npm install --save-dev --save-exact arcane-os@0.7.2
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -404,7 +404,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.7.1` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.7.2` 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`,
@@ -424,7 +424,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.7.1.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.7.2.tgz
 npm ci
 ```
 
@@ -433,7 +433,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.7.1` registry package and
+the local declaration with the exact `arcane-os@0.7.2` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -572,7 +572,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.7.1` exposes one browser target and five explicitly paired
+Version `0.7.2` 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/docs/architecture.md

@@ -279,7 +279,7 @@ paths are withheld from the native provider. The provider copies the complete
 selected release rather than accepting an unrelated source path. Verification
 is a separate explicit operation for a selected release artifact.
 
-The SDK `0.7.1` runtime requires Arcane `0.8.12` or newer. Compatibility
+The SDK `0.7.2` runtime requires Arcane `0.8.12` or newer. Compatibility
 is contractual rather than exact-version pinning: the prepared Core must meet
 the highest minimum declared by the runtime, selected app, and bundled app
 dependencies; keep each app's Arcane protocol generation; and provide every

package/docs/reference/ai/browser-speech.md

@@ -144,8 +144,8 @@ name. It does not load a model or create a GPU device or WebNN context:
 </html-import>
 ```
 
-When WebNN is unavailable, **NPU setup** provides a **Copy NPU flag address**
-button and a short enable/relaunch instruction. Chrome uses
+**NPU setup** provides a **Copy NPU flag address** button regardless of WebNN
+availability, with one short explanation. Chrome uses
 `chrome://flags/#web-machine-learning-neural-network`; Edge uses
 `edge://flags/#web-machine-learning-neural-network`. Unrecognized browsers
 receive explicit Chrome and Edge choices. A failed copy shows the complete
@@ -153,9 +153,10 @@ address as selectable text; the component does not open internal browser pages.
 The [ONNX Runtime WebNN guide](https://onnxruntime.ai/docs/tutorials/web/ep-webnn.html)
 documents the **Enables WebNN API** flag and model/operator requirements.
 
-The **GPU performance** section shows a short adapter status. Only an explicitly
-reported integrated or software adapter receives setup guidance on desktop
-Windows Chromium browsers. Identified
+The **GPU performance** section shows a short adapter status and a **Copy GPU
+flag address** button on desktop Windows Chromium browsers. The button remains
+available for every adapter class, unavailable API, or detection failure. One
+shared instruction explains pasting, enabling, saving work, and relaunching. Identified
 Chrome uses `chrome://flags/#force-high-performance-gpu`; other recognized
 Chromium browsers use their corresponding internal scheme. **Refresh**
 requests a new availability result; concurrent
@@ -166,9 +167,9 @@ settings update. Component readiness does not wait for adapter detection.
 Adapter selection uses `powerPreference: "high-performance"` as a hint, not proof
 of the selected GPU's performance or the flag's current state. When the browser
 explicitly reports a discrete GPU, Profile says **Already using the performance
-GPU.** and hides setup instructions. Explicit integrated or software/fallback
+GPU.** Explicit integrated or software/fallback
 metadata is reported as such. Missing type metadata shows **GPU available.**
-without flag advice and leaves performance selection unconfirmed; a vendor name is not a GPU
+and leaves performance selection unconfirmed; a vendor name is not a GPU
 classification. The component cannot read the browser flag or prove that a
 model is executing on the adapter. See the
 [component contract](../runtime-components.md#browser-ai-setuphtml) for result

package/docs/reference/inventory/runtime-components.json

@@ -5,7 +5,7 @@
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
     "branch": "main",
     "path": "runtime/arcane/components",
-    "sdkVersion": "0.7.1"
+    "sdkVersion": "0.7.2"
   },
   "componentCount": 40,
   "loader": "/arcane/modules/HTMLImport.js",
@@ -98,7 +98,7 @@
       ],
       "availability": "Browser and supported native WebViews",
       "transport": "HTMLImport + DOM; Clipboard API and WebGPU adapter request. Settings addresses use Copy controls and appear as text if copying fails; open() copies the NPU address without navigation or an alert.",
-      "normalization": "API presence, adapter availability, explicit browser GPU class, and copy instructions normalized. A reported discrete GPU shows Already using the performance GPU. Only explicitly reported integrated/software adapters show flag instructions. Absent type metadata shows GPU available and leaves performance selection unconfirmed. Mounting starts one adapter request; checkGpu() coalesces concurrent calls, while refresh() remains synchronous. No GPU device, model, or WebNN context is created. Adapter metadata does not establish browser flag state, the fastest physical GPU, or another page's model execution."
+      "normalization": "API presence, adapter availability, explicit browser GPU class, and copy instructions normalized. Supported browser NPU and GPU flag copy controls remain available regardless of API availability, adapter class, or detection failure. A reported discrete GPU shows Already using the performance GPU. Absent type metadata shows GPU available and leaves performance selection unconfirmed. Mounting starts one adapter request; checkGpu() coalesces concurrent calls, while refresh() remains synchronous. No GPU device, model, or WebNN context is created. Adapter metadata does not establish browser flag state, the fastest physical GPU, or another page's model execution."
     },
     {
       "file": "runtime/arcane/components/calculator.html",

package/docs/reference/runtime-components.md

@@ -159,11 +159,13 @@ Slots: `title`, `subtitle`, `identity`, `messages/message`, `composer`, `actions
 ### Overview
 
 Displays a short WebNN availability status and the detected WebGPU adapter.
-When WebNN is unavailable, Chrome and Edge receive a **Copy NPU flag address**
-button for their own browser; unidentified browsers show both choices. Desktop Windows
-Chromium browsers receive the matching Force High Performance GPU address only
-when an integrated or software adapter is explicitly reported,
+Chrome and Edge receive a **Copy NPU flag address** button for their own browser;
+unidentified browsers show both choices. Desktop Windows Chromium browsers
+receive a **Copy GPU flag address** button for the matching browser,
 including `chrome://flags/#force-high-performance-gpu` for identified Chrome.
+Both controls remain available regardless of API availability, adapter class,
+or detection failure. Each flag has one short explanation, followed by a shared
+paste, enable, save, and relaunch instruction.
 Settings addresses use Copy controls and appear as selectable text if copying
 fails. The component does not attempt navigation to internal browser pages.
 
@@ -189,9 +191,8 @@ or `null`, `adapterType` as the browser's string or `null`, and
 `performanceStatus`: `"discrete"`, `"integrated"`, `"fallback"`, or `"unknown"`.
 Only the explicit browser type or fallback field establishes that status;
 vendor names and the requested power preference do not. A discrete result
-shows **Already using the performance GPU.** and hides flag instructions.
-An unknown class shows **GPU available.** without recommending flag changes;
-performance selection remains unconfirmed in the result. Adapter selection does not
+shows **Already using the performance GPU.** An unknown class shows **GPU available.**
+and leaves performance selection unconfirmed. Adapter selection does not
 prove that a browser flag is enabled, that the fastest GPU was selected, or that
 a model is using it. Failure is displayed and logged, and the promise
 resolves to `false`; destruction also yields `false` and suppresses late UI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/runtime/arcane/components/browser-ai-setup.html

@@ -58,9 +58,10 @@
         <p><span id="gpuAvailability" class="arcane-badge gpu-status" role="status" aria-live="polite"></span></p>
         <p id="gpuAdapterName" class="arcane-help"></p>
         <div id="gpuSetup" hidden>
-            <p>If you have a discrete GPU, enable “Force High Performance GPU”, save your work, and restart the browser.</p>
+            <p>“Force High Performance GPU” prefers your faster GPU.</p>
             <button id="copyGpuAddress" class="arcane-button arcane-button--secondary" type="button">Copy GPU flag address</button>
         </div>
+        <p>Paste a copied address into your browser's address bar. Enable the flag, save your work, and relaunch.</p>
         <details>
             <summary>Setup help</summary>
             <p><a href="https://onnxruntime.ai/docs/tutorials/web/ep-webnn.html">WebNN setup documentation</a></p>
@@ -101,7 +102,6 @@
     let copyTask=null;
     let copyingAddress = null;
     let gpuTask=null;
-    let gpuResult = null;
     let destroyed=false;
 
     host.refresh=refresh;
@@ -115,10 +115,9 @@
         root.querySelector('#webnnAvailability').textContent = settings.webnnAvailable
             ? 'WebNN available.'
             : 'WebNN unavailable.';
-        root.querySelector('#npuSetup').hidden = settings.webnnAvailable;
         const unknownBrowser = settings.browserId === 'unknown';
         root.querySelector('#browserInstructions').textContent = settings.webnnFlagsURL || unknownBrowser
-            ? 'Enable “Enables WebNN API”, save your work, and relaunch the browser.'
+            ? '“Enables WebNN API” allows NPU use when supported.'
             : 'See Setup help for this browser.';
         for (const choice of choices) {
             choice.row.hidden = !unknownBrowser && choice.target.url !== settings.webnnFlagsURL;
@@ -129,12 +128,7 @@
     }
 
     function renderGpuGuidance(settings = getBrowserDeviceSettings()) {
-        const gpuTarget = settings.highPerformanceGpu;
-        const nonperformance = gpuResult?.available && (
-            gpuResult.performanceStatus === 'integrated'
-            || gpuResult.performanceStatus === 'fallback'
-        );
-        root.querySelector('#gpuSetup').hidden = !nonperformance || !gpuTarget;
+        root.querySelector('#gpuSetup').hidden = !settings.highPerformanceGpu;
     }
 
     function checkGpu() {
@@ -156,7 +150,6 @@
             try {
                 const result = await detectBrowserGpu();
                 if (destroyed) return false;
-                gpuResult = result;
                 if (!result.available) {
                     gpuAvailability.textContent = 'GPU unavailable.';
                     gpuAvailability.dataset.status = 'warning';
@@ -174,14 +167,11 @@
                     gpuAvailability.dataset.status = 'unknown';
                 }
                 gpuAdapterName.textContent = result.available ? result.name : '';
-                renderGpuGuidance();
                 return result;
             } catch (error) {
                 if (!destroyed) {
-                    gpuResult = null;
                     gpuAvailability.textContent = 'GPU detection failed. Select Refresh to retry.';
                     gpuAvailability.dataset.status = 'error';
-                    renderGpuGuidance();
                     arcaneLogging.error('Unable to detect the browser GPU adapter.', error);
                 }
                 return false;