arcane-os 0.5.14 → 0.5.15

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.5.15
+
+- Let `SpeechPlayback.prepare()` submit every complete segment immediately when
+  an `AI.fetchTTS` client advertises positive TTS execution capacity. The AI
+  provider queue retains bounded FIFO admission (four synthesis slots by
+  default), while indexed Blob URLs keep playback in exact input order even
+  when later segments finish first.
+- Preserve the serialized one-segment-lookahead path for native and custom
+  speech clients that do not advertise provider execution capacity. Pause and
+  Resume keep the same audio element; Stop aborts all owned synthesis; Replay
+  retains completed and pending provider segments while retrying only failed
+  missing segments, including failures with falsy rejection values.
+- Add basic copyable `SpeechPlayback` examples and synchronize the installed
+  reference, current release identities, generated documentation site, and
+  focused behavioral contract source for the new admission model.
+
 ## 0.5.14
 
 - Add the shared `arcane-os/logging` console owner using the existing

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.5.12` SDK contract. Applications pin one exact npm
+This checkout defines the `0.5.15` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 
@@ -35,7 +35,7 @@ Create one browser application, install its pinned SDK, and start its source
 server:
 
 ```bash
-npx arcane-os@0.5.12 new hello-speech --path ./hello-speech --target browser
+npx arcane-os@0.5.15 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -103,6 +103,31 @@ order, but playback waits for earlier segments and plays exact input order.
 Each slot owns a Worker/model session, so raising capacity trades memory for
 latency.
 
+If your app already has complete segments in an array, let the shared
+`SpeechPlayback` owner submit them as soon as they are available:
+
+```javascript
+import SpeechPlayback from 'arcane/SpeechPlayback';
+
+const audio = document.body.appendChild(document.createElement('audio'));
+audio.controls = true;
+const narration = new SpeechPlayback({audio, speech: ai});
+const speakAll = document.body.appendChild(document.createElement('button'));
+speakAll.textContent = 'Speak all segments';
+speakAll.addEventListener('click', async function speakAllSegments() {
+  await ai.setSpeechMuted(false);
+  await narration.prepare({
+    parts: ['First segment.', 'Second segment.', 'Third segment.'],
+    autoplay: true
+  });
+});
+```
+
+With browser speech's default `auto` / 4 configuration, all three complete
+segments enter the provider queue immediately, up to four synthesize at once,
+and the audio still plays first, second, third. Native or custom speech without
+advertised provider execution capacity stays serialized with one lookahead.
+
 Continue with [streaming chunks, device selection, cancellation, status, and cleanup](https://github.com/TheWizardNexus/arcane-os-sdk/blob/main/docs/reference/ai/browser-speech.md),
 the [tiny TWiN Cloud request and saved-preference migration](https://github.com/TheWizardNexus/arcane-os-sdk/blob/main/docs/reference/ai/twin-cloud.md),
 or the [maintained WASM voice-chat example](https://github.com/TheWizardNexus/arcane-os-sdk/tree/main/examples/wasm-ai-demo).
@@ -297,7 +322,7 @@ uses the same controller for automatic memory extraction.
 Create a new repository-shaped Arcane application with the exact stable SDK:
 
 ```bash
-npx arcane-os@0.5.12 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.5.15 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run dev
@@ -307,7 +332,7 @@ To enroll an existing repository, install the exact SDK and initialize only
 missing Arcane files:
 
 ```bash
-npm install --save-dev --save-exact arcane-os@0.5.12
+npm install --save-dev --save-exact arcane-os@0.5.15
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -323,7 +348,7 @@ npm exec -- arcane-os targets
 No global SDK install or standalone Arcane CLI is required. The application
 repository's exact npm dependency and lockfile own the CLI and toolchain version.
 
-Use `npx arcane-os@0.5.12` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.5.15` for the initial bootstrap because it names this npm
 package explicitly; bare `npx arcane` outside an installed project could resolve
 a different package. Both installed commands invoke the same headless toolchain.
 Project-local npm scripts use the SDK pinned by that app's `package-lock.json`,
@@ -343,7 +368,7 @@ node ./bin/arcane.mjs new local-app --path ../local-app --target portable --git
 
 # From the generated app repository
 cd ../local-app
-npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.5.12.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.5.15.tgz
 npm ci
 ```
 
@@ -352,7 +377,7 @@ same location. The lockfile retains the selected package dependency while
 Arcane uses the installed package name and version. Local directory `file:` dependencies are not
 accepted because npm may install them as links; use a packed `.tgz`. A GitHub
 runner also needs that tarball at the locked path. After publication, replace
-the local declaration with the exact `arcane-os@0.5.12` registry package and
+the local declaration with the exact `arcane-os@0.5.15` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -491,7 +516,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.5.12` exposes one browser target and five explicitly paired
+Version `0.5.15` exposes one browser target and five explicitly paired
 native development targets: a non-runnable portable directory, a
 Windows x64 unsigned-local-test EXE bundle, Linux x64 and Linux ARM64
 unsigned-local-test DEBs, and an Android development-signed APK. The

package/docs/architecture.md

@@ -279,7 +279,7 @@ paths are withheld from the native provider. The provider copies the complete
 selected release rather than accepting an unrelated source path. Verification
 is a separate explicit operation for a selected release artifact.
 
-The SDK `0.5.12` runtime requires Arcane `0.8.12` or newer. Compatibility
+The SDK `0.5.15` runtime requires Arcane `0.8.12` or newer. Compatibility
 is contractual rather than exact-version pinning: the prepared Core must meet
 the highest minimum declared by the runtime, selected app, and bundled app
 dependencies; keep each app's Arcane protocol generation; and provide every

package/docs/reference/README.md

@@ -17,7 +17,7 @@ high-level page links to the relevant deep section instead of repeating it.
 Install the SDK in your application:
 
 ```sh
-npm install --save-exact arcane-os@0.5.14
+npm install --save-exact arcane-os@0.5.15
 ```
 
 For your first AI call, follow the [TWiN Cloud quick start](ai/twin-cloud.md).
@@ -41,6 +41,7 @@ alone does not make bare module names resolve in a browser.
 | Import a shipped renderer module | [Runtime module catalog](runtime-modules.md) |
 | Use a shared entity | [Runtime entity modules](runtime-entities.md) and [exact export contracts](core/arcane-entities.md) |
 | Load a reusable HTML component | [Runtime component catalog](runtime-components.md) |
+| Submit complete speech parts immediately and play them in order | [`SpeechPlayback`](runtime-modules.md#speechplaybackjs) and the [basic browser example](ai/browser-speech.md#play-a-complete-array-with-speechplayback) |
 | Call `globalThis.Arcane` | [Arcane Core API](core/arcane-api.md) |
 | Subscribe to native events | [Arcane event reference](core/arcane-events.md) |
 | Use provider-neutral AI lifecycle, chat, speech, persistence, or document context | [Normalized AI](#normalized-ai) |
@@ -57,9 +58,9 @@ This repository contains explicitly versioned surfaces with different owners:
 
 | Surface | Source identity | Meaning |
 | --- | --- | --- |
-| SDK and CLI | `arcane-os` `0.5.14` | The Node.js toolchain, portable `arcane-os/event-manager`, `arcane-os/logging`, `arcane-os/mail`, `arcane-os/preference-store`, and `arcane-os/speech-playback` entrypoints, plus the browser-only `arcane-os/ai/browser-wasm` and `arcane-os/ai/browser-speech` entrypoints in this checkout. |
-| Browser runtime | SDK `0.5.14`, protocol `arcane/1`, `runtime/` | The SDK-canonical runtime tree. `listRuntimeFiles()`, `readRuntimeFile()`, and `loadRuntimeRelease()` derive its current inventory directly from the selected directory. |
-| Browser SDK runtime | SDK `0.5.14`, `browser-runtime/` | The browser closure for events, shared logging, Wllama, and Browser Speech mechanisms. `listSdkBrowserRuntimeFiles()`, `readSdkBrowserRuntimeFile()`, and `loadSdkBrowserRuntimeRelease()` derive its current inventory directly from the selected directory. |
+| SDK and CLI | `arcane-os` `0.5.15` | The Node.js toolchain, portable `arcane-os/event-manager`, `arcane-os/logging`, `arcane-os/mail`, `arcane-os/preference-store`, and `arcane-os/speech-playback` entrypoints, plus the browser-only `arcane-os/ai/browser-wasm` and `arcane-os/ai/browser-speech` entrypoints in this checkout. |
+| Browser runtime | SDK `0.5.15`, protocol `arcane/1`, `runtime/` | The SDK-canonical runtime tree. `listRuntimeFiles()`, `readRuntimeFile()`, and `loadRuntimeRelease()` derive its current inventory directly from the selected directory. |
+| Browser SDK runtime | SDK `0.5.15`, `browser-runtime/` | The browser closure for events, shared logging, Wllama, and Browser Speech mechanisms. `listSdkBrowserRuntimeFiles()`, `readSdkBrowserRuntimeFile()`, and `loadSdkBrowserRuntimeRelease()` derive its current inventory directly from the selected directory. |
 | Core reference snapshot | Arcane OS commit `567ad110bf57a1c2d4a3daa22ae93716cc5f4d7e`, protocol `arcane/1` | The application-facing Core contract imported into `docs/reference/core/`, with SDK-local links and package-boundary notes added explicitly. |
 
 The SDK runtime source and Core reference have different owners. A browser
@@ -74,7 +75,7 @@ and the distinction between a documentation snapshot and the selected runtime.
 
 ## Installed documentation and release identity
 
-This reference accompanies `arcane-os@0.5.14`. The installed package includes
+This reference accompanies `arcane-os@0.5.15`. The installed package includes
 the maintained `docs/` tree and `examples/wasm-ai-demo/` source alongside
 README and CHANGELOG. Open `node_modules/arcane-os/docs/reference/README.md`
 for the matching local reference. The generated website and test suites remain

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

@@ -13,7 +13,7 @@ import map resolves `arcane/AI` and `arcane/DBOPFS`. These browser modules are
 not Node inference APIs. To create an application:
 
 ```bash
-npx arcane-os@0.5.14 new hello-speech --path ./hello-speech --target browser
+npx arcane-os@0.5.15 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -180,6 +180,50 @@ Ready adjacent audio buffers use contiguous AudioContext scheduling. Browser
 audio scheduling and selected WebGPU status do not prove physical GPU kernel
 overlap or audio quality. LLM and Whisper/STT capacity remains one.
 
+## Play a complete array with `SpeechPlayback`
+
+Use this when your application already has complete segments in an array. The
+configured `ai` below is the same instance created in the quick start.
+
+```javascript
+import SpeechPlayback from 'arcane/SpeechPlayback';
+
+const audio = document.body.appendChild(document.createElement('audio'));
+audio.controls = true;
+const narration = new SpeechPlayback({audio, speech: ai});
+const speakAll = document.body.appendChild(document.createElement('button'));
+speakAll.textContent = 'Speak all segments';
+speakAll.addEventListener('click', async function speakAllSegments() {
+  await ai.setSpeechMuted(false);
+  await narration.prepare({
+    parts: [
+      'First complete segment.',
+      'Second complete segment.',
+      'Third complete segment.'
+    ],
+    autoplay: true
+  });
+});
+```
+
+`prepare()` submits all three parts immediately because this `ai` exposes
+`fetchTTS` and advertises TTS execution capacity. With the default configuration,
+the provider admits up to four synthesis requests and keeps later requests in
+its FIFO queue. Completed audio remains indexed, so playback is always first,
+second, third even if the third synthesis finishes first.
+
+This eager path is capability-driven. A native `Arcane.speech.synthesize`
+client, or a custom client without a positive advertised TTS execution capacity,
+retains serialized synthesis with one lookahead segment. `togglePause()` pauses
+and resumes the same `audio` element. `stop()` cancels all requests owned by the
+playback. `replay()` keeps completed and pending provider segments and retries
+only failed missing segments.
+
+The default `{device:'auto',maxConcurrentRequests:4}` attempts the full ONNX
+Worker/session pool on WebGPU, then recreates that pool on WASM only if WebGPU
+loading fails. Use the status example below to read `selectedDevice`; console
+node-assignment warnings alone do not identify the selected execution device.
+
 ## Queue complete passages and wait for playback
 
 These options are available in SDK `0.5.12`.

package/docs/reference/ai/twin-cloud.md

@@ -9,7 +9,7 @@ same managed browser imports as the [browser speech quick start](browser-speech.
 Create an application and start its source server:
 
 ```bash
-npx arcane-os@0.5.12 new hello-twin --path ./hello-twin --target browser
+npx arcane-os@0.5.15 new hello-twin --path ./hello-twin --target browser
 cd hello-twin
 npm install
 npm run dev

package/docs/reference/cli.md

@@ -214,7 +214,7 @@ portable runtime subpaths such as `arcane-os/preference-store` and
 modules. The result reports the complete map written to the selected
 application; no fixed entry count is a release contract.
 
-SDK `0.5.12` preserves the physical workspace route count and ordered include
+SDK `0.5.15` preserves the physical workspace route count and ordered include
 list. External and modern integrated routes require `components`, `css`,
 `dependencies`, `entities`, `img`, `modules`, and `sdk`; a physical workspace
 may omit only an optional trailing `security` include. The external license

package/docs/reference/core/arcane-ai-contracts.md

@@ -9,7 +9,7 @@ They are not TypeScript declarations.
 
 ## Portable SDK AI and Core AI
 
-The SDK `0.5.12` has two related but separate normalized boundaries:
+The SDK `0.5.15` has two related but separate normalized boundaries:
 
 | Boundary | Use | Host |
 |---|---|---|

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

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.5.14",
+  "sdkVersion": "0.5.15",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",
@@ -1392,10 +1392,10 @@
       "entrypoints": ["arcane-os/speech-playback"],
       "primaryImport": "arcane-os/speech-playback",
       "group": "Portable runtime modules",
-      "summary": "Default binding for the canonical SpeechPlayback runtime class in Node and managed browsers.",
+      "summary": "Default binding for the canonical SpeechPlayback runtime class, with capability-gated eager provider submission and exact-order playback.",
       "availability": "Node with injected media adapters, or browser/native WebView media",
       "protocol": "SpeechPlayback runtime contract",
-      "normalization": "Binding identity and namespace come directly from the canonical runtime module"
+      "normalization": "Binding identity and namespace come directly from the canonical runtime module; a fetchTTS client with positive advertised TTS execution capacity receives all complete segments immediately while its provider owns bounded admission and SpeechPlayback retains indexed order; other clients remain serialized"
     },
     {
       "id": "speech-playback:SPEECH_PLAYBACK_STATE_EVENT",
@@ -1420,10 +1420,10 @@
       "entrypoints": ["arcane-os/speech-playback"],
       "primaryImport": "arcane-os/speech-playback",
       "group": "Portable runtime modules",
-      "summary": "Named binding for the same canonical class exposed as the subpath default.",
+      "summary": "Named binding for the same capability-aware, exact-order canonical class exposed as the subpath default.",
       "availability": "Node with injected media adapters, or browser/native WebView media",
       "protocol": "SpeechPlayback runtime contract",
-      "normalization": "Binding identity equals the default export; prepare preserves each nonblank part input exactly without trimming, splitting, or freezing it; provider and media availability remain host-owned"
+      "normalization": "Binding identity equals the default export; prepare preserves each nonblank part input exactly without trimming, splitting, or freezing it; provider-advertised capacity enables eager submission while the provider owns its bound, native and custom clients remain serialized, and media availability remains host-owned"
     },
     {
       "id": "speech-playback:splitSpeechText",

package/docs/reference/inventory/runtime-components.json

@@ -5,7 +5,7 @@
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
     "branch": "main",
     "path": "runtime/arcane/components",
-    "sdkVersion": "0.5.12"
+    "sdkVersion": "0.5.15"
   },
   "componentCount": 39,
   "loader": "/arcane/modules/HTMLImport.js",

package/docs/reference/inventory/runtime-modules.json

@@ -5,7 +5,7 @@
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
     "branch": "main",
     "path": "runtime/arcane",
-    "sdkVersion": "0.5.12",
+    "sdkVersion": "0.5.15",
     "protocol": "arcane/1"
   },
   "artifactCount": 84,
@@ -1153,10 +1153,10 @@
         "default",
         "splitSpeechText"
       ],
-      "summary": "Preserves exact nonblank text as one segment without trimming, splitting, or freezing it; queues latest-request synthesis and controls lookahead HTML audio playback.",
+      "summary": "Preserves exact nonblank segment text without trimming, splitting, or freezing it; eagerly submits complete parts to a capacity-advertising fetchTTS provider while keeping playback indexed, and retains serialized one-segment lookahead for other clients.",
       "availability": "Browser + compatible AI/native bridge",
-      "protocol": "AI.fetchTTS or compatible Arcane.speech.synthesize, globalThis.arcaneEvents, Blob URLs, audio element",
-      "normalization": "Exact nonblank split/part input strings are preserved in mutable records while playback policy, cancellation, Blob results, and lifecycle state are normalized; provider failures remain external.",
+      "protocol": "AI.fetchTTS plus providerRuntime TTS execution capacity, or compatible serialized Arcane.speech.synthesize; globalThis.arcaneEvents, Blob URLs, audio element",
+      "normalization": "Exact nonblank split/part input strings are preserved in mutable records. A capable provider receives complete segments immediately and owns bounded FIFO admission; URLs and playback stay in exact input order. Native/custom clients remain serialized. Cancellation, Replay recovery, Blob results, and lifecycle state are normalized; provider failures remain external.",
       "surface": "SpeechPlayback class/default, `SPEECH_PLAYBACK_STATE_EVENT`, `splitSpeechText()`, canonical playback lifecycle events, cancellation, and destroy APIs."
     },
     {

package/docs/reference/protocols.md

@@ -159,7 +159,7 @@ imports such as:
 import ollama from 'arcane/Ollama';
 ```
 
-The physical-v1 tree lives entirely beneath `arcane/`. SDK `0.5.12` projects the
+The physical-v1 tree lives entirely beneath `arcane/`. SDK `0.5.15` projects the
 complete canonical runtime and browser runtime selected by the installed SDK
 package. Runtime dependencies stay under
 `arcane/dependencies/`; the SDK event and browser-AI closure stays under
@@ -174,7 +174,7 @@ integrated physical route uses the same ordered include list in its one route.
 Omitting only that final optional entry is compatible. Removing, reordering, or
 renaming any preceding entry changes the physical contract.
 
-The `0.5.12` map derives its complete entries from the selected runtime graph;
+The `0.5.15` map derives its complete entries from the selected runtime graph;
 application source imports do not select a fixed entry count. The operation
 result reports `imports`, `entryCount`, and `excludedModules`; reached-file
 traversal remains internal. The
@@ -239,8 +239,8 @@ exactly `dependencyName`, `packageSource`,
 `canonicalPackageRoot`, `packageName`, `packageVersion`, `runtimeRoot`,
 and `browserRuntimeRoot`. A
 workspace may use the canonical dependency name or one exact npm alias such as
-`npm:arcane-os@0.5.12`; the physical package manifest must still identify
-exactly as `arcane-os@0.5.12`. Canonical-plus-alias duplicates, multiple aliases,
+`npm:arcane-os@0.5.15`; the physical package manifest must still identify
+exactly as `arcane-os@0.5.15`. Canonical-plus-alias duplicates, multiple aliases,
 links/junctions, indirect package roots, or version drift are reported.
 
 For external workspaces, `arcane dev` serves the projected `arcane/` root,
@@ -351,7 +351,7 @@ does not silently delete the app-owned cache. A complete whole member supersedes
 its current resumable fragments. Cleanup failure is warned without hiding the
 usable model.
 
-SDK `0.5.12` requires WebGPU. Load requests full offload and waits for the runtime
+SDK `0.5.15` requires WebGPU. Load requests full offload and waits for the runtime
 to report a loaded model. `navigator.gpu` presence alone is
 not readiness. There is no CPU fallback, partial-offload success mode, or
 silent switch to native/Core/cloud inference.

package/docs/reference/runtime-modules.md

@@ -2849,8 +2849,9 @@ console.log(Object.keys(module));
 
 ### Overview
 
-Preserves exact nonblank text as one segment, queues latest-request speech
-synthesis, and controls lookahead HTML audio playback.
+Preserves exact nonblank text, admits complete speech segments according to the
+selected client's advertised capacity, and plays indexed HTML audio in exact
+input order.
 
 ### Public surface
 
@@ -2888,6 +2889,26 @@ freezing it. `prepare()` likewise preserves each nonblank part's exact `input`
 string while normalizing its other playback fields into a new mutable record.
 The class applies no part-count, character-count, pause, or input upper cap.
 
+### Admission and playback order
+
+When `speech` exposes both `fetchTTS(payload, signal)` and
+`providerRuntime.status('tts', {execution:true}).execution.maxConcurrentRequests`
+as a positive safe integer, `prepare()` submits every complete `parts` entry
+immediately. `SpeechPlayback` does not create a second limiter: the provider
+runtime owns bounded FIFO admission. Browser Kokoro defaults that capacity to
+four, so up to four segments can synthesize while later submissions wait in the
+provider queue. A later segment may finish first, but its Blob URL stays at its
+original index and is never played ahead of an earlier segment.
+
+If that capacity is absent, invalid, or unavailable, `SpeechPlayback` retains
+the compatible serialized path and prepares only one lookahead segment. This is
+the default for `Arcane.speech.synthesize` and custom clients, so native hosts
+with one synthesis lock are not driven concurrently. Pause and Resume control
+the same supplied `audio` element. Stop aborts every owned synthesis signal and
+releases prepared URLs. Replay keeps completed URLs and still-pending provider
+work, then re-submits only failed missing provider segments before starting
+again from index zero.
+
 Every preparation owns an operation ID and one AbortController for each active
 synthesis segment or playback delay. Replacement,
 `stop()`, `cancel()`, and `destroy()` abort their owned signals, suppress stale
@@ -2895,9 +2916,10 @@ settlement, release Blob URLs, and publish synchronous
 `speech-playback-state` occurrences through `globalThis.arcaneEvents`.
 Subscribers receive mutable public state detail. The detail contains
 `state`, `message`, `key`, `index`, `total`, `producing`, `buffered`, `hasAudio`,
-`operationId`, `code`, and `reason`; provider rejection remains preserved to the
-`prepare()` caller. `destroy()` also removes every audio listener and disposes
-its per-instance canonical source handle; repeated destroy returns
+`operationId`, `code`, and `reason`; a first-segment provider rejection remains
+preserved to the `prepare()` caller. Later failures surface when ordered
+playback reaches that segment. `destroy()` also removes every audio listener
+and disposes its per-instance canonical source handle; repeated destroy returns
 `false`. Signal abortion proves delivery suppression; whether provider work
 actually stops remains the selected provider's cancellation boundary.
 
@@ -2934,23 +2956,38 @@ const audio = document.body.appendChild(document.createElement('audio'));
 audio.controls = true;
 const speech = new SpeechPlayback({
   audio,
-  speech: globalThis.ai,
-  model: 'caller-selected-model',
-  voice: 'caller-selected-voice',
-  responseFormat: 'wav'
+  speech: globalThis.ai
 });
-const speakButton = document.body.appendChild(document.createElement('button'));
-speakButton.type = 'button';
-speakButton.textContent = 'Speak';
-speakButton.addEventListener('click', async () => {
+const button = document.body.appendChild(document.createElement('button'));
+button.textContent = 'Speak';
+button.addEventListener('click', async function speakCompleteSegments() {
+  await globalThis.ai.setSpeechMuted(false);
   await speech.prepare({
-    key: 'ready',
-    parts: ['Arcane is ready.'],
+    parts: [
+      'First complete segment.',
+      'Second complete segment.'
+    ],
     autoplay: true
   });
 });
 ```
 
+With the default browser speech configuration, both parts enter its capacity-4
+queue immediately and still play first, then second. Inspect the selected
+execution device without guessing from console warnings:
+
+```javascript
+const execution = globalThis.ai.providerRuntime.status(
+  'tts',
+  { execution: true }
+).execution;
+console.log(execution.selectedDevice, execution.maxConcurrentRequests);
+```
+
+`requestedDevice:'auto'` attempts the complete ONNX Worker/session pool on
+WebGPU and recreates it on WASM if WebGPU loading fails. The reported selected
+device proves provider selection, not physical GPU kernel overlap.
+
 ## StaticDocumentCatalog.js
 
 ### Overview

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.14`.
+for the installed-inventory-derived physical-runtime contract in SDK `0.5.15`.
 
 | Specifier | Purpose |
 | --- | --- |
@@ -751,7 +751,7 @@ deterministic map. The package root also contains the public
 {
   schemaVersion: 1,
   kind: 'arcane-app-runtime-projection',
-  sdkVersion: '0.5.14',
+  sdkVersion: '0.5.15',
   pathPrefix: 'arcane/',
   files: [{path}]
 }
@@ -1500,6 +1500,14 @@ specifier `arcane-os/speech-playback` works in Node package consumers and maps
 to the same runtime module in managed browsers. `arcane/SpeechPlayback` is the
 direct browser runtime name generated into the managed import map.
 
+When the supplied `speech` client has `fetchTTS` and reports a positive
+`providerRuntime.status('tts', {execution:true}).execution.maxConcurrentRequests`,
+`prepare()` submits every complete part immediately. The provider owns its
+bounded FIFO queue (browser Kokoro defaults to four), while Blob URLs and
+playback remain in exact input order. A native or custom client without that
+advertised capacity stays serialized with one lookahead. Replay keeps completed
+URLs and pending requests while retrying failed missing provider segments.
+
 ### Signature and result
 
 ```text
@@ -1516,7 +1524,18 @@ runtime module; provider and media availability remain host-owned.
 
 ```javascript
 import SpeechPlayback from 'arcane-os/speech-playback';
-const playback=new SpeechPlayback({audio,speech});
+
+const audio=document.body.appendChild(document.createElement('audio'));
+const playback=new SpeechPlayback({audio,speech:globalThis.ai});
+const button=document.body.appendChild(document.createElement('button'));
+button.textContent='Speak';
+button.addEventListener('click',async function speakCompleteSegments(){
+  await globalThis.ai.setSpeechMuted(false);
+  await playback.prepare({
+    parts:['First complete segment.','Second complete segment.'],
+    autoplay:true
+  });
+});
 ```
 
 ## SPEECH_PLAYBACK_STATE_EVENT
@@ -1546,7 +1565,9 @@ console.log(SPEECH_PLAYBACK_STATE_EVENT);
 
 ### Overview
 
-Named binding for the same canonical class exposed as the speech-playback default. `prepare()` preserves each nonblank part's exact input string without trimming, splitting, or freezing that content.
+Named binding for the same capability-aware, exact-order canonical class exposed
+as the speech-playback default. `prepare()` preserves each nonblank part's exact
+input string without trimming, splitting, or freezing that content.
 
 ### Signature and result
 
@@ -1557,7 +1578,9 @@ new SpeechPlayback(options={})
 ### Availability and normalization
 
 **Node with injected media adapters, or browser/native WebView media.** Binding
-identity equals the default export; provider and media availability remain host-owned.
+identity equals the default export. Provider-advertised capacity enables eager
+submission while that provider owns its bound; native and custom speech stays
+serialized, and media availability remains host-owned.
 
 ### Example
 
@@ -3440,7 +3463,7 @@ workspace it additionally returns the exact installed package authority:
     packageSource,
     canonicalPackageRoot,
     packageName: 'arcane-os',
-    packageVersion: '0.5.14',
+    packageVersion: '0.5.15',
     runtimeRoot,
     browserRuntimeRoot
   }
@@ -3448,9 +3471,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.14`. The selected installation must still be one direct,
+`npm:arcane-os@0.5.15`. The selected installation must still be one direct,
 physical, non-link package directory whose manifest identifies exactly as
-`arcane-os@0.5.14`; duplicate canonical/alias declarations reject.
+`arcane-os@0.5.15`; 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.14",
+  "version": "0.5.15",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -64,7 +64,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/contracts.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/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dev-server.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/packaging.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/site.test.mjs test/update-check.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/cli.test.mjs test/dbopfs-document-library.test.mjs test/dev-server.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/packaging.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.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/update-check.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.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/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/logging-regression.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/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;
     }