arcane-os 0.5.13 → 0.5.15

package/runtime/arcane/modules/CommunicationAppController.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import ArcaneCommunicationBridge from './ArcaneCommunicationBridge.js';
 import CommunicationHub from './CommunicationHub.js?v=2';
 import CommunicationPreferences from './CommunicationPreferences.js';
@@ -360,7 +361,7 @@ export default class CommunicationAppController{
                 hub.dispose();
             }
         }catch(error){
-            console.error('The communication hub could not be disposed cleanly.',error);
+            arcaneLogging.error('The communication hub could not be disposed cleanly.',error);
         }
     }
 

package/runtime/arcane/modules/ComponentContracts.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
     createArcaneEventSource,
     projectArcaneDOMEvent
@@ -713,7 +714,7 @@ function createSTTActivationController({
                 try{
                     onChange();
                 }catch(error){
-                    console.error('Unable to render STT activation state:',error);
+                    arcaneLogging.error('Unable to render STT activation state:',error);
                 }
             }
         }
@@ -724,7 +725,7 @@ function createSTTActivationController({
         if(nextAction){
             void request(nextAction).catch(
                 function reportSTTActivationRequestFailure(error){
-                    console.error('The STT activation request could not settle.',error);
+                    arcaneLogging.error('The STT activation request could not settle.',error);
                 }
             );
         }

package/runtime/arcane/modules/ConversationTimebox.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 
 const CONVERSATION_TIMEBOX_TOOL_NAME='conversation_timebox';
@@ -168,7 +169,7 @@ function conversationTimeboxSubmissionKey(context={}){
 }
 
 function reportConversationTimeboxListenerError(error){
-    console.error('A conversation timebox listener failed.',error);
+    arcaneLogging.error('A conversation timebox listener failed.',error);
 }
 
 function conversationTimeboxError(message,code,reason,ErrorType=Error){

package/runtime/arcane/modules/DBOPFS.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import Is from "../../node_modules/strong-type/index.js";
 import {openApplicationDataDirectory} from './AppDataScope.js';
 import {
@@ -458,7 +459,7 @@ class DBOPFS {
                         );
                     }
                 }catch(error){
-                    console.error(`Error writing file '${fileName}' to table '${tableName}':`,error)
+                    arcaneLogging.error(`Error writing file '${fileName}' to table '${tableName}':`,error)
                     throw error
                 }
 
@@ -603,7 +604,7 @@ class DBOPFS {
                 const fileName=entries[index][0]
 
                 if(result.status!=='fulfilled'){
-                    console.error(`Failed to set file '${fileName}':`,result.reason)
+                    arcaneLogging.error(`Failed to set file '${fileName}':`,result.reason)
                 }
             }
         );
@@ -742,7 +743,7 @@ class DBOPFS {
             await table.removeEntry(fileName)
         }catch(error){
             if(error.name!=='NotFoundError'){
-                console.error(error)
+                arcaneLogging.error(error)
                 throw error
             }
         }
@@ -784,7 +785,7 @@ class DBOPFS {
             delete this.#tables[tableName]
             delete this.#tableHandles[tableName]
         }catch(error){
-            console.error(error)
+            arcaneLogging.error(error)
         }
 
         return true

package/runtime/arcane/modules/Errors.js

@@ -1,4 +1,5 @@
 import waitForComponent from './WaitForComponent.js';
+import { arcaneLogging,readArcaneDeveloperMode } from 'arcane-os/logging';
 import {
     arcaneEvents,
     createArcaneEventSource
@@ -154,18 +155,6 @@ async function sendWithWindowMail(target,...args){
     return target.mail.send(...args);
 }
 
-function defaultDeveloperModeStatus(target){
-    try{
-        if(target?.user?.ready!==true){
-            return null;
-        }
-
-        return target.user.developer===true;
-    }catch{
-        return false;
-    }
-}
-
 function appendDeveloperDetail(document,list,label,value){
     if(value===null||value===undefined||value===''){
         return;
@@ -340,7 +329,7 @@ class Errors {
         this.now=options.now||Date.now;
         this.schedule=options.schedule||globalThis.setTimeout.bind(globalThis);
         this.cancel=options.cancel||globalThis.clearTimeout.bind(globalThis);
-        this.logger=options.logger||globalThis.console;
+        this.logger=options.logger||arcaneLogging;
         this.storage=options.storage===undefined
             ? defaultStorage(target)
             : options.storage;
@@ -352,7 +341,7 @@ class Errors {
             || sendWithWindowMail.bind(null,target);
         this.isDeveloperMode=typeof options.isDeveloperMode==='function'
             ? options.isDeveloperMode
-            : defaultDeveloperModeStatus.bind(null,target);
+            : readArcaneDeveloperMode.bind(null,target);
         this.presentDeveloperIncident=typeof options.presentDeveloperIncident==='function'
             ? options.presentDeveloperIncident
             : presentDeveloperIncidentModal.bind(null,target);

package/runtime/arcane/modules/HTMLImport.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
   createArcaneEventSource,
   projectArcaneDOMEvent
@@ -299,7 +300,7 @@ class HTMLImport extends HTMLElement {
     let resolvedHref='';
     const operationId=`html-import-load-${this.#events.instanceId}-${generation}`;
     if(!href){
-      console.log('no href provided for html-import tag',this);
+      arcaneLogging.log('no href provided for html-import tag',this);
       this.#loadController=null;
       return;
     }
@@ -319,7 +320,7 @@ class HTMLImport extends HTMLElement {
         await this.#destroyImportedHost();
         return;
       }
-      console.error('Error loading HTML component:',err);
+      arcaneLogging.error('Error loading HTML component:',err);
       const detail={
           code:'HTML_IMPORT_FAILED',
           href,
@@ -369,7 +370,7 @@ class HTMLImport extends HTMLElement {
   }
 
   #reportImportedDestroyError(error,{events,href,operationId}){
-    console.error('Error destroying imported HTML component:',error);
+    arcaneLogging.error('Error destroying imported HTML component:',error);
     if(!events||events.disposed)return;
     const detail={
       code:'HTML_IMPORT_IMPORTED_COMPONENT_DESTROY_REJECTED',

package/runtime/arcane/modules/LocalAIReadinessController.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {
     checkLocalAIReadiness,
     deriveLocalAIRequirements
@@ -287,7 +288,7 @@ export function createLocalAIReadinessController({
     function retry(){
         void check().catch(function ignoreDestroyedLocalAIRetry(error){
             if(error?.name!=='AbortError'){
-                console.error('Local AI readiness retry failed.',error);
+                arcaneLogging.error('Local AI readiness retry failed.',error);
             }
         });
     }

package/runtime/arcane/modules/MD.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import { marked } from './Marked.min.js';
 import Is from '../../node_modules/strong-type/index.js';
 
@@ -45,7 +46,7 @@ class MD {
 
     set raw(value=''){
         if(!is.string(value)){
-            console.trace('MD.raw must be a string.');
+            arcaneLogging.trace('MD.raw must be a string.');
             return this.#raw;
         }
         this.#raw = value;
@@ -55,7 +56,7 @@ class MD {
 
     append(value=''){
         if(!is.string(value)){
-            console.trace('MD.append must be a string.');
+            arcaneLogging.trace('MD.append must be a string.');
             return this.#raw;
         }
         this.#raw += value;

package/runtime/arcane/modules/MailOutbox.mjs

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 export const MAIL_OUTBOX_PROTOCOL='arcane-mail-outbox/1';
 export const MAIL_OUTBOX_TABLE='mail_outbox';
 export const MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS=24*60*60*1000;
@@ -34,7 +35,7 @@ function reportMailOutboxObserverError(error){
             return;
         }
     }catch{}
-    try{globalThis.console?.error?.(error);}catch{}
+    try{arcaneLogging.error?.(error);}catch{}
 }
 
 function fail(message,code='MAIL_OUTBOX_INVALID',ErrorType=Error,cause){

package/runtime/arcane/modules/PersistentAIChatSession.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import ChatEntity from '../entities/Chat.js';
 import ConfiguredAIChatSession,{
     normalizeStructuralToolCall
@@ -475,7 +476,7 @@ class PersistentAIChatSession{
                 error instanceof Error?error:new Error('The saved chat history is invalid.'),
                 'AI_CHAT_INCOHERENT_PERSISTENCE',
             );
-            console.error('Arcane saved chat history is readable but not actionable.',error);
+            arcaneLogging.error('Arcane saved chat history is readable but not actionable.',error);
         }
         const storedSystem=storedMessages.find(message=>message.role==='system');
         const initialMessages=storedMessages

package/runtime/arcane/modules/ScreenCapture.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 import GifEncoder from './GifEncoder.js';
 
@@ -252,7 +253,7 @@ function supportedRecorderType(Recorder){
 
 function reportDetachedError(error){
     if(typeof globalThis.reportError==='function')globalThis.reportError(error);
-    else globalThis.console?.error?.(error);
+    else arcaneLogging.error?.(error);
 }
 
 function monotonicNow(){

package/runtime/arcane/modules/SpeechPlayback.js

@@ -289,6 +289,90 @@ function queueFor(speech){
     return queue;
 }
 
+function providerSpeechCapacity(speech){
+    if(typeof speech?.fetchTTS!=='function')return null;
+    try{
+        const providerRuntime=speech.providerRuntime;
+        if(!providerRuntime||typeof providerRuntime.status!=='function')return null;
+        const capacity=providerRuntime.status(
+            'tts',
+            {execution:true}
+        )?.execution?.maxConcurrentRequests;
+        return Number.isSafeInteger(capacity)&&capacity>0?capacity:null;
+    }catch{
+        // Clients without inspectable provider capacity retain serialized admission.
+        return null;
+    }
+}
+
+function startProviderSegment(playback,index,providerSynthesisBatch){
+    if(
+        providerSynthesisBatch!==playback.providerSynthesisBatch
+        ||index<0
+        ||index>=playback.parts.length
+        ||playback.urls[index]
+    )return null;
+    const existing=playback.segmentRequests.get(index);
+    if(existing?.providerSynthesisBatch===providerSynthesisBatch){
+        return existing;
+    }
+
+    playback.segmentErrors.delete(index);
+    const record={providerSynthesisBatch,index,promise:null};
+    record.promise=playback.synthesizeSegment(
+        index,
+        playback.generation,
+        index===0,
+        providerSynthesisBatch
+    ).then(
+        function storeProviderSynthesizedSegment(outcome){
+            if(outcome===SUPERSEDED)return {ready:false,superseded:true};
+            if(providerSynthesisBatch!==playback.providerSynthesisBatch){
+                playback.revokeObjectURL(outcome.url);
+                return {ready:false,superseded:true};
+            }
+            playback.urls[index]=outcome.url;
+            return {ready:true};
+        },
+        function handleProviderSegmentFailure(error){
+            if(providerSynthesisBatch===playback.providerSynthesisBatch){
+                playback.segmentErrors.set(
+                    index,
+                    {providerSynthesisBatch,index,error}
+                );
+            }
+            return {ready:false,error};
+        }
+    ).finally(function clearSettledProviderSegment(){
+        if(playback.segmentRequests.get(index)===record){
+            playback.segmentRequests.delete(index);
+        }
+    }).catch(function observeProviderSegmentHandlingFailure(error){
+        if(providerSynthesisBatch===playback.providerSynthesisBatch){
+            playback.segmentErrors.set(
+                index,
+                {providerSynthesisBatch,index,error}
+            );
+        }
+        return {ready:false,error};
+    });
+    playback.segmentRequests.set(index,record);
+    return record;
+}
+
+function startProviderSynthesis(playback,providerSynthesisBatch){
+    let first=null;
+    for(let index=0;index<playback.parts.length;index+=1){
+        const record=startProviderSegment(
+            playback,
+            index,
+            providerSynthesisBatch
+        );
+        if(index===0)first=record;
+    }
+    return first;
+}
+
 const DEFAULT_MESSAGES={
     idle:'Speech is ready when visual content is available.',
     queued:'Waiting for the current local speech request. The latest narration will begin next.',
@@ -364,6 +448,9 @@ class SpeechPlayback{
         this.pendingGenerations=new Set();
         this.lookahead=null;
         this.lookaheadError=null;
+        this.providerSynthesisBatch=null;
+        this.segmentRequests=new Map();
+        this.segmentErrors=new Map();
         this.model=model===null||model===undefined?null:String(model);
         this.voice=voice===null||voice===undefined?null:String(voice);
         this.responseFormat=responseFormat===null||responseFormat===undefined
@@ -441,7 +528,12 @@ class SpeechPlayback{
         );
     }
 
-    hasAudio(key=this.key){return Boolean(this.urls.some(Boolean)&&(!key||key===this.key));}
+    hasAudio(key=this.key){
+        const playable=this.providerSynthesisBatch
+            ?Boolean(this.urls[0])
+            :this.urls.some(Boolean);
+        return Boolean(playable&&(!key||key===this.key));
+    }
 
     releaseURLs(){
         for(const url of this.urls){
@@ -451,6 +543,9 @@ class SpeechPlayback{
         this.parts=[];
         this.lookahead=null;
         this.lookaheadError=null;
+        this.providerSynthesisBatch=null;
+        this.segmentRequests.clear();
+        this.segmentErrors.clear();
     }
 
     releaseUrls(){this.releaseURLs();}
@@ -496,39 +591,55 @@ class SpeechPlayback{
         throw error;
     }
 
-    async synthesizeSegment(index,generation,announce=false){
+    async synthesizeSegment(
+        index,
+        generation,
+        announce=false,
+        providerSynthesisBatch=null
+    ){
         const playback=this;
         const controller=new AbortController();
         const token={generation,index,controller};
-        const queue=queueFor(this.speech);
+        const queue=providerSynthesisBatch?null:queueFor(this.speech);
         this.pendingGenerations.add(token);
         this.abortControllers.add(controller);
+        function segmentRequestIsCurrent(){
+            return providerSynthesisBatch
+                ?providerSynthesisBatch===playback.providerSynthesisBatch
+                :generation===playback.generation;
+        }
+        async function synthesizeQueuedSegment(){
+            const part=playback.parts[index];
+            if(!segmentRequestIsCurrent()||!part){
+                controller.abort();
+                return SUPERSEDED;
+            }
+            if(announce){
+                playback.emit('synthesizing',playback.message('preparing',{count:playback.parts.length}));
+            }
+            const audio=await playback.requestSpeech(
+                part,
+                controller.signal
+            );
+            if(!segmentRequestIsCurrent()){
+                controller.abort();
+                return SUPERSEDED;
+            }
+            const url=playback.createObjectURL(audio);
+            if(!segmentRequestIsCurrent()){
+                playback.revokeObjectURL(url);
+                controller.abort();
+                return SUPERSEDED;
+            }
+            return {url};
+        }
         try{
-            return await queue.enqueue(async function synthesizeQueuedSegment(){
-                const part=playback.parts[index];
-                if(generation!==playback.generation||!part){
-                    controller.abort();
-                    return SUPERSEDED;
-                }
-                if(announce){
-                    playback.emit('synthesizing',playback.message('preparing',{count:playback.parts.length}));
-                }
-                const audio=await playback.requestSpeech(
-                    part,
-                    controller.signal
+            return providerSynthesisBatch
+                ?await Promise.resolve().then(synthesizeQueuedSegment)
+                :await queue.enqueue(
+                    synthesizeQueuedSegment,
+                    {speculative:!announce}
                 );
-                if(generation!==playback.generation){
-                    controller.abort();
-                    return SUPERSEDED;
-                }
-                const url=playback.createObjectURL(audio);
-                if(generation!==playback.generation){
-                    playback.revokeObjectURL(url);
-                    controller.abort();
-                    return SUPERSEDED;
-                }
-                return {url};
-            },{speculative:!announce});
         }finally{
             this.pendingGenerations.delete(token);
             this.abortControllers.delete(controller);
@@ -576,6 +687,19 @@ class SpeechPlayback{
     async waitForSegment(index,generation){
         if(generation!==this.generation)return false;
         if(this.urls[index])return true;
+        if(this.providerSynthesisBatch){
+            const segmentError=this.segmentErrors.get(index);
+            if(segmentError?.providerSynthesisBatch===this.providerSynthesisBatch){
+                return false;
+            }
+            const record=this.segmentRequests.get(index);
+            if(!record)return Boolean(this.urls[index]);
+            const result=await record.promise;
+            return generation===this.generation
+                &&record.providerSynthesisBatch===this.providerSynthesisBatch
+                &&result.ready===true
+                &&Boolean(this.urls[index]);
+        }
         if(
             this.lookaheadError
             &&this.lookaheadError.generation===generation
@@ -666,13 +790,28 @@ class SpeechPlayback{
             throw error;
         }
 
-        const queue=queueFor(this.speech);
-        if(queue.busy)this.emit('synthesizing',this.message('queued',{count:normalized.length}));
         let outcome;
         try{
-            outcome=await this.synthesizeSegment(0,generation,true);
+            const providerCapacity=providerSpeechCapacity(this.speech);
+            if(providerCapacity===null){
+                const queue=queueFor(this.speech);
+                if(queue.busy)this.emit('synthesizing',this.message('queued',{count:normalized.length}));
+                outcome=await this.synthesizeSegment(0,generation,true);
+            }else{
+                const providerSynthesisBatch={capacity:providerCapacity};
+                this.providerSynthesisBatch=providerSynthesisBatch;
+                const first=startProviderSynthesis(
+                    this,
+                    providerSynthesisBatch
+                );
+                const result=await first.promise;
+                if(Object.hasOwn(result,'error'))throw result.error;
+                outcome=result.ready?{url:this.urls[0]}:SUPERSEDED;
+            }
         }catch(error){
             if(generation!==this.generation)return {ready:false,played:false};
+            for(const controller of this.abortControllers)controller.abort();
+            this.abortControllers.clear();
             this.releaseURLs();
             this.fail(error);
             throw error;
@@ -693,7 +832,9 @@ class SpeechPlayback{
         this.loadCurrent();
         this.emit('ready',this.message('ready'));
         const played=autoplay?await this.play():false;
-        if(generation===this.generation)this.startLookahead(1,generation);
+        if(generation===this.generation&&!this.providerSynthesisBatch){
+            this.startLookahead(1,generation);
+        }
         return {ready:true,played};
     }
 
@@ -723,14 +864,34 @@ class SpeechPlayback{
         if(!this.hasAudio())return false;
         this.generation+=1;
         const generation=this.generation;
-        this.lookahead=null;
-        this.lookaheadError=null;
+        if(this.providerSynthesisBatch){
+            const providerSynthesisBatch=this.providerSynthesisBatch;
+            for(const [index,segmentError] of this.segmentErrors){
+                if(
+                    segmentError?.providerSynthesisBatch
+                        ===providerSynthesisBatch
+                    &&!this.urls[index]
+                    &&!this.segmentRequests.has(index)
+                ){
+                    startProviderSegment(
+                        this,
+                        index,
+                        providerSynthesisBatch
+                    );
+                }
+            }
+        }else{
+            this.lookahead=null;
+            this.lookaheadError=null;
+        }
         this.audio.pause();
         this.index=0;
         this.loadCurrent();
         this.audio.currentTime=0;
         const played=await this.play();
-        if(generation===this.generation)this.startLookahead(1,generation);
+        if(generation===this.generation&&!this.providerSynthesisBatch){
+            this.startLookahead(1,generation);
+        }
         return played;
     }
 
@@ -772,12 +933,15 @@ class SpeechPlayback{
             const ready=await this.waitForSegment(nextIndex,generation);
             if(!ready||generation!==this.generation){
                 if(generation===this.generation&&this.state==='buffering'){
-                    const bufferedError=(
-                        this.lookaheadError
+                    const providerError=this.segmentErrors.get(nextIndex);
+                    const providerFailed=this.providerSynthesisBatch
+                        &&providerError?.providerSynthesisBatch
+                            ===this.providerSynthesisBatch;
+                    const lookaheadFailed=this.lookaheadError
                         &&this.lookaheadError.generation===generation
-                        &&this.lookaheadError.index===nextIndex
-                    )?this.lookaheadError.error:null;
-                    if(bufferedError)this.fail(bufferedError);
+                        &&this.lookaheadError.index===nextIndex;
+                    if(providerFailed)this.fail(providerError.error);
+                    else if(lookaheadFailed)this.fail(this.lookaheadError.error);
                     else this.emit('ready',this.message('ready'));
                 }
                 return false;
@@ -786,7 +950,9 @@ class SpeechPlayback{
         this.index=nextIndex;
         this.loadCurrent();
         const played=await this.play();
-        if(generation===this.generation)this.startLookahead(nextIndex+1,generation);
+        if(generation===this.generation&&!this.providerSynthesisBatch){
+            this.startLookahead(nextIndex+1,generation);
+        }
         return played;
     }
 

package/runtime/arcane/modules/ThemeBootstrap.js

@@ -1,3 +1,4 @@
+import { arcaneLogging } from 'arcane-os/logging';
 import {loadAndApplyTheme} from './ThemeManager.js';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 
@@ -43,7 +44,7 @@ function installAppearanceListener(ready){
             Promise.resolve(ready).then(function reloadTheme(result){
                 return result?.manager?.load?.();
             }).catch(function reportThemeReloadFailure(error){
-                console.warn(
+                arcaneLogging.warn(
                     '[Arcane theme] Unable to apply the changed host appearance.',
                     error
                 );
@@ -80,7 +81,7 @@ export function bootstrapArcaneTheme(options={}){
     }
 
     const ready=loadAndApplyTheme(options).catch(error=>{
-        console.warn('[Arcane theme] Unable to load the saved appearance; using the system theme.',error);
+        arcaneLogging.warn('[Arcane theme] Unable to load the saved appearance; using the system theme.',error);
         return {manager:null,state:null,error};
     });
 

package/runtime/arcane/modules/ToolCallRouter.js

@@ -1,10 +1,11 @@
+import { arcaneLogging } from 'arcane-os/logging';
 function parseArguments(value,name=''){
     let parsed=value;
     if(typeof parsed==='string'){
         try{
             parsed=JSON.parse(parsed);
         }catch(error){
-            console.warn(error);
+            arcaneLogging.warn(error);
             throw new Error(`Tool ${name} returned invalid JSON arguments.`);
         }
     }