arcane-os 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.9.0
+
+- Add `getBrowserDeviceClass()` through the dependency-free
+  `arcane-os/browser-device` entrypoint and managed browser import map. Return
+  `mobile` or `desktop` from browser identity hints, including Android tablets
+  and iPadOS Mac-platform touch identity, for application-owned settings.
+- Keep classification independent of model imports, GPU requests, network,
+  storage, listeners, and viewport changes. Missing or unrecognized identity
+  defaults to `desktop`; the result does not claim hardware capability or
+  model readiness, and existing provider defaults remain unchanged.
+
 ## 0.8.1
 
 - Use `arcaneVersion` as the sole local resource version field across import maps,

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.8.1` SDK contract. Applications pin one exact npm
+This checkout defines the `0.9.0` 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.8.1 new hello-speech --path ./hello-speech --target browser
+npx arcane-os@0.9.0 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -386,7 +386,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.8.1 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.9.0 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run dev
@@ -396,7 +396,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.8.1
+npm install --save-dev --save-exact arcane-os@0.9.0
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -412,7 +412,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.8.1` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.9.0` 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`,
@@ -432,7 +432,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.8.1.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.9.0.tgz
 npm ci
 ```
 
@@ -441,7 +441,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.8.1` registry package and
+the local declaration with the exact `arcane-os@0.9.0` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -580,7 +580,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.8.1` exposes one browser target and five explicitly paired
+Version `0.9.0` 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/browser-device.mjs

@@ -0,0 +1,13 @@
+/** Selects application settings from browser identity hints, including tablets. */
+export function getBrowserDeviceClass(navigatorObject = globalThis.navigator) {
+    const userAgent = String(navigatorObject?.userAgent ?? '');
+    const clientHints = navigatorObject?.userAgentData;
+    const platform = String(clientHints?.platform || navigatorObject?.platform || '');
+    const mobile = clientHints?.mobile === true
+        || /\b(?:Android|iOS|iPhone|iPad|iPod)\b/iu.test(platform)
+        || /\b(?:Android|iPhone|iPad|iPod|Mobile)\b/iu.test(userAgent)
+        // iPadOS can identify as a Mac while retaining its touch capabilities.
+        || (/\b(?:MacIntel|Macintosh|macOS)\b/iu.test(platform)
+            && navigatorObject?.maxTouchPoints > 1);
+    return mobile ? 'mobile' : 'desktop';
+}

package/docs/architecture.md

@@ -289,7 +289,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.8.1` runtime requires Arcane `0.8.12` or newer. Compatibility
+The SDK `0.9.0` 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/README.md

@@ -124,11 +124,12 @@ Public reference entries follow the established Arcane documentation model:
 
 ## Public runtime inventory
 
-The package exposes 202 semantic JavaScript records across 18 JavaScript
+The package exposes 203 semantic JavaScript records across 19 JavaScript
 entrypoints, plus eight JSON Schemas and package metadata. Ten entrypoints are
 Node.js control-plane surfaces,
 `arcane-os/event-manager`, `arcane-os/logging`, `arcane-os/mail`, `arcane-os/preference-store`, and
-`arcane-os/speech-playback` plus `arcane-os/speech-text` run in Node and browsers, and
+`arcane-os/speech-playback`, `arcane-os/speech-text`, and `arcane-os/browser-device`
+run in Node and browsers, and
 `arcane-os/ai/browser-wasm` plus `arcane-os/ai/browser-speech` are browser-only.
 The [machine-readable package
 inventory](inventory/package-api.json) and [SDK member reference](sdk-api.md)

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

@@ -61,6 +61,25 @@ model source. Each file needs only a name and HTTPS URL. A positive optional
 `bytes` value supplies observational progress and transport-planning metadata;
 it never validates, admits, identifies, or decides cache reuse for content.
 
+## Mobile and desktop settings
+
+`getBrowserDeviceClass(navigatorObject = globalThis.navigator)`, exported from
+`arcane-os/browser-device`, returns `mobile` or `desktop` for choosing
+application-owned settings. Mobile includes a positive mobile client hint,
+Android or iOS platform information, mobile user-agent identifiers, and iPadOS
+reporting a Mac platform with multiple touch points. Missing or unrecognized
+identity defaults to `desktop`; a browser hiding all mobile hints may therefore
+receive that profile. This classification is a settings hint, not evidence of
+GPU capability, available memory, or model readiness.
+
+Keep complete mobile and desktop load profiles at the application owner and
+pass the selected profile as `createBrowserWasmLlmProvider({loadDefaults})`.
+Choose it once before provider creation so catalog inspection and model loading
+use the same settings. The helper reads identity synchronously and starts no
+GPU request, model operation, listener, or viewport-dependent reload. Its
+dependency-free entrypoint does not import the inference runtime. Profile
+selection does not alter prompts, documents, history, or output limits.
+
 ## Lifecycle at a glance
 
 `createArcaneAI()` owns one LLM controller. Its default `loadPolicy` is

package/docs/reference/inventory/package-api.json

@@ -6,7 +6,7 @@
     "minimumVersion": "22.23.2 for Node entrypoints",
     "moduleSystem": "ESM"
   },
-  "memberCount": 202,
+  "memberCount": 203,
   "members": [
     {
       "id": "root:APP_BUNDLE_DESCRIPTOR_NAME",
@@ -2952,6 +2952,22 @@
       "protocol": "Resumable ordered model members and deterministic per-member Range parts over existing DBOPFS method semantics",
       "normalization": "Uses one bounded transfer axis, preserves ordered completed shards and deterministic current Range parts within any member across interruption, emits coalesced additive loaded/total/remaining/rate/ETA/active-worker telemetry, rolls discarded partial writes back out of progress, cleans superseded current Range parts after a complete replacement exists, and settles failed or cancelled peers while retaining completed work for retry"
     },
+    {
+      "id": "browser-device:getBrowserDeviceClass",
+      "name": "getBrowserDeviceClass",
+      "displayName": "getBrowserDeviceClass()",
+      "kind": "function",
+      "signature": "getBrowserDeviceClass(navigatorObject = globalThis.navigator)",
+      "entrypoints": [
+        "arcane-os/browser-device"
+      ],
+      "primaryImport": "arcane-os/browser-device",
+      "group": "Browser device settings",
+      "summary": "Returns a mobile or desktop browser identity hint for application-owned settings.",
+      "availability": "Node and Browser; no model, storage, or GPU capability required",
+      "protocol": "Synchronous optional navigator-like identity input and mobile or desktop string result",
+      "normalization": "Positive mobile hints, Android or iOS identity, and iPadOS Mac-platform touch identity select mobile; missing or unrecognized identity selects desktop. Importing the dependency-free entrypoint loads no AI runtime, and classification performs no model, GPU, storage, network, or listener operation."
+    },
     {
       "id": "browser-speech:BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",
       "name": "BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",

package/docs/reference/sdk-api.md

@@ -2,8 +2,8 @@
 
 The npm package exposes a Node.js ESM control plane, the portable
 `arcane-os/event-manager`, `arcane-os/logging`, `arcane-os/mail`,
-`arcane-os/preference-store`, `arcane-os/speech-playback`, and
-`arcane-os/speech-text` entrypoints, and the browser-only
+`arcane-os/preference-store`, `arcane-os/speech-playback`,
+`arcane-os/speech-text`, and `arcane-os/browser-device` entrypoints, and the browser-only
 `arcane-os/ai/browser-wasm` and `arcane-os/ai/browser-speech` entrypoints.
 Those package subpaths are distinct from application-facing projection modules
 in the managed browser map, such as `arcane/AIProviderRuntime`,
@@ -38,6 +38,7 @@ for the installed-inventory-derived physical-runtime contract in SDK `0.5.18`.
 | `arcane-os/preference-store` | Portable preference records and injected storage adapters. |
 | `arcane-os/speech-playback` | Portable speech preparation, playback state, and injected media adapters. |
 | `arcane-os/speech-text` | Speech-input formatting cleanup for complete text and streamed chunks. |
+| `arcane-os/browser-device` | Synchronous mobile or desktop identity hints for application-owned settings. |
 | `arcane-os/ai/browser-wasm` | Caller-selected browser-local Wllama inference, complete DBOPFS model storage, streaming, cancellation, and structural tool-call results. |
 | `arcane-os/ai/browser-speech` | Caller-selected browser-local Whisper STT and Kokoro TTS provider mechanisms, ordinary upstream assets, materialized/native routing, Workers, and cancellation. |
 | `arcane-os/mail` | Portable Mail runtime, durable outbox, complete transport responses, and provider-neutral acceptance contracts. |
@@ -124,6 +125,7 @@ browser map are cataloged separately in [Runtime modules](runtime-modules.md).
 | `createBrowserWhisperProvider()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser with Workers, object URLs, caller-selected Whisper runtime/model artifacts, and an SDK DBOPFS speech store |
 | `createCanonicalUstarHeader()` | function | `arcane-os` | Packaging and release bundles | Node |
 | `createDbopfsModelStore()` | function | `arcane-os/ai/browser-wasm` | Browser-WASM local AI | Browser with a ready DBOPFS instance and OPFS |
+| `getBrowserDeviceClass()` | function | `arcane-os/browser-device` | Browser device settings | Node and Browser; synchronous identity hint with no model, storage, or GPU operation |
 | `createDbopfsSpeechArtifactStore()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser with ready DBOPFS, Web Locks, Fetch, File/Blob, and object URLs |
 | `removeBrowserSpeechModelCache()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser CacheStorage; explicit removal of one selected upstream model |
 | `createNativeBuildPlan()` | function | `arcane-os` | Targets, native plans, and providers | Node; selected browser/native target or provider as documented |
@@ -6007,6 +6009,43 @@ const source = createBrowserModelSource({
 });
 ```
 
+## getBrowserDeviceClass()
+
+### Overview
+
+Returns `mobile` or `desktop` to select application-owned settings. Phones and
+tablets use `mobile` when browser client hints, platform, user-agent information,
+or the iPadOS Mac-platform/touch combination identifies them. Missing or
+unrecognized identity uses `desktop`.
+
+### Signature and result
+
+```text
+getBrowserDeviceClass(navigatorObject = globalThis.navigator)
+```
+
+The optional navigator-like object supplies `userAgentData`, `userAgent`,
+`platform`, and `maxTouchPoints`. The synchronous string result reports a
+settings class, not hardware capability or readiness.
+
+### Availability and normalization
+
+Import from `arcane-os/browser-device` in Node or a browser. The dependency-free
+entrypoint reads only the supplied or global browser identity and does not load
+an AI runtime. No model, GPU, storage, network, or listener operation runs.
+Missing or unrecognized identity returns `desktop`; browser identity masking
+can affect classification. Existing provider defaults remain unchanged unless
+the caller selects and supplies its own profile.
+
+### Example
+
+```javascript
+import {getBrowserDeviceClass} from 'arcane-os/browser-device';
+
+const deviceClass = getBrowserDeviceClass();
+console.log(deviceClass); // mobile or desktop
+```
+
 ## createBrowserWasmLlmProvider()
 
 ### Overview

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -14,6 +14,7 @@
     "./events": "./src/events.mjs",
     "./event-manager": "./src/event-manager.mjs",
     "./logging": "./browser-runtime/logging.mjs",
+    "./browser-device": "./browser-runtime/browser-device.mjs",
     "./preference-store": "./runtime/arcane/modules/PreferenceStore.js",
     "./speech-playback": "./runtime/arcane/modules/SpeechPlayback.js",
     "./speech-text": "./browser-runtime/speech-text.mjs",

package/src/import-map.mjs

@@ -23,6 +23,7 @@ const STATIC_RUNTIME_PACKAGE_IMPORTS=new Map([
 const SDK_BROWSER_SELF_IMPORTS=new Map([
     ['arcane-os/event-manager',SDK_BROWSER_ENTRY],
     ['arcane-os/logging','sdk/logging.mjs'],
+    ['arcane-os/browser-device','sdk/browser-device.mjs'],
     ['arcane-os/speech-text','sdk/speech-text.mjs'],
     ['arcane-os/ai/browser-wasm',SDK_BROWSER_AI_ENTRY],
     ['arcane-os/ai/browser-speech',SDK_BROWSER_SPEECH_ENTRY]