arcane-os 0.77.0 → 0.79.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.77.0",
+  "version": "0.79.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -69,6 +69,7 @@
     "./core/preferences": "./src/core/services/preferences.mjs",
     "./core/diarization": "./src/diarization/service.mjs",
     "./core/local-ai": "./src/core/services/local-ai.mjs",
+    "./core/execution-devices": "./src/core/services/execution-devices.mjs",
     "./core/decisions": "./src/core/services/decisions.mjs",
     "./core/image": "./src/core/services/image.mjs",
     "./core/speech": "./src/core/services/speech.mjs",
@@ -77,6 +78,7 @@
     "./diarization/build": "./src/diarization/build.mjs",
     "./local-ai": "./src/local-ai/install.mjs",
     "./local-ai/onnx": "./src/local-ai/onnx.mjs",
+    "./local-ai/execution-devices": "./src/local-ai/execution-devices.mjs",
     "./local-ai/decisions": "./src/local-ai/decisions.mjs",
     "./local-ai/image": "./src/local-ai/image-runtime.mjs",
     "./local-ai/whisper": "./src/local-ai/whisper/index.mjs",
@@ -123,7 +125,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/app-selection.test.mjs test/contracts.test.mjs test/conversation-closing-report.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/native-windows-icon.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/ai-ollama-readiness.test.mjs test/core-ollama-lifecycle.test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-decisions.test.mjs test/browser-kokoro-complete-input.test.mjs test/browser-speech-providers.test.mjs test/browser-speech-artifacts.test.mjs test/browser-speech-resource-bridge.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/codex-app-server.test.mjs test/mcp-stdio-server.test.mjs test/core-classic-source.test.mjs test/core-client.test.mjs test/core-client-installation.test.mjs test/core-ai-installation.test.mjs test/core-llama-lifecycle.test.mjs test/core-development.test.mjs test/core-host.test.mjs test/core-shared-host.test.mjs test/core-model-assets.test.mjs test/core-native-services.test.mjs test/core-packaged-web.test.mjs test/core-runtime.test.mjs test/core-stdio.test.mjs test/dbopfs-committed-events.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-model-resources.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/local-image-editing.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-media.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/model-resource-bridge.test.mjs test/native-decisions.test.mjs test/native-onnx.test.mjs test/native-module-packaging.test.mjs test/native-module-resource-references.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/rendered-print.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/theme-manager.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/websocket-client-import-map.test.mjs test/websocket.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/ai-ollama-readiness.test.mjs test/core-ollama-lifecycle.test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-decisions.test.mjs test/browser-kokoro-complete-input.test.mjs test/browser-speech-providers.test.mjs test/browser-speech-artifacts.test.mjs test/browser-speech-resource-bridge.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/codex-app-server.test.mjs test/mcp-stdio-server.test.mjs test/core-classic-source.test.mjs test/core-client.test.mjs test/core-client-installation.test.mjs test/core-ai-installation.test.mjs test/core-llama-lifecycle.test.mjs test/core-development.test.mjs test/core-host.test.mjs test/core-shared-host.test.mjs test/core-model-assets.test.mjs test/core-native-services.test.mjs test/core-packaged-web.test.mjs test/core-runtime.test.mjs test/core-stdio.test.mjs test/dbopfs-committed-events.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-model-resources.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/execution-devices.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/local-image-editing.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-media.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/model-resource-bridge.test.mjs test/native-decisions.test.mjs test/native-onnx.test.mjs test/native-module-packaging.test.mjs test/native-module-resource-references.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/rendered-print.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/theme-manager.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/websocket-client-import-map.test.mjs test/websocket.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-macos-provider.test.mjs test/native-plan.test.mjs test/native-portable-provider.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/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/html-import-packaged-script.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/ai-audio-output.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",

package/runtime/arcane/modules/AI.js

@@ -26,7 +26,7 @@ import {
     openAIResponseFormat
 } from 'arcane-os/ai/twin-cloud';
 import {MarkdownSpeech,stripSpeechFormatting} from 'arcane-os/speech-text';
-import {prepareSpeech} from './PreparedSpeech.js';
+import {prepareSpeech, readPreparedSpeech} from './PreparedSpeech.js';
 import {createToolTextObserver} from 'arcane-os/ai/tool-text-stream';
 
 const completeValue=(value)=>value;
@@ -6341,16 +6341,15 @@ class AI {
         return result;
     }
 
-    prepareTTS({parts, textFormat, storage = null, identity = null, signal = null, onState = null} = {}) {
+    #preparedSpeechInput(parts, textFormat, operation) {
         if(this.#providerSpeechModel()?.speech?.playback==='native'){
             const error=new Error('Native browser speech has no audio file to prepare or store; use prepareTTSPlayback.');
             error.code='ARCANE_AI_TTS_AUDIO_EXPORT_UNAVAILABLE';
             throw error;
         }
         if(!is.array(parts)) {
-            throw new TypeError('AI.prepareTTS parts must be an array.');
+            throw new TypeError(`${operation} parts must be an array.`);
         }
-        const runtime = this;
         const selected = this.#providerRuntime.selection('tts');
         const configuredSpeech = this.browserSpeechConfiguration?.tts;
         const configuration = configuredSpeech
@@ -6367,12 +6366,9 @@ class AI {
             responseFormat: selected ? this.#providerSpeechResponseFormat() : this.audioFormat,
             configuration
         };
-        const browserGeneration = this.#browserSpeechGeneration;
-        const controlGeneration = this.#speechControlGeneration;
         const defaultVoice = selected
             ? this.#providerSpeechVoice()
             : this.#builtInSpeechDefaultVoice('tts', this.ttsService);
-        const responseFormat = selection.responseFormat;
         const segmentation = this.ttsSegmentation;
         const segments = [];
         for(const part of parts) {
@@ -6398,6 +6394,33 @@ class AI {
                 );
             }
         }
+        return {segments, selection, segmentation, selected};
+    }
+
+    async readPreparedTTS({parts, textFormat, storage = null, identity = null, signal = null, onState = null} = {}) {
+        const {segments, selection, segmentation} = this.#preparedSpeechInput(parts, textFormat, 'AI.readPreparedTTS');
+        this.#traceSpeech('readPreparedTTS.call', {parts, segments, selection, segmentation, identity, storage});
+        return readPreparedSpeech(
+            {
+                owner: this,
+                parts: segments,
+                originalParts: parts,
+                selection,
+                segmentation,
+                storage,
+                identity,
+                signal,
+                onState
+            }
+        );
+    }
+
+    prepareTTS({parts, textFormat, storage = null, identity = null, signal = null, onState = null} = {}) {
+        const {segments, selection, segmentation, selected} = this.#preparedSpeechInput(parts, textFormat, 'AI.prepareTTS');
+        const runtime = this;
+        const browserGeneration = this.#browserSpeechGeneration;
+        const controlGeneration = this.#speechControlGeneration;
+        const responseFormat = selection.responseFormat;
         this.#traceSpeech('prepareTTS.call', {parts, segments, selection, segmentation, identity, storage});
         async function synthesizePreparedSpeech(part, requestSignal) {
             function assertPreparedSpeechSelection() {

package/runtime/arcane/modules/DBOPFS.js

@@ -554,12 +554,13 @@ class DBOPFS {
 
     /**
      * Gets the directory handle for a table.
-     * Creates the table if it does not exist.
+     * Creates the table if it does not exist unless create is false.
      *
      * @param {string} tableName
+     * @param {{create?:boolean}} options A false create performs an existing-table lookup only.
      * @returns {Promise<FileSystemDirectoryHandle>}
      */
-    async getTableHandle(tableName=''){
+    async getTableHandle(tableName='',{create=true}={}){
         if(!this.ready){
             await this.readyPromise;
         }
@@ -582,6 +583,14 @@ class DBOPFS {
             return existingHandle;
         }
 
+        if(!create){
+            // A read-existing lookup must not wait for another caller to create the table.
+            return this.#db.getDirectoryHandle(
+                directoryName,
+                {create:false}
+            );
+        }
+
         if(!this.#tableHandlePromises[registeredTableName]){
             const handlePromise=this.#db.getDirectoryHandle(
                 directoryName,
@@ -736,10 +745,14 @@ class DBOPFS {
      *
      * @param {string} tableName
      * @param {string} fileName
+     * @param {{createTable?:boolean}} options A false createTable preserves an absent table.
      * @returns {Promise<File>}
      */
-    async readFile(tableName='',fileName=''){
-        const table=await this.getTableHandle(tableName)
+    async readFile(tableName='',fileName='',{createTable=true}={}){
+        const table=await this.getTableHandle(
+            tableName,
+            {create:createTable}
+        )
         const handle=await table.getFileHandle(fileName,{create:false})
 
         if(is.function(handle.getFile)){
@@ -818,14 +831,19 @@ class DBOPFS {
      * @param {string} tableName
      * @param {string} fileName
      * @param {boolean} force
+     * @param {{createTable?:boolean}} options A false createTable preserves an absent table.
      * @returns {Promise<*>}
      */
-    async get(tableName='',fileName='',force=false){
+    async get(tableName='',fileName='',force=false,{createTable=true}={}){
         if(force||!this.#tables[tableName]?.[fileName]){
             const cacheState=this.#fileCacheState(tableName,fileName);
             const cacheRevision=cacheState.revision;
             try{
-                const file=await this.readFile(tableName,fileName)
+                const file=await this.readFile(
+                    tableName,
+                    fileName,
+                    {createTable}
+                )
                 const textContent=await file.text()
 
                 if(!this.#tables[tableName]){

package/runtime/arcane/modules/PreparedSpeech.js

@@ -111,8 +111,10 @@ function serializeStorage(storage,execute){
     return operation;
 }
 
-async function readManifest(storage){
-    const stored=await storage.db.get(storage.table,storage.fileName,true);
+async function readManifest(storage,cacheOnly=false){
+    const stored=cacheOnly
+        ?await storage.db.get(storage.table,storage.fileName,true,{createTable:false})
+        :await storage.db.get(storage.table,storage.fileName,true);
     if(stored===null||stored===undefined)return {version:1,entries:[]};
     const manifest=copyJSON(stored);
     if(manifest.version!==1||!is.array(manifest.entries)){
@@ -349,9 +351,10 @@ function finishPreparation(job,error){
     job.finished.resolve();
 }
 
-function createJob(ownerState,input,storage,synthesize,previous){
-    const job={
+function createJobState(input,storage,synthesize=null,previous=null){
+    return {
         input,storage,synthesize,previous,
+        cacheOnly:false,
         controller:new AbortController(),
         interests:new Set(),
         state:'queued',
@@ -367,6 +370,10 @@ function createJob(ownerState,input,storage,synthesize,previous){
             return {...part,index,state:'queued',audioFile:null,contentType:null,error:null};
         })
     };
+}
+
+function createJob(ownerState,input,storage,synthesize,previous){
+    const job=createJobState(input,storage,synthesize,previous);
     const admission=ownerState.admission.then(function admitOrderedPreparation(){
         return admitPreparation(job);
     });
@@ -416,7 +423,9 @@ function createHandle(job,signal,onState){
             if(!interest.active)throw abortError();
             if(!job.storage)return job.slots[index].blob;
             const audio=job.record.segments[index];
-            const file=await job.storage.db.readFile(job.storage.table,audio.audioFile);
+            const file=job.cacheOnly
+                ?await job.storage.db.readFile(job.storage.table,audio.audioFile,{createTable:false})
+                :await job.storage.db.readFile(job.storage.table,audio.audioFile);
             if(!interest.active)throw abortError();
             return file.type===audio.contentType?file:new Blob([file],{type:audio.contentType});
         },
@@ -482,4 +491,100 @@ function prepareSpeech({
     return createHandle(job,signal,onState);
 }
 
-export {prepareSpeech};
+/** Read complete existing audio without synthesis, storage writes, or repair. */
+async function readPreparedSpeech({
+    owner,
+    parts,
+    originalParts=parts,
+    selection=null,
+    segmentation=null,
+    storage=null,
+    identity=null,
+    signal=null,
+    onState=null
+}={}){
+    if((!owner||!is.object(owner))&&!is.function(owner)){
+        throw new TypeError('Speech preparation requires its owning AI instance.');
+    }
+    if(!is.array(parts)||(onState!==null&&!is.function(onState))){
+        throw new TypeError('Cached speech requires ordered parts and an optional state callback.');
+    }
+    const input=copyJSON({parts,originalParts,selection,segmentation,identity});
+    const destination=normalizeStorage(storage);
+    if(signal?.aborted)throw abortError();
+    function completeCachedRead(job){
+        // The lookup signal owns only this read. Retained audio keeps its own
+        // explicit cancellation lifetime after a successful lookup returns.
+        const handle=createHandle(job,null,onState);
+        if(signal?.aborted){
+            handle.cancel();
+            throw abortError();
+        }
+        return handle;
+    }
+    if(!destination){
+        const jobs=owners.get(owner)?.jobs;
+        if(!jobs)return null;
+        for(const job of jobs){
+            if(job.storage||!job.done||job.failed||job.controller.signal.aborted
+                ||!sameInput(job.input,input))continue;
+            if(!job.slots.every(function hasRetainedAudio(slot){
+                return slot.settled&&slot.blob instanceof Blob;
+            }))return null;
+            return completeCachedRead(job);
+        }
+        return null;
+    }
+    const cancelled=deferred();
+    function cancelRead(){cancelled.reject(abortError());}
+    signal?.addEventListener('abort',cancelRead,{once:true});
+    try{
+        const reading=serializeStorage(destination,async function readCachedPreparation(){
+            if(signal?.aborted)throw abortError();
+            const manifest=await readManifest(destination,true);
+            if(signal?.aborted)throw abortError();
+            const record=manifest.entries.find(function findCachedPreparation(entry){
+                return sameInput(entry,input);
+            });
+            if(!record)return null;
+            if(!is.array(record.segments)||record.segments.length!==input.parts.length){
+                throw new TypeError('Stored speech preparation segments are unreadable.');
+            }
+            let complete=true;
+            for(const audio of record.segments){
+                if(!audio?.audioFile){
+                    complete=false;
+                    continue;
+                }
+                if(!is.string(audio.contentType)){
+                    throw new TypeError('Stored speech audio content type is unreadable.');
+                }
+                if(signal?.aborted)throw abortError();
+                try{
+                    const file=await destination.db.readFile(destination.table,audio.audioFile,{createTable:false});
+                    if(!(file instanceof Blob)){
+                        throw new TypeError('Stored speech audio must be a Blob.');
+                    }
+                }catch(error){
+                    if(error?.name!=='NotFoundError')throw error;
+                    complete=false;
+                }
+                if(signal?.aborted)throw abortError();
+            }
+            return complete?record:null;
+        });
+        const record=await Promise.race([reading,cancelled.promise]);
+        if(signal?.aborted)throw abortError();
+        if(!record)return null;
+        const job=createJobState(input,destination);
+        job.cacheOnly=true;
+        job.record=record;
+        for(let index=0;index<job.slots.length;index+=1)settleSegment(job,index);
+        finishPreparation(job);
+        return completeCachedRead(job);
+    }finally{
+        signal?.removeEventListener('abort',cancelRead);
+    }
+}
+
+export {prepareSpeech,readPreparedSpeech};

package/src/core/services/decisions.mjs

@@ -4,6 +4,10 @@ import {createArcaneEventSource} from '../../event-manager.mjs';
 import {CoreError} from '../../../browser-runtime/core/contracts.mjs';
 import {encodeTensorMap} from '../../../browser-runtime/ai/onnx-tensors.mjs';
 
+function sameExecutionTarget(left, right) {
+    return left === right || (left != null && right != null && left.deviceId !== undefined && left.deviceId === right.deviceId);
+}
+
 /** App-owned selection; shared typed-decision execution, without a renderer. */
 export function createNativeDecisionService(configuration = {}, {appRoot = process.cwd()} = {}) {
     const events = createArcaneEventSource({}, {source: 'core-decisions', eventTypes: ['decisions.state']});
@@ -15,14 +19,22 @@ export function createNativeDecisionService(configuration = {}, {appRoot = proce
     let releasing;
     let closing;
     let unsubscribe;
+    let selectedTarget = configuration.executionTarget;
+    let loadingTarget;
+    let loadedTarget;
 
     function current() {
-        return model?.current() ?? {
+        const snapshot = model?.current() ?? {
             family: 'laya', model: configuration.model ?? 'onnx-community/laya-typed-decisions-ONNX',
             revision: configuration.revision ?? 'main', dtype: configuration.dtype ?? 'fp32',
             state: closing ? 'disposed' : 'unloaded', loaded: false, busy: Boolean(loading),
             activeRequests: 0, progress: null, error: null, execution: null
         };
+        const pending = Boolean(loading) && (!snapshot.loaded || !sameExecutionTarget(loadedTarget, loadingTarget));
+        return {
+            ...snapshot, busy: snapshot.busy || pending,
+            pendingActivation: pending ? {executionTarget: loadingTarget} : snapshot.pendingActivation ?? null
+        };
     }
 
     function publish(value = current()) {
@@ -39,20 +51,24 @@ export function createNativeDecisionService(configuration = {}, {appRoot = proce
 
     function operationSignal(signal) { return signal ? AbortSignal.any([signal, lifetime.signal]) : lifetime.signal; }
 
-    function load({signal} = {}) {
+    function load({signal, executionTarget: requestedTarget} = {}) {
         operationSignal(signal).throwIfAborted();
         if (!context) throw new CoreError({code: 'CORE_NOT_READY', message: 'Register and start the decision service with Core before loading.'});
-        if (loading) return observeLoad(loading, loadController, signal);
-        if (model?.current().loaded) return Promise.resolve(model.current());
-        loadController = new AbortController();
-        const controller = loadController;
+        const target = requestedTarget === undefined ? selectedTarget : requestedTarget;
+        if (loading && !loadController.signal.aborted && sameExecutionTarget(loadingTarget, target)) return observeLoad(loading, loadController, signal);
+        if (!loading && model?.current().loaded && sameExecutionTarget(loadedTarget, target)) return Promise.resolve(current());
+        const previousLoad = loading;
+        const previousController = loadController;
+        const controller = new AbortController();
         const selectedSignal = AbortSignal.any([lifetime.signal, controller.signal]);
         const precedingRelease = releasing;
-        loading = Promise.resolve().then(async function loadSelectedModel() {
+        const task = Promise.resolve().then(async function loadSelectedModel() {
             selectedSignal.throwIfAborted();
             if (precedingRelease) await precedingRelease;
+            if (previousLoad) await Promise.allSettled([previousLoad]);
             selectedSignal.throwIfAborted();
             if (model) await model.dispose();
+            selectedSignal.throwIfAborted();
             unsubscribe?.();
             // Only the explicit load waits for its native dependencies. Merely
             // registering this service does not download a model or delay UI.
@@ -65,23 +81,43 @@ export function createNativeDecisionService(configuration = {}, {appRoot = proce
                 Object.entries(configuration.paths).map(function nativePath([name, value]) { return [name, path.resolve(appRoot, value)]; })
             );
             model = createNativeDecisionModel({
-                ...configuration, paths, onnx: localAI.getONNXRuntime(), modelAssets,
+                ...configuration, paths, onnx: localAI.getONNXRuntime(), modelAssets, executionTarget: target,
                 signal: lifetime.signal
             });
-            unsubscribe = model.subscribe(publish);
-            return model.load({signal: selectedSignal});
+            unsubscribe = model.subscribe(function modelStateChanged() { publish(); });
+            const result = await model.load({signal: selectedSignal});
+            selectedSignal.throwIfAborted();
+            loadedTarget = target;
+            return result;
         });
-        function settled() { loading = undefined; loadController = undefined; publish(); }
-        loading.then(settled, settled);
+        function settled() {
+            if (loading !== task) return;
+            loading = undefined;
+            loadController = undefined;
+            publish();
+        }
+        task.then(settled, settled).catch(function reportStateFailure(error) { console.error('Native decision state publication failed.', error); });
+        loading = task;
+        loadController = controller;
+        loadingTarget = target;
+        selectedTarget = target;
+        previousController?.abort(new CoreError({name: 'AbortError', code: 'ARCANE_AI_REQUEST_ABORTED', message: 'The native decision activation request was replaced.'}));
         publish();
-        return observeLoad(loading, controller, signal);
+        return observeLoad(task, controller, signal);
     }
 
     function observeLoad(task, controller, signal) {
         function abort() { controller.abort(signal.reason); }
         signal?.addEventListener('abort', abort, {once: true});
         if (signal?.aborted) abort();
-        return task.finally(function detachLoadCaller() { signal?.removeEventListener('abort', abort); });
+        return task.then(function loadedActivation(result) {
+            controller.signal.throwIfAborted();
+            const snapshot = current();
+            if ((loading && loadController !== controller) || !snapshot.loaded || snapshot.execution !== result.execution) {
+                throw new CoreError({name: 'AbortError', code: 'ARCANE_AI_REQUEST_ABORTED', message: 'The native decision activation was replaced.'});
+            }
+            return snapshot;
+        }).finally(function detachLoadCaller() { signal?.removeEventListener('abort', abort); });
     }
 
     async function evaluate(rows, {signal, runOptions} = {}) {
@@ -129,7 +165,7 @@ export function createNativeDecisionService(configuration = {}, {appRoot = proce
         start(serviceContext) { context = serviceContext; },
         methods: {
             'decisions.status': current,
-            'decisions.load': function loadRequest(parameters, request) { return load({signal: request.signal}); },
+            'decisions.load': function loadRequest(parameters, request) { return load({executionTarget: parameters?.executionTarget, signal: request.signal}); },
             'decisions.evaluate': async function evaluateRequest({rows, runOptions}, request) {
                 const result = await evaluate(rows, {runOptions, signal: request.signal});
                 // Typed arrays retain their complete values through Core's

package/src/core/services/execution-devices.mjs

@@ -0,0 +1,32 @@
+import {createExecutionDeviceCatalog} from '../../local-ai/execution-devices.mjs';
+
+/**
+ * Independent of model-service startup. Core gives this service ownership of
+ * the shared catalog's disposal; model engines borrowing it do not dispose it.
+ */
+export function createExecutionDeviceService({catalog = createExecutionDeviceCatalog()} = {}) {
+    function devices({refresh = false} = {}, {signal} = {}) {
+        return catalog.devices(
+            {refresh, signal}
+        );
+    }
+
+    function resolveTarget({executionTarget = null, refresh = false} = {}, {signal} = {}) {
+        return catalog.resolveTarget(
+            {executionTarget, refresh, signal}
+        );
+    }
+
+    function dispose() {
+        return catalog.dispose();
+    }
+
+    return {
+        name: 'execution-devices',
+        methods: {
+            'localai.devices': devices,
+            'localai.resolveTarget': resolveTarget
+        },
+        dispose
+    };
+}

package/src/core/services/local-ai.mjs

@@ -121,7 +121,7 @@ function collectCompletion(completion, chunk) {
 }
 
 /** Core owns native processes; applications own runtime and model selection. */
-export function createLocalAIService(configuration, {appRoot, runtimes = [], signal, onEvent, prepare} = {}) {
+export function createLocalAIService(configuration, {appRoot, runtimes = [], signal, onEvent, prepare, executionDevices} = {}) {
     const config = normalizeLocalAIConfig(configuration) ?? {runtimes: []};
     const lifetime = new AbortController();
     const lifetimeSignal = signal ? AbortSignal.any([signal, lifetime.signal]) : lifetime.signal;
@@ -173,7 +173,9 @@ export function createLocalAIService(configuration, {appRoot, runtimes = [], sig
 
     function startONNX() {
         if (!onnxRecord?.modulePath) return;
-        onnx = createONNXRuntime({modulePath: onnxRecord.modulePath, signal: lifetimeSignal, onEvent});
+        onnx = createONNXRuntime(
+            {modulePath: onnxRecord.modulePath, signal: lifetimeSignal, onEvent, executionDevices}
+        );
         stopONNXSubscription = onnx.subscribe(function onnxChanged() { publish(); });
     }
 
@@ -630,9 +632,14 @@ export function createLocalAIService(configuration, {appRoot, runtimes = [], sig
                 return snapshot();
             },
             'onnx.status': function currentONNX() { return onnxStatus(); },
-            'onnx.load': function loadONNX({id, model, sessionOptions}, request) {
-                return requireONNX().load({id, model: path.resolve(appRoot ?? process.cwd(), model), sessionOptions,
-                    signal: AbortSignal.any([lifetimeSignal, request.signal])});
+            'onnx.load': function loadONNX({id, model, sessionOptions, executionPreference, executionTarget}, request) {
+                return requireONNX().load(
+                    {
+                        id, model: path.resolve(appRoot ?? process.cwd(), model), sessionOptions,
+                        executionPreference, executionTarget,
+                        signal: AbortSignal.any([lifetimeSignal, request.signal])
+                    }
+                );
             },
             'onnx.run': async function runONNX({id, feeds, fetches, runOptions}, request) {
                 const outputs = await requireONNX().run({id, feeds: decodeTensorMap(feeds),