arcane-os 0.5.11 → 0.5.13

package/docs/reference/sdk-api.md

@@ -18,7 +18,7 @@ This table is the Node `package.json#exports` map: it defines package
 entrypoints for SDK/tooling code. It is distinct from the generated browser
 import map that resolves application-facing `arcane/*` modules and the focused
 EventManager entry. See [browser runtime delivery](protocols.md#browser-runtime-delivery)
-for the installed-inventory-derived physical-runtime contract in SDK `0.5.11`.
+for the installed-inventory-derived physical-runtime contract in SDK `0.5.12`.
 
 | Specifier | Purpose |
 | --- | --- |
@@ -748,7 +748,7 @@ deterministic map. The package root also contains the public
 {
   schemaVersion: 1,
   kind: 'arcane-app-runtime-projection',
-  sdkVersion: '0.5.11',
+  sdkVersion: '0.5.12',
   pathPrefix: 'arcane/',
   files: [{path}]
 }
@@ -2667,7 +2667,7 @@ The import-map operation also reports the stable operation-specific strings
 `ARCANE_IMPORT_MAP_INVALID`, `ARCANE_IMPORT_MAP_UNRESOLVED`, and
 `ARCANE_IMPORT_MAP_COLLISION`; package assembly can additionally report
 `ARCANE_IMPORT_MAP_CLEANUP_FAILED`. They are normalized `ArcaneError.code`
-values, but are not properties added to this general registry in SDK `0.5.11`.
+values, but are not properties added to this general registry in SDK `0.5.12`.
 
 ### Value and import
 
@@ -3437,7 +3437,7 @@ workspace it additionally returns the exact installed package authority:
     packageSource,
     canonicalPackageRoot,
     packageName: 'arcane-os',
-    packageVersion: '0.5.11',
+    packageVersion: '0.5.12',
     runtimeRoot,
     browserRuntimeRoot
   }
@@ -3445,9 +3445,9 @@ workspace it additionally returns the exact installed package authority:
 ```
 
 The dependency can be named `arcane-os` or be one exact npm alias for
-`npm:arcane-os@0.5.11`. The selected installation must still be one direct,
+`npm:arcane-os@0.5.12`. The selected installation must still be one direct,
 physical, non-link package directory whose manifest identifies exactly as
-`arcane-os@0.5.11`; duplicate canonical/alias declarations reject.
+`arcane-os@0.5.12`; duplicate canonical/alias declarations reject.
 `allowMissingManagedImportMap` is an internal packaging/development seam. An
 ordinary caller should leave it `false`.
 

package/package.json

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

package/runtime/arcane/components/calculator.html

@@ -1,7 +1,7 @@
 <link rel="stylesheet" href="./arcane/css/theme.css?v=1"><link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
 <style>:host{display:block;max-width:34rem}.calculator{display:grid;gap:var(--arcane-space-3);padding:var(--arcane-space-4)}.display{display:grid;gap:var(--arcane-space-2)}.display input{font:600 1.3rem/1.4 ui-monospace,monospace;text-align:right}.result{min-height:2.5rem;margin:0;text-align:right;font-size:1.8rem;font-weight:750;overflow-wrap:anywhere}.keys{display:grid;gap:var(--arcane-space-2);grid-template-columns:repeat(5,1fr)}.keys button{min-width:0;padding:.7rem .35rem}.status{min-height:1.4rem;margin:0;color:var(--arcane-muted)}@media(max-width:28rem){.keys{grid-template-columns:repeat(4,1fr)}}</style>
 <section class="calculator arcane-card"><div class="display arcane-field"><label for="expression">Expression</label><input id="expression" inputmode="decimal" autocomplete="off" spellcheck="false" value=""><p id="result" class="result" aria-live="polite">0</p></div><div id="keys" class="keys" aria-label="Calculator keypad"></div><p id="status" class="status" role="status"></p></section>
-<script type="module">const host=this,root=host.shadowRoot,input=root.querySelector('#expression'),result=root.querySelector('#result'),status=root.querySelector('#status'),keys=root.querySelector('#keys');const componentURL=new URL(host.getAttribute('href')||'./arcane/components/calculator.html',document.baseURI);const {default:CalculatorEngine}=await import(new URL('../modules/CalculatorEngine.js',componentURL));const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.calculator',eventTypes:['calculation-complete','calculation-error','calculator-ready']}),lifecycleController=new AbortController();const engine=new CalculatorEngine(),definitions=['7','8','9','/','sqrt(','4','5','6','*','^','1','2','3','-','%','0','.','(',')','+','pi','e','C','⌫','='];let destroyed=false,operationSequence=0;
+<script type="module">const host=this,root=host.shadowRoot,input=root.querySelector('#expression'),result=root.querySelector('#result'),status=root.querySelector('#status'),keys=root.querySelector('#keys');const {default:CalculatorEngine}=await import('../modules/CalculatorEngine.js');const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.calculator',eventTypes:['calculation-complete','calculation-error','calculator-ready']}),lifecycleController=new AbortController();const engine=new CalculatorEngine(),definitions=['7','8','9','/','sqrt(','4','5','6','*','^','1','2','3','-','%','0','.','(',')','+','pi','e','C','⌫','='];let destroyed=false,operationSequence=0;
 for(const value of definitions){const button=document.createElement('button');button.type='button';button.className=value==='='?'arcane-button':'arcane-button arcane-button--secondary';button.textContent=value;button.dataset.value=value;keys.append(button)}
 keys.addEventListener('click',event=>{const value=event.target.closest('[data-value]')?.dataset.value;if(!value)return;if(value==='C'){input.value='';result.textContent='0';status.textContent='';return}if(value==='⌫'){input.value=input.value.slice(0,-1);return}if(value==='='){calculate();return}input.value+=value;input.focus()},{signal:lifecycleController.signal});input.addEventListener('keydown',event=>{if(event.key==='Enter'){event.preventDefault();calculate()}},{signal:lifecycleController.signal});
 function nextOperationId(){operationSequence+=1;return `${events.descriptor.instanceId}:calculate:${operationSequence}`}

package/runtime/arcane/components/chart.html

@@ -162,16 +162,11 @@
 
 <script type="module">
     const host=this;
-    const componentURL=new URL(
-        host.getAttribute('href')||'./arcane/components/chart.html',
-        document.baseURI
-    );
-    const moduleURL=name=>new URL(`../modules/${name}`,componentURL).href;
-    const {default:loadChartLibrary}=await import(moduleURL('ChartLibrary.js'));
+    const {default:loadChartLibrary}=await import('../modules/ChartLibrary.js');
     const {
         normalizeChartOptions,
         normalizeChartRows
-    }=await import(moduleURL('ComponentContracts.js'));
+    }=await import('../modules/ComponentContracts.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.chart',eventTypes:['chart-remove','chart-ready']});
     const lifecycleController=new AbortController();

package/runtime/arcane/components/dashboard-config.html

@@ -11,18 +11,13 @@
 
 <script type="module">
     const host=this;
-    const componentURL=new URL(
-        host.getAttribute('href')||'./arcane/components/dashboard-config.html',
-        document.baseURI
-    );
-    const moduleURL=name=>new URL(`../modules/${name}`,componentURL).href;
-    const {default:waitForComponent}=await import(moduleURL('WaitForComponent.js'));
+    const {default:waitForComponent}=await import('../modules/WaitForComponent.js');
     const {
         effectiveDashboardVisibility,
         normalizeDashboardDefinitions,
         normalizeDashboardOptions,
         normalizeDashboardVisibility
-    }=await import(moduleURL('ComponentContracts.js'));
+    }=await import('../modules/ComponentContracts.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.dashboard-config',eventTypes:['dashboard-config-closed','dashboard-config-opened','dashboard-config-change','dashboard-config-ready']});
     const lifecycleController=new AbortController();
@@ -232,7 +227,7 @@
         const items=document.createElement('section');
 
         styles.rel='stylesheet';
-        styles.href='./arcane/css/dashboard-config.css?v=2';
+        styles.href=new URL('./arcane/css/dashboard-config.css?v=2',document.baseURI).href;
         heading.dataset.dashboardConfigHeading='';
         message.dataset.dashboardConfigDescription='';
         empty.className='dashboard-config-empty';

package/runtime/arcane/components/file-manager.html

@@ -825,8 +825,8 @@
         icon.className='tree-entry-icon';
         icon.alt='';
         icon.src=entry.kind==='directory'
-            ?'./arcane/img/folder.svg'
-            :'./arcane/img/doc.svg';
+            ?new URL('./arcane/img/folder.svg',document.baseURI).href
+            :new URL('./arcane/img/doc.svg',document.baseURI).href;
         name.className='tree-entry-name';
         name.innerText=entry.name;
         count.className='tree-file-count';
@@ -1404,7 +1404,7 @@
         deleteButton.innerText='Delete File';
         deleteIcon.alt='';
         deleteIcon.className='action-icon';
-        deleteIcon.src='./arcane/img/trash.svg';
+        deleteIcon.src=new URL('./arcane/img/trash.svg',document.baseURI).href;
         deleteButton.prepend(deleteIcon);
         deleteButton.addEventListener(
             'click',
@@ -1610,7 +1610,7 @@
 
         fileIcon.alt='';
         fileIcon.className='icon file-icon';
-        fileIcon.src='./arcane/img/doc.svg';
+        fileIcon.src=new URL('./arcane/img/doc.svg',document.baseURI).href;
         fileDetails.className='file-details';
         fileLabel.className='file-name';
         fileLabel.innerText=fileName;
@@ -1633,7 +1633,7 @@
 
         deleteIcon.alt='';
         deleteIcon.className='action-icon';
-        deleteIcon.src='./arcane/img/trash.svg';
+        deleteIcon.src=new URL('./arcane/img/trash.svg',document.baseURI).href;
 
         openButton.addEventListener(
             'click',
@@ -1933,7 +1933,7 @@
             directory.dataset.directory=tableName;
             folder.className='file folder';
             folderIcon.className='icon';
-            folderIcon.src='./arcane/img/folder.svg';
+            folderIcon.src=new URL('./arcane/img/folder.svg',document.baseURI).href;
             folderName.innerText=tableName;
             fileCount.className='file-count';
             fileCount.innerText=`${files.length} ${files.length===1?'file':'files'}`;

package/runtime/arcane/components/markdown-document.html

@@ -214,12 +214,7 @@
     const host=this;
     host.ready=false;
 
-    const componentURL=new URL(
-        host.getAttribute('href')||'./arcane/components/markdown-document.html',
-        document.baseURI
-    );
-    const moduleURL=name=>new URL(`../modules/${name}`,componentURL).href;
-    const {default:MD}=await import(moduleURL('MD.js?v=2'));
+    const {default:MD}=await import('../modules/MD.js?v=2');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.markdown-document',eventTypes:['markdown-document-state','markdown-document-empty','markdown-document-error','markdown-document-loading','markdown-document-rendered','markdown-document-navigate','markdown-document-ready']});
     const lifecycleController=new AbortController();

package/runtime/arcane/components/markdown-editor.html

@@ -75,16 +75,11 @@
 
 <script type="module">
     const host=this;
-    const componentURL=new URL(
-        host.getAttribute('href')||'./arcane/components/markdown-editor.html',
-        document.baseURI
-    );
-    const moduleURL=name=>new URL(`../modules/${name}`,componentURL).href;
-    const {default:MD}=await import(moduleURL('MD.js?v=2'));
+    const {default:MD}=await import('../modules/MD.js?v=2');
     const {
         applyMarkdownFormat,
         normalizeMarkdownOptions
-    }=await import(moduleURL('ComponentContracts.js'));
+    }=await import('../modules/ComponentContracts.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const events=createArcaneEventSource(host,{source:'arcane.component.markdown-editor',eventTypes:['markdown-editor-change','markdown-editor-saved','markdown-editor-ready']});
     const lifecycleController=new AbortController();

package/runtime/arcane/components/media-embed.html

@@ -1,7 +1,7 @@
 <link rel="stylesheet" href="./arcane/css/theme.css?v=1"><link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
 <style>:host{display:block}.player-shell{display:grid;gap:var(--arcane-space-4)}.loader{display:flex;gap:var(--arcane-space-2)}.loader input{min-width:0;width:100%}.player{aspect-ratio:16/9;display:grid;place-items:center;background:var(--arcane-surface-muted);border:1px solid var(--arcane-border);border-radius:var(--arcane-radius-large)}iframe{width:100%;height:100%;border:0}.empty{text-align:center;color:var(--arcane-muted);padding:var(--arcane-space-5)}.footer{align-items:center;display:flex;gap:var(--arcane-space-3);justify-content:space-between}.status{margin:0;color:var(--arcane-muted)}@media(max-width:36rem){.loader,.footer{align-items:stretch;flex-direction:column}}</style>
 <section class="player-shell"><form id="loader" class="loader"><label class="visually-hidden" for="mediaUrl">Video or playlist address</label><input id="mediaUrl" type="text" inputmode="url" autocomplete="off" spellcheck="false" placeholder="Paste a YouTube video or playlist URL"><button class="arcane-button" type="submit">Play</button></form><div class="player"><div id="empty" class="empty"><strong>Choose something to play</strong><p>Paste a YouTube or YouTube Music video or playlist address.</p></div><iframe id="frame" title="Embedded media player" hidden allow="autoplay; encrypted-media; picture-in-picture; fullscreen" allowfullscreen></iframe></div><div class="footer"><p id="status" class="status" role="status" aria-live="polite">Nothing loaded.</p><button id="platform" class="arcane-button arcane-button--secondary" type="button">Open platform</button></div></section>
-<script type="module">const host=this,root=host.shadowRoot,form=root.querySelector('#loader'),input=root.querySelector('#mediaUrl'),frame=root.querySelector('#frame'),empty=root.querySelector('#empty'),status=root.querySelector('#status');const componentURL=new URL(host.getAttribute('href')||'./arcane/components/media-embed.html',document.baseURI);const {parseYouTubeMedia,youtubeEmbedUrl}=await import(new URL('../modules/YouTubeMedia.js',componentURL));const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.media-embed',eventTypes:['media-open-platform','media-load','media-error','media-embed-ready']}),lifecycleController=new AbortController();let platformUrl='https://www.youtube.com/',privacyEnhanced=false,destroyed=false,operationSequence=0;
+<script type="module">const host=this,root=host.shadowRoot,form=root.querySelector('#loader'),input=root.querySelector('#mediaUrl'),frame=root.querySelector('#frame'),empty=root.querySelector('#empty'),status=root.querySelector('#status');const {parseYouTubeMedia,youtubeEmbedUrl}=await import('../modules/YouTubeMedia.js');const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.media-embed',eventTypes:['media-open-platform','media-load','media-error','media-embed-ready']}),lifecycleController=new AbortController();let platformUrl='https://www.youtube.com/',privacyEnhanced=false,destroyed=false,operationSequence=0;
 function nextOperationId(kind){operationSequence+=1;return `${events.descriptor.instanceId}:${kind}:${operationSequence}`}
 function emit(type,detail={},publicDetail={},operationId=null){if(destroyed)return false;const publication=events.dispatch(type,detail,{publicDetail,operationId});return projectArcaneDOMEvent(host,publication.occurrence,{bubbles:true,composed:true})}
 host.configure=options=>{if(destroyed)return false;platformUrl=String(options?.platformUrl||platformUrl);if(Object.hasOwn(options||{},'privacyEnhanced'))privacyEnhanced=options.privacyEnhanced===true;if(options?.placeholder)input.placeholder=String(options.placeholder);if(options?.openLabel)root.querySelector('#platform').textContent=String(options.openLabel);if(options?.initialValue){input.value=String(options.initialValue);load(input.value)}return host};host.load=load;host.destroy=destroy;

package/runtime/arcane/components/screen-capture.html

@@ -1,7 +1,7 @@
 <link rel="stylesheet" href="./arcane/css/theme.css?v=1"><link rel="stylesheet" href="./arcane/css/primitives.css?v=1">
 <style>:host{display:block}.capture{display:grid;gap:var(--arcane-space-4)}.actions{display:grid;gap:var(--arcane-space-3);grid-template-columns:repeat(3,minmax(0,1fr))}.action{display:grid;gap:var(--arcane-space-2);padding:var(--arcane-space-4);text-align:left}.action strong{font-size:1.05rem}.action span{color:var(--arcane-muted);font-size:.85rem}.recording{align-items:center;display:flex;gap:var(--arcane-space-3);justify-content:space-between;padding:var(--arcane-space-3);border:1px solid var(--arcane-border);border-radius:var(--arcane-radius-medium)}.preview{display:grid;place-items:center;min-height:16rem;overflow:auto;background:var(--arcane-surface-muted);border:1px solid var(--arcane-border);border-radius:var(--arcane-radius-large)}.preview :where(img,video){display:block}.empty{color:var(--arcane-muted);text-align:center}.status{margin:0;color:var(--arcane-muted)}@media(max-width:44rem){.actions{grid-template-columns:1fr}}</style>
 <section class="capture"><div class="actions"><button class="action arcane-card" type="button" data-capture="image"><strong>Screenshot</strong><span>Capture the selected display as PNG.</span></button><button class="action arcane-card" type="button" data-capture="video"><strong>Record video</strong><span>Record the selected display in a browser-supported video format.</span></button><button class="action arcane-card" type="button" data-capture="gif"><strong>Record GIF</strong><span>Record the selected display as an animated GIF.</span></button></div><div id="recording" class="recording" hidden><span id="recordingLabel">Recording…</span><button id="stop" class="arcane-button" type="button">Stop recording</button></div><div id="preview" class="preview"><div class="empty"><strong>No capture yet</strong><p>Your capture remains on this device unless you choose to save it.</p></div></div><p id="status" class="status" role="status" aria-live="polite">Choose a capture type. Your browser will ask which display to share.</p></section>
-<script type="module">const host=this,root=host.shadowRoot,preview=root.querySelector('#preview'),recording=root.querySelector('#recording'),status=root.querySelector('#status');const componentURL=new URL(host.getAttribute('href')||'./arcane/components/screen-capture.html',document.baseURI);const {default:ScreenCapture}=await import(new URL('../modules/ScreenCapture.js',componentURL));const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.screen-capture',eventTypes:['screen-capture-result','screen-capture-ready']});const capture=new ScreenCapture(),listeners=new AbortController();let destroyed=false,operationGeneration=0,previewUrl='';
+<script type="module">const host=this,root=host.shadowRoot,preview=root.querySelector('#preview'),recording=root.querySelector('#recording'),status=root.querySelector('#status');const {default:ScreenCapture}=await import('../modules/ScreenCapture.js');const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');const events=createArcaneEventSource(host,{source:'arcane.component.screen-capture',eventTypes:['screen-capture-result','screen-capture-ready']});const capture=new ScreenCapture(),listeners=new AbortController();let destroyed=false,operationGeneration=0,previewUrl='';
 function emit(type,detail={},publicDetail={},operationId=null){if(destroyed)return false;const publication=events.dispatch(type,detail,{operationId,publicDetail});return projectArcaneDOMEvent(host,publication.occurrence,{bubbles:true,composed:true})}
 function current(generation){return !destroyed&&generation===operationGeneration}
 function cleanupCaptureStart(originalError=null){const cleanupErrors=[];if(capture.recorder&&capture.recorder.state!=='inactive'){try{capture.recorder.stop()}catch(error){cleanupErrors.push(error)}}try{capture.stopTracks(capture.stream)}catch(error){cleanupErrors.push(error)}try{capture.reset()}catch(error){cleanupErrors.push(error)}for(const error of cleanupErrors)console.error('Error cleaning up rejected screen capture start:',error);return originalError}

package/runtime/arcane/components/voice-transcription.html

@@ -84,21 +84,16 @@
             ]
         }
     );
-    const componentURL=new URL(
-        host.getAttribute('href')||'./arcane/components/voice-transcription.html',
-        document.baseURI
-    );
-    const moduleURL=name=>new URL(`../modules/${name}`,componentURL).href;
-    const {default:MD}=await import(moduleURL('MD.js?v=2'));
+    const {default:MD}=await import('../modules/MD.js?v=2');
     const {
         appendTranscription,
         createSTTActivationController,
         normalizeVoiceOptions
-    }=await import(moduleURL('ComponentContracts.js'));
+    }=await import('../modules/ComponentContracts.js');
     const {
         requestAIRuntimeIntent,
         subscribeAIRuntimeState
-    }=await import(moduleURL('AIRuntimeState.js'));
+    }=await import('../modules/AIRuntimeState.js');
     const description=host.shadowRoot.querySelector('#description');
     const transcriptElement=host.shadowRoot.querySelector('#transcript');
     const status=host.shadowRoot.querySelector('#status');
@@ -598,7 +593,7 @@
             return options.transcribe(file,context);
         }
         if(typeof globalThis.ai?.fetchSTT!=='function'){
-            await import(moduleURL('AI.js'));
+            await import('../modules/AI.js');
         }
         if(typeof globalThis.ai?.fetchSTT!=='function'){
             const error=new Error('Speech transcription is not configured.');

package/runtime/arcane/modules/AI.js

@@ -5673,7 +5673,8 @@ class AI {
 
     streamTTS(
         text='',
-        end=false
+        end=false,
+        options={}
     ){
         if(this.muted){
             if(end){
@@ -5682,6 +5683,12 @@ class AI {
             return Promise.resolve(false);
         }
 
+        const {voice,speed,waitForPlayback=false}=options;
+        const pauseAfterMs=Number(options.pauseAfterMs??0);
+        if(!Number.isFinite(pauseAfterMs)||pauseAfterMs<0){
+            throw new RangeError('Speech pauses must be a nonnegative number of milliseconds.');
+        }
+
         this.audioMessageChunks+=String(text||'');
         const outputs=this.#extractSpeechSegments(end);
 
@@ -5702,8 +5709,13 @@ class AI {
         const generation=this.speechGeneration;
         const jobs=[];
 
-        for(const output of outputs){
-            jobs.push(this.#queueSpeechJob(output,generation));
+        for(const [index,output] of outputs.entries()){
+            jobs.push(this.#queueSpeechJob(output,generation,{
+                voice,
+                speed,
+                waitForPlayback,
+                pauseAfterMs:index===outputs.length-1?pauseAfterMs:0
+            }));
         }
 
         return Promise.all(jobs).then(
@@ -5857,7 +5869,7 @@ class AI {
         return this.#speechAbbreviations.has(token);
     }
 
-    #queueSpeechJob(text,generation){
+    #queueSpeechJob(text,generation,options={}){
         const job={
             abortController:null,
             audioBuffer:null,
@@ -5867,13 +5879,22 @@ class AI {
             scheduledStart:null,
             sourceNode:null,
             state:'queued',
-            text
+            text,
+            voice:options.voice,
+            speed:options.speed,
+            pauseAfterMs:options.pauseAfterMs??0,
+            resolvePlayback:null
         };
         const runtime=this;
+        const playback=options.waitForPlayback===true
+            ?new Promise(function captureSpeechPlaybackCompletion(resolve){
+                job.resolvePlayback=resolve;
+            })
+            :null;
 
         this.speechJobs.push(job);
 
-        return Promise.resolve().then(
+        const preparation=Promise.resolve().then(
             function synthesizeAvailableSpeech(){
                 return runtime.#prepareSpeechJob(job);
             }
@@ -5886,6 +5907,7 @@ class AI {
                 );
             }
         );
+        return playback||preparation;
     }
 
     async #prepareSpeechJob(job){
@@ -5914,16 +5936,18 @@ class AI {
     async #requestSpeechAudio(job){
         job.abortController=new AbortController();
         const selection=this.#providerRuntime.selection('tts');
-        const voice=selection?this.#providerSpeechVoice():null;
+        const voice=job.voice===undefined
+            ?(selection?this.#providerSpeechVoice():null)
+            :job.voice;
         const response=await this.fetchTTS(
             {
                 model:selection?.modelId||this.modelTTS,
                 input:job.text,
-                ...(voice?{voice}:{}),
+                ...(job.voice!==undefined||voice?{voice}:{}),
                 responseFormat:selection
                     ?this.#providerSpeechResponseFormat()
                     :this.audioFormat,
-                speed:this.voiceSpeed
+                speed:job.speed===undefined?this.voiceSpeed:job.speed
             },
             job.abortController.signal
         );
@@ -6294,6 +6318,8 @@ class AI {
         for(const job of this.speechJobs){
             job.abortController?.abort();
             job.state='cancelled';
+            job.resolvePlayback?.(false);
+            job.resolvePlayback=null;
 
             if(job.sourceNode){
                 job.sourceNode.onended=null;
@@ -6370,6 +6396,22 @@ class AI {
             if(attempt===this.speechResumeAttempt){
                 this.speechResumePending=false;
             }
+            if(context?.state==='closed'){
+                this.#clearSpeechUnlock();
+                const jobs=this.speechJobs.filter(function usesClosedSpeechContext(job){
+                    return job.audioContext===context;
+                });
+                if(!jobs.length){
+                    this.#publishTTSFailure(error,{
+                        boundary:'playback-resume',
+                        generation:this.speechGeneration
+                    });
+                }
+                for(const job of jobs){
+                    this.#failSpeechJob(job,error,'playback-resume');
+                }
+                return false;
+            }
             this.#waitForSpeechGesture(error,context);
             if(error?.name!=='NotAllowedError'){
                 this.#publishTTSFailure(error,{
@@ -6543,7 +6585,7 @@ class AI {
                     job.state='scheduled';
                     job.scheduledStart=scheduledStart;
                     job.scheduledEnd=hasKnownDuration
-                        ?scheduledStart+duration
+                        ?scheduledStart+duration+(job.pauseAfterMs??0)/1000
                         :null;
                     job.sourceNode.__arcaneStarted=true;
                     if(!this.currentSpeechJob){
@@ -6606,6 +6648,11 @@ class AI {
             job.sourceNode.onended=null;
         }
 
+        if(job.scheduledEnd===null&&job.pauseAfterMs>0){
+            this.speechScheduleContext=job.audioContext;
+            this.speechScheduleTime=
+                (Number(job.audioContext?.currentTime)||0)+job.pauseAfterMs/1000;
+        }
         job.state='complete';
         this.#removeSpeechJob(job);
 
@@ -6727,6 +6774,8 @@ class AI {
     }
 
     #removeSpeechJob(job){
+        job.resolvePlayback?.(job.state==='complete');
+        job.resolvePlayback=null;
         const jobIndex=this.speechJobs.indexOf(job);
 
         if(jobIndex>=0){