arcane-os 0.2.1 → 0.2.3

package/package.json

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

package/runtime/ARCANE_RUNTIME_RELEASE.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "builder": "arcane-sdk-runtime-v1",
-  "sdkVersion": "0.2.1",
+  "sdkVersion": "0.2.3",
   "source": {
     "authority": "sdk-canonical",
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
@@ -14,8 +14,8 @@
     }
   },
   "fileCount": 160,
-  "totalBytes": 3605154,
-  "contentSha256": "5b921d50b6a0cf36a13f7a7dedf96cd3a68104a322e5139136fd4197aa1ca7cb",
+  "totalBytes": 3655536,
+  "contentSha256": "f96a27bd79a809201708f73ca729bc60ab02696daf619365f77267a28b47b4b3",
   "files": [
     {
       "path": "arcane/components/app-bar.html",
@@ -39,8 +39,8 @@
     },
     {
       "path": "arcane/components/chat.html",
-      "bytes": 61650,
-      "sha256": "d644848fbc3ccc85d491db7ada75231f393a371dd3a0ccd92f223c172571e47b"
+      "bytes": 60478,
+      "sha256": "2f3a7f454c1e3da64c9eaeedb0869d49f04636b20ff59e5116a671e0d0a17973"
     },
     {
       "path": "arcane/components/conversation-view.html",
@@ -159,8 +159,8 @@
     },
     {
       "path": "arcane/components/speech.html",
-      "bytes": 38217,
-      "sha256": "61786685b7f4f257da77db2cbbe8230b379c56292ad635081f5b0763d5f48e1e"
+      "bytes": 41300,
+      "sha256": "0ed5dd29c37747702f114114ad66bedd419fd39bed35fc12362c63c6357a41d9"
     },
     {
       "path": "arcane/components/summary-strip.html",
@@ -199,8 +199,8 @@
     },
     {
       "path": "arcane/components/voice-transcription.html",
-      "bytes": 14471,
-      "sha256": "7fab0ca767c252f661f7a3a5e09cf7325692b64a1d03e5731dc5d4f83c80c124"
+      "bytes": 26991,
+      "sha256": "8140b918791df5043be9254d52bf7864fe91759ab6e5e60af2364d6b4a8fcb7b"
     },
     {
       "path": "arcane/components/weather-widget.html",
@@ -374,8 +374,8 @@
     },
     {
       "path": "arcane/modules/AI.js",
-      "bytes": 103733,
-      "sha256": "3a051d67b1e895b7c6f14af36a34daf1d92fe70e02c95c1c4ffd80cc7c622561"
+      "bytes": 120607,
+      "sha256": "703a5342ed0c0758cccdfd8469fbae6d86e91de8c43ec01c893619daf97c2d34"
     },
     {
       "path": "arcane/modules/AIPreferenceRuntime.js",
@@ -389,8 +389,8 @@
     },
     {
       "path": "arcane/modules/AIProviderRuntime.js",
-      "bytes": 83261,
-      "sha256": "32aa65b464ea9a9317d47f382063fc052e1f47e63e6c65c28e58898e0ab4911a"
+      "bytes": 93507,
+      "sha256": "d1b33f678431128cefe6f43daabe177794e758c770394098871cf4ac726926b8"
     },
     {
       "path": "arcane/modules/AIResponseLength.js",
@@ -404,8 +404,8 @@
     },
     {
       "path": "arcane/modules/AIRuntimeState.js",
-      "bytes": 24783,
-      "sha256": "8b9bfaf208eb44455b581d8e700cec785044f81595dcf839dcdfa3e06ed0f5fa"
+      "bytes": 25379,
+      "sha256": "492162cec5e6a8b9e9b437833172905b2cb4e352ca1ef30104c65ec29cf3fa29"
     },
     {
       "path": "arcane/modules/AnsiText.js",
@@ -494,8 +494,8 @@
     },
     {
       "path": "arcane/modules/ComponentContracts.js",
-      "bytes": 20507,
-      "sha256": "4115d4ce8081e1dbaeb0a1a2fa3201ecddabf05a471f76e4deb7a071f9c31d20"
+      "bytes": 28736,
+      "sha256": "f5ba011094835b45258ee833a90bfa17980e860ef9ceac88aa56ecad3abe9d53"
     },
     {
       "path": "arcane/modules/ConfiguredAIChatSession.js",
@@ -599,8 +599,8 @@
     },
     {
       "path": "arcane/modules/LocalAIReadinessController.js",
-      "bytes": 4334,
-      "sha256": "32d4ce2639557b89a283754a67435226777b56df696ce7a76231ec6c0274b25c"
+      "bytes": 4340,
+      "sha256": "f80d51d0ad499664f265b4f2d52a46ede521a78d56714fecb0e13b939b261007"
     },
     {
       "path": "arcane/modules/MD.js",

package/runtime/arcane/components/chat.html

@@ -719,8 +719,7 @@
         ?speech.initialMuted
         :true;
     let initialSpeechMuteListenerInstalled=false;
-    let pendingSpeechAvailability=null;
-    let speechAvailabilityListenerInstalled=false;
+    let latestAIRuntimeRoles=null;
     const hostSubmissionBarrier=new ConversationSubmissionBarrier();
     const aiRuntimeStateAbortController=new AbortController();
     let programmaticSubmissionQueue=Promise.resolve(true);
@@ -910,36 +909,32 @@
     }
 
     function setAIAvailability(input={}){
-        const explicitSpeechAvailability={};
         const availability={
-            llm:Object.prototype.hasOwnProperty.call(input,'llm')
+            llm:hasSelectedAIRuntimeRole('llm')
+                ?latestAIRuntimeRoles.llm.state==='ready'
+                :Object.prototype.hasOwnProperty.call(input,'llm')
                 ?Boolean(input.llm)
                 :host.aiAvailability.llm,
-            stt:Object.prototype.hasOwnProperty.call(input,'stt')
-                ?Boolean(input.stt)
+            stt:latestAIRuntimeRoles
+                ?latestAIRuntimeRoles.stt.state==='ready'
                 :host.aiAvailability.stt,
-            tts:Object.prototype.hasOwnProperty.call(input,'tts')
-                ?Boolean(input.tts)
+            tts:latestAIRuntimeRoles
+                ?latestAIRuntimeRoles.tts.state==='ready'
                 :host.aiAvailability.tts
         };
 
-        if(Object.prototype.hasOwnProperty.call(input,'stt')){
-            explicitSpeechAvailability.stt=availability.stt;
-        }
-        if(Object.prototype.hasOwnProperty.call(input,'tts')){
-            explicitSpeechAvailability.tts=availability.tts;
-        }
         applyAIAvailability(availability);
-        if(Object.keys(explicitSpeechAvailability).length){
-            pendingSpeechAvailability={
-                ...(pendingSpeechAvailability||{}),
-                ...explicitSpeechAvailability
-            };
-            synchronizeSpeechCompatibilityAvailability();
-        }
         return {...availability};
     }
 
+    function hasSelectedAIRuntimeRole(role){
+        const record=latestAIRuntimeRoles?.[role];
+        return typeof record?.providerId==='string'
+            &&record.providerId.length>0
+            &&typeof record?.modelId==='string'
+            &&record.modelId.length>0;
+    }
+
     function applyAIAvailability(availability){
         host.aiAvailability={...availability};
         send.disabled=host.conversationComplete||!availability.llm;
@@ -1131,6 +1126,7 @@
     }
 
     function synchronizeAIRuntimeState(snapshot){
+        latestAIRuntimeRoles=snapshot.roles;
         aiActivationController.synchronize(snapshot.roles.llm);
         applyAIAvailability({
             llm:snapshot.roles.llm.state==='ready',
@@ -1139,37 +1135,6 @@
         });
     }
 
-    function synchronizeSpeechCompatibilityAvailability(){
-        if(!pendingSpeechAvailability){
-            return;
-        }
-        if(speech.componentReady){
-            const availability=pendingSpeechAvailability;
-            pendingSpeechAvailability=null;
-            speech.setAvailability?.({...availability});
-            return;
-        }
-        if(speechAvailabilityListenerInstalled){
-            return;
-        }
-
-        speechAvailabilityListenerInstalled=true;
-        speech.addEventListener(
-            'speech-ready',
-            applyPendingSpeechAvailability,
-            {once:true}
-        );
-    }
-
-    function applyPendingSpeechAvailability(){
-        speechAvailabilityListenerInstalled=false;
-        if(pendingSpeechAvailability){
-            const availability=pendingSpeechAvailability;
-            pendingSpeechAvailability=null;
-            speech.setAvailability?.({...availability});
-        }
-    }
-
     function formatConversationTime(milliseconds=0){
         const totalSeconds=Math.max(0,Math.floor(milliseconds/1000));
         const hours=Math.floor(totalSeconds/3600);

package/runtime/arcane/components/speech.html

@@ -63,6 +63,13 @@
         text-align: center;
     }
 
+    #sttActivationButton {
+        grid-column: 1;
+        max-width: 8rem;
+        background: var(--arcane-action, var(--primary-color));
+        color: var(--arcane-action-text, var(--button-text-color, var(--text-color)));
+    }
+
     #recordButton:active,
     #recordButton.pressed {
         opacity: .82;
@@ -108,7 +115,8 @@
             grid-template-columns: auto minmax(0, 1fr) auto;
         }
 
-        #recordButton {
+        #recordButton,
+        #sttActivationButton {
             grid-row: 1 / span 2;
         }
 
@@ -131,6 +139,7 @@
 
 <p class="hidden">Will auto send after X seconds of silence set in code.</p>
 <button id="recordButton" type="button" aria-label="Transcription unavailable" disabled>Hold to talk</button>
+<button id="sttActivationButton" type="button" hidden disabled>Start transcription</button>
 <button id="stopButton" type="button" class="hidden" disabled>Send</button>
 <p id="speechStatus" class="speech_status" role="status" aria-live="polite"></p>
 <button id="endButton" type="button" class="end">End</button>
@@ -147,10 +156,14 @@
         requestAIRuntimeIntent,
         subscribeAIRuntimeState
     } = await import('../modules/AIRuntimeState.js');
+    const {
+        createSTTActivationController
+    } = await import('../modules/ComponentContracts.js');
 
     const host = this;
     const shadowRoot = host.shadowRoot;
     const recordButton = shadowRoot.querySelector('#recordButton');
+    const sttActivationButton = shadowRoot.querySelector('#sttActivationButton');
     const stopButton = shadowRoot.querySelector('#stopButton');
     const endButton = shadowRoot.querySelector('#endButton');
     const muteButton = shadowRoot.querySelector('#muteButton');
@@ -167,11 +180,13 @@
     let recordingGeneration = 0;
     let transcriptionGeneration = 0;
     let transcriptionActive = false;
+    let transcriptionAbortController = null;
     let silenceTimer = null;
     let activePointerId = null;
     let keyboardRecording = false;
     let localStatus = null;
     let pendingTTSIntent = null;
+    let ttsIntentGeneration = 0;
     let destroyed = false;
 
     const initialMutedWasHydrated = typeof host.initialMuted === 'boolean';
@@ -180,6 +195,10 @@
     host.configure = configure;
     host.destroy = destroy;
     host.reportTTSError = reportTTSError;
+    host.requestSTTActivation = host.requestSTTActivation
+        || function requestSTTActivation(intent) {
+            return requestAIRuntimeIntent(intent);
+        };
     host.setAvailability = setAvailability;
     host.setMuted = setMuted;
     host.availability = {
@@ -190,6 +209,13 @@
         stt: false,
         tts: false
     };
+    const sttActivationController = createSTTActivationController(
+        {
+            host,
+            button: sttActivationButton,
+            onChange: renderSTTActivationState
+        }
+    );
 
     recordButton.addEventListener('pointerdown', handleRecordPointerDown);
     recordButton.addEventListener('pointerup', handleRecordPointerUp);
@@ -248,14 +274,11 @@
         );
     }
 
-    function compatibilityRole(role, ready) {
-        return Object.freeze(
-            {
-                ...unavailableRole(role),
-                state: ready ? 'ready' : 'unavailable',
-                loaded: ready
-            }
-        );
+    function selectedRole(role) {
+        return typeof role?.providerId === 'string'
+            && role.providerId.length > 0
+            && typeof role?.modelId === 'string'
+            && role.modelId.length > 0;
     }
 
     function configure(options = {}) {
@@ -288,11 +311,15 @@
         if (Object.prototype.hasOwnProperty.call(input, 'microphone')) {
             host.availability.microphone = Boolean(input.microphone);
         }
-        if (Object.prototype.hasOwnProperty.call(input, 'stt')) {
-            sttRole = compatibilityRole('stt', Boolean(input.stt));
+        if (Object.prototype.hasOwnProperty.call(input, 'stt')
+            && !Boolean(input.stt)
+            && !selectedRole(sttRole)) {
+            sttRole = unavailableRole('stt');
         }
-        if (Object.prototype.hasOwnProperty.call(input, 'tts')) {
-            ttsRole = compatibilityRole('tts', Boolean(input.tts));
+        if (Object.prototype.hasOwnProperty.call(input, 'tts')
+            && !Boolean(input.tts)
+            && !selectedRole(ttsRole)) {
+            ttsRole = unavailableRole('tts');
         }
 
         if (microphoneWasAvailable && !host.availability.microphone) {
@@ -337,6 +364,7 @@
     }
 
     function applyRoleTransitions(previousSTTRole, previousTTSRole) {
+        sttActivationController.synchronize(sttRole);
         const sttBecameUnready = previousSTTRole.state === 'ready'
             && sttRole.state !== 'ready';
         const ttsBecameUnready = previousTTSRole.state === 'ready'
@@ -362,6 +390,11 @@
         renderStatus();
     }
 
+    function renderSTTActivationState() {
+        renderControls();
+        renderStatus();
+    }
+
     function clearSettledTTSIntent() {
         if (!pendingTTSIntent) {
             return;
@@ -383,6 +416,8 @@
     function renderControls() {
         const transcriptionReady = sttRole.state === 'ready';
         const microphoneReady = host.availability.microphone;
+        const activationVisible = sttActivationController.visible;
+        recordButton.hidden = activationVisible;
         recordButton.disabled = !transcriptionReady
             || !microphoneReady
             || sttRole.busy
@@ -395,6 +430,24 @@
             'aria-pressed',
             String(recordingRequested || Boolean(captureSession))
         );
+        sttActivationButton.hidden = !activationVisible;
+        sttActivationButton.disabled = destroyed
+            || sttActivationController.pending
+            || sttRole.state === 'unloading'
+            || sttActivationController.action === null;
+        sttActivationButton.textContent = sttActivationController.label;
+        sttActivationButton.title = sttActivationController.title;
+        sttActivationButton.setAttribute(
+            'aria-label',
+            sttActivationButton.title
+        );
+        sttActivationButton.setAttribute(
+            'aria-busy',
+            String(
+                sttActivationController.pending
+                || ['loading', 'unloading'].includes(sttRole.state)
+            )
+        );
         renderTTSControl();
     }
 
@@ -492,31 +545,21 @@
             'aria-busy',
             String(
                 sttRole.state === 'loading'
+                || sttRole.state === 'unloading'
                 || ttsRole.state === 'loading'
                 || sttRole.busy
                 || ttsRole.busy
+                || sttActivationController.pending
                 || transcriptionActive
             )
         );
     }
 
     function describeSTTRole() {
-        if (sttRole.state === 'ready') {
-            if (!host.availability.microphone) {
-                return 'Microphone unavailable.';
-            }
-            return sttRole.busy ? 'Transcription busy.' : 'Transcription ready.';
-        }
-        if (sttRole.state === 'loading') {
-            return `Transcription ${formatRoleProgress(sttRole.progress, 'loading')}.`;
-        }
-        if (sttRole.state === 'error') {
-            return `Transcription error: ${visibleErrorMessage(sttRole.error, 'Unknown error')}.`;
+        if (sttRole.state === 'ready' && !host.availability.microphone) {
+            return 'Microphone unavailable.';
         }
-        if (sttRole.state === 'disposed') {
-            return 'Transcription disposed.';
-        }
-        return 'Transcription unavailable.';
+        return sttActivationController.status;
     }
 
     function describeTTSRole() {
@@ -748,10 +791,15 @@
     }
 
     function requestTTSIntent(action, reason) {
+        const generation = ++ttsIntentGeneration;
         pendingTTSIntent = action === 'load' && ttsRole.state === 'ready'
             ? null
             : action;
+        let lifecycle = null;
         try {
+            if (typeof globalThis.ai?.setSpeechMuted === 'function') {
+                lifecycle = globalThis.ai.setSpeechMuted(action === 'unload');
+            }
             requestAIRuntimeIntent(
                 {
                     role: 'tts',
@@ -761,8 +809,27 @@
             );
         } catch (error) {
             pendingTTSIntent = null;
+            if (action === 'load') {
+                host.muted = true;
+                stopTTSPlayback();
+            }
             reportTTSLifecycleError(error, action);
+            return false;
         }
+        void Promise.resolve(lifecycle).catch(
+            function reportCurrentTTSSpeechLifecycleFailure(error) {
+                if (destroyed || generation !== ttsIntentGeneration) {
+                    return;
+                }
+                pendingTTSIntent = null;
+                if (action === 'load') {
+                    host.muted = true;
+                    stopTTSPlayback();
+                }
+                reportTTSLifecycleError(error, action);
+            }
+        );
+        return true;
     }
 
     function reportTTSLifecycleError(error, action) {
@@ -1051,6 +1118,9 @@
 
     async function transcribeAudio(audioFile) {
         const generation = ++transcriptionGeneration;
+        const controller = new AbortController();
+        transcriptionAbortController?.abort();
+        transcriptionAbortController = controller;
         transcriptionActive = true;
         localStatus = {
             message: 'Transcribing speech.',
@@ -1065,7 +1135,11 @@
                 throw new Error('The selected transcription service is unavailable.');
             }
 
-            const transcription = await aiRuntime.fetchSTT(audioFile);
+            const transcription = await aiRuntime.fetchSTT(
+                audioFile,
+                undefined,
+                controller.signal
+            );
             if (
                 generation !== transcriptionGeneration
                 || sttRole.state !== 'ready'
@@ -1086,6 +1160,9 @@
             }
             return false;
         } finally {
+            if (transcriptionAbortController === controller) {
+                transcriptionAbortController = null;
+            }
             if (generation === transcriptionGeneration) {
                 transcriptionActive = false;
                 renderControls();
@@ -1126,6 +1203,8 @@
             || transcriptionActive;
         recordingGeneration += 1;
         transcriptionGeneration += 1;
+        transcriptionAbortController?.abort();
+        transcriptionAbortController = null;
         recordingRequested = false;
         transcriptionActive = false;
         clearSilenceTimer();
@@ -1199,6 +1278,7 @@
 
         destroyed = true;
         runtimeStateAbortController.abort();
+        sttActivationController.destroy();
         window.removeEventListener('pagehide', destroy);
         microphonePermissionStatus?.removeEventListener?.(
             'change',