arcane-os 0.5.14 → 0.5.16

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 ## Unreleased
 
+## 0.5.16
+
+- Add optional Markdown narration filtering before `AI.streamTTS()`
+  segmentation. Omit repeated same formatting marks across streamed chunks,
+  preserve single marks and ordinary punctuation, and clear formatting state
+  on terminal flush or cancellation. Keep plain speech, displayed and stored
+  text, language, voice, synthesis capacity, and audio scheduling unchanged.
+- Select Markdown narration in shared chat and include focused filter test
+  source without adding a parser dependency.
+
+## 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.16` 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.16 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -51,6 +51,10 @@ For a first spoken sentence, copy the application-owned
 beside `App.js`, then use this module. That one configuration file defines the
 upstream runtime, model, dtype, and voice. This module creates the application's
 DBOPFS store; the SDK creates and manages its speech providers and Workers.
+The linked automatic/WebGPU-first selection uses `fp32` because
+[Kokoro.js recommends `fp32` when using WebGPU](https://github.com/hexgrad/kokoro/tree/main/kokoro.js#usage).
+Its `selectedDevice` status reports the loaded route, not speech correctness or
+audio quality.
 
 ```javascript
 import arcaneThemeReady from 'arcane/ThemeBootstrap';
@@ -103,6 +107,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).
@@ -276,6 +305,14 @@ keeping apostrophes, commas, and hyphens that join Unicode letters or numbers
 inside the same segment.
 Mute, stop, provider transition, and cancellation still govern the whole queue.
 
+For raw Markdown narration, use
+`ai.streamTTS(text,false,{textFormat:'markdown'})`. The SDK removes repeated
+same formatting marks (`*`, `#`, `_`, backtick, `~`) before segmentation,
+including runs split across chunks. Single punctuation and ordinary repeated
+punctuation remain literal. The format lasts through `finishTTS()`; new
+streams default to exact plain text. Shared chat selects Markdown mode while
+preserving original messages for display and storage.
+
 The SDK runtime also owns `DBOPFSDocumentLibrary`,
 `DocumentLexicalSearch`, and `PersistentAIChatSession`. Document bootstrap is
 schema-driven and explicit; chat never searches a corpus unless the app wires
@@ -297,7 +334,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.16 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run dev
@@ -307,7 +344,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.16
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -323,7 +360,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.16` 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 +380,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.16.tgz
 npm ci
 ```
 
@@ -352,7 +389,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.16` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -491,7 +528,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.5.12` exposes one browser target and five explicitly paired
+Version `0.5.16` 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.16` 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.16
 ```
 
 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.16` | 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.16`, 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.16`, `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.16`. 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.16 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -37,7 +37,7 @@ export const speechSelection = {
     id: 'onnx-community/Kokoro-82M-v1.0-ONNX',
     repository: 'onnx-community/Kokoro-82M-v1.0-ONNX',
     revision: '1939ad2a8e416c0acfeecc08a694d14ef25f2231',
-    dtype: 'q8',
+    dtype: 'fp32',
     defaultVoice: 'af_heart'
   },
   runtime: {
@@ -55,6 +55,15 @@ export const speechSelection = {
 };
 ```
 
+The omitted execution record below uses the SDK's WebGPU-first automatic
+selection, so this basic configuration uses `fp32` because
+[Kokoro.js recommends `fp32` when using WebGPU](https://github.com/hexgrad/kokoro/tree/main/kokoro.js#usage).
+Automatic fallback carries this same selected model and dtype to WASM; the SDK
+does not rewrite the application selection. If you intentionally choose
+another dtype, evaluate that exact model, browser, and execution route.
+`selectedDevice` reports routing after load, not pronunciation, text fidelity,
+or audio quality.
+
 Then use this **`App.js`**. The application creates and owns the DBOPFS
 instance. Configuration selects the provider without loading it; the button
 explicitly loads and unmutes TTS before requesting speech.
@@ -180,6 +189,52 @@ 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. The basic configuration above keeps `fp32` for this WebGPU-first
+path and any automatic WASM fallback. Use the status example below to read
+`selectedDevice`; console node-assignment warnings alone do not identify the
+selected execution device or assess the generated audio.
+
 ## Queue complete passages and wait for playback
 
 These options are available in SDK `0.5.12`.
@@ -231,8 +286,9 @@ all speech owned by that AI instance and settles pending playback results
 The selected voice and speed are captured for segments extracted by that call.
 That includes any text left in the same AI instance's partial-stream buffer;
 finish the previous producer before starting a separate complete passage.
-Options are not retained with an unfinished `end:false` remainder. A later
-call supplies its own options, and `finishTTS()` uses defaults.
+Voice, speed, pause, and playback options are not retained with an unfinished
+`end:false` remainder. A later call supplies its own options, and `finishTTS()`
+uses their defaults. The optional text format below lasts through that flush.
 A call extracting no segments returns `true` without waiting for earlier jobs.
 An already muted call returns `false`.
 
@@ -293,6 +349,30 @@ boundary; `finishTTS()` flushes any remaining text. It is not a playback-ended
 notification. Do not mute or dispose immediately after it if playback should
 continue.
 
+## Omit Markdown formatting marks from narration
+
+Select `textFormat:'markdown'` for raw model text that contains formatting:
+
+```javascript
+ai.streamTTS('## Heading\n**Hello', false, {textFormat:'markdown'});
+ai.streamTTS('**. Next sentence.');
+await ai.finishTTS();
+```
+
+The SDK omits runs of two or more of the same `*`, `#`, `_`, backtick, or `~`
+before speech segmentation. A candidate run split across chunks is still
+recognized. Single marks, ellipses, quoted endings, and all other text are
+preserved. This is a small narration filter, not a full Markdown parser.
+Ordinary prose is forwarded immediately; only a trailing formatting candidate
+waits for its next character or the final flush.
+
+The format stays active until `end:true`, `finishTTS()`, or cancellation. New
+streams default to `plain`, which preserves exact submitted text. The shared
+chat component selects Markdown mode automatically. Applications already
+speaking visible DOM text can keep plain mode. Displayed messages, saved
+history, model input, language, voice, synthesis capacity, and playback timing
+are not changed by the filter.
+
 ## Choose a device or reduce memory use
 
 Omitting `tts.execution` selects `{device:'auto',maxConcurrentRequests:4}`.
@@ -357,6 +437,8 @@ until a pool is selected and returns to `null` on unload. Providers without an
 execution report omit `execution`; do not infer a device from `navigator.gpu`
 or a configured preference alone. An explicit inspection can throw a provider
 status error; handle it with the same `error.code` / `error.message` pattern.
+Treat `selectedDevice` as route status only; evaluate actual speech output for
+the model, dtype, browser, and device combinations your application supports.
 
 ## Stop, mute, cancel, and release
 
@@ -831,7 +913,8 @@ cache state, and warnings. Kokoro status also includes an `execution` record
 with requested and selected device, request limit, and active request count. A
 successful `selectedDevice:'webgpu'` reports the execution provider selected by
 the upstream model load; it does not claim that browser, driver, or GPU kernels
-overlap physically. A security field is absent in ordinary mode.
+overlap physically or that generated audio has been quality-validated. A
+security field is absent in ordinary mode.
 
 The provider/2 load context accepts an optional progress callback for interface
 compatibility, but the current browser-speech artifact and Worker transport

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.16 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.16` 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.16` 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.16",
   "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.16"
   },
   "componentCount": 39,
   "loader": "/arcane/modules/HTMLImport.js",

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

@@ -5,12 +5,12 @@
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
     "branch": "main",
     "path": "runtime/arcane",
-    "sdkVersion": "0.5.12",
+    "sdkVersion": "0.5.16",
     "protocol": "arcane/1"
   },
-  "artifactCount": 84,
-  "javascriptArtifactCount": 82,
-  "esmExportCount": 353,
+  "artifactCount": 85,
+  "javascriptArtifactCount": 83,
+  "esmExportCount": 354,
   "artifacts": [
     {
       "file": "runtime/arcane/modules/AI.js",
@@ -30,7 +30,7 @@
       "availability": "Browser + native bridge + TWiN Cloud",
       "protocol": "arcane-ai-browser-speech-configuration/1, AIProviderRuntime arcane-ai-provider/2 routes, globalThis.arcaneEvents, TWiN Cloud HTTPS, Arcane.ollama, Arcane.speech, Android WebView bridge",
       "normalization": "Complete mutable caller-owned browser speech authority, SDK-owned provider registration/replacement/disposal, explicit STT/TTS activation, normalized Kokoro TTS execution with default capacity 4, explicit provider-neutral execution snapshots through status(role,{execution:true}), sticky readiness, canonical window.user readiness without compatibility-event object-identity admission or polling, exact ordered structural calls with required arguments.message, atomic nonblank all-ID tool-result sequencing, complete all-choice streaming/data validation, native Ollama structural adaptation, complete-response then all validated tool callbacks then completion ordering, observed async callbacks, Blob/File transcription, immediate exact-segment synthesis, per-call voice/speed capture, optional final-segment pause on the existing audio clock, optional per-call terminal playback completion, ordered audio-clock scheduling, playable audio, active-generation TTS operation-failure routing, mute, and cancellation are normalized; provider/model/runtime/voice policy remains caller-owned.",
-      "surface": "Browser-speech protocol/event/error/reason constants; default `AI`; read-only `providerRuntime`, `browserSpeechConfiguration`, and `browserSpeechDescriptor`; explicit `providerRuntime.status(role,{execution:true})` snapshots; `streamTTS(text,end,options={})` with optional voice, speed, pauseAfterMs, and waitForPlayback (available in SDK 0.5.12); configure/dispose speech, route lifecycle, declaration-validated chat/stream requests with exact ordered calls, synthesis/transcription, and playback controls; initializes from current canonical user readiness, installs `window.ai`, and projects `ai-ready` plus active-generation `ai-tts-failure`."
+      "surface": "Browser-speech protocol/event/error/reason constants; default `AI`; read-only `providerRuntime`, `browserSpeechConfiguration`, and `browserSpeechDescriptor`; explicit `providerRuntime.status(role,{execution:true})` snapshots; `streamTTS(text,end,options={})` with optional voice, speed, pauseAfterMs, waitForPlayback, and speech-only textFormat plain/markdown; configure/dispose speech, route lifecycle, declaration-validated chat/stream requests with exact ordered calls, synthesis/transcription, and playback controls; initializes from current canonical user readiness, installs `window.ai`, and projects `ai-ready` plus active-generation `ai-tts-failure`."
     },
     {
       "file": "runtime/arcane/modules/AIPreferenceRuntime.js",
@@ -824,6 +824,19 @@
       "normalization": "Endpoint, timeout, cancellation, network, HTTP, and response-contract errors are normalized.",
       "surface": "`MailTransportError`, `normalizeMailEndpoint()`, `serializeMailReport()`, and `sendMailReport()`."
     },
+    {
+      "file": "runtime/arcane/modules/MarkdownSpeech.js",
+      "name": "MarkdownSpeech.js",
+      "kind": "esm",
+      "exports": [
+        "MarkdownSpeech"
+      ],
+      "summary": "Removes repeated same Markdown formatting marks from streamed narration before speech segmentation.",
+      "availability": "Cross-host",
+      "protocol": "In-process only",
+      "normalization": "Speech-only filtering of repeated *, #, _, backtick, and ~ runs across chunks; single marks and all other characters remain literal; terminal flush and reset clear pending formatting state.",
+      "surface": "`MarkdownSpeech`; `append(text='',end=false)`, `reset()`."
+    },
     {
       "file": "runtime/arcane/modules/Marked.min.js",
       "name": "Marked.min.js",
@@ -1153,10 +1166,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.16` 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.16` 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.16`; the physical package manifest must still identify
+exactly as `arcane-os@0.5.16`. 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.16` 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-components.md

@@ -360,17 +360,20 @@ unload.
 Chat listens for the bound (or current global) AI runtime's `ai-tts-failure`
 event and forwards its complete Error and exact operation boundary to
 `speech.reportTTSError()`. Playback-start or playback-resume failures can occur
-after Chat's two-argument `streamTTS()` preparation promise has resolved.
+after Chat's `streamTTS()` preparation promise has resolved.
 SDK `0.5.12` adds a `waitForPlayback:true` mode for the
 terminal result of the segments submitted by one invocation; Chat continues
 to feed chunks without waiting for playback. Runtime mute, cancellation,
 permission waiting, and stale generations remain non-errors.
 
-Each visible model chunk is still forwarded to `AI.streamTTS()` in arrival
-order. The AI owner preserves exact segmentation, admits completed segments to
-bounded synthesis immediately, and schedules the contiguous ready audio prefix
-on the audio clock. Chat neither creates a second queue nor reorders, combines,
-or rewrites speech text.
+Each visible model chunk is forwarded to
+`AI.streamTTS(text,false,{textFormat:'markdown'})` in arrival order. The AI
+owner removes repeated Markdown formatting marks from narration before the
+configured segmentation, admits completed segments to bounded synthesis
+immediately, and schedules the contiguous ready audio prefix on the audio
+clock. Chat retains the original Markdown for display and storage and owns no
+second speech queue. Single punctuation, ordinary repeated punctuation,
+language, and voice retain their existing behavior.
 
 Events: `chat-ready`, `chat-session-bound`, `chat-session-message`,
 `chat-session-error`, `chat-send-message`, `chat-send-error`,