arcane-os 0.5.13 → 0.5.15

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 ## 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
+  `user.developer` preference. Route first-party runtime diagnostics and
+  default model loggers through this owner; preserve warnings and errors
+  when developer mode is disabled.
+- Trace complete speech API inputs, generation queues, Worker requests and
+  responses, decoded audio, scheduled playback, natural completion,
+  cancellation, and failure under that same developer preference. Preserve
+  caller text, voice, speed, language selection, and playback behavior.
+- Preserve complete cloud AI error responses and retry HTTP 429 overload
+  responses after three seconds with the original request and cancellation
+  signal. Keep partial streams and tool callbacks outside the retry path.
+- Preserve exact URL import-map aliases while adding matching versioned
+  aliases, including authored imports, scopes, and generated dependency paths.
+
 ## 0.5.13
 
 - Derive local browser resource queries from the selected SDK package version

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/browser-runtime/ai/browser-wasm-llm-provider.mjs

@@ -1,3 +1,4 @@
+import { arcaneLogging } from '../logging.mjs';
 import {
   ARCANE_AI_ADAPTER_PROTOCOL,
   ArcaneAIError,
@@ -1148,7 +1149,7 @@ export function createDbopfsModelStore({
     try {
       await removeMemberRangeParts(modelName, { total });
     } catch (error) {
-      globalThis.console?.warn?.(
+      arcaneLogging.warn?.(
         "Arcane could not remove superseded browser model range parts.",
         error,
       );
@@ -1163,7 +1164,7 @@ export function createDbopfsModelStore({
         total: ranges[0]?.total ?? null,
       });
     } catch (error) {
-      globalThis.console?.warn?.(
+      arcaneLogging.warn?.(
         "Arcane could not remove superseded browser model range parts.",
         error,
       );
@@ -1195,7 +1196,7 @@ export function createDbopfsModelStore({
         await removeMemberRangeParts(modelName, { total });
       }
     } catch (error) {
-      globalThis.console?.warn?.(
+      arcaneLogging.warn?.(
         "Arcane could not remove superseded browser model range parts.",
         error,
       );
@@ -2404,7 +2405,7 @@ function callbackStreamHandle({ runtime, request, signal, onSettled }) {
       Promise.resolve().then(() => this.cancel(
         "The stream consumer stopped before completion.",
       )).catch(function reportBrowserWasmStreamReturnCancellationFailure(error) {
-        console.error("Arcane browser-WASM stream early-return cancellation failed.", error);
+        arcaneLogging.error("Arcane browser-WASM stream early-return cancellation failed.", error);
       });
       return { value, done: true };
     },
@@ -2432,7 +2433,7 @@ function validatedV1StreamHandle(opened, request) {
       Promise.resolve().then(function cancelInvalidV1StreamHandle() {
         return opened.cancel("The v1 provider returned an invalid stream handle.");
       }).catch(function reportInvalidV1StreamCleanupFailure(error) {
-        console.error("Arcane invalid v1 stream cleanup failed.", error);
+        arcaneLogging.error("Arcane invalid v1 stream cleanup failed.", error);
       });
     }
     throw fail(
@@ -2447,7 +2448,7 @@ function validatedV1StreamHandle(opened, request) {
     Promise.resolve().then(function cancelRejectedV1Iterator() {
       return opened.cancel(error);
     }).catch(function reportRejectedV1IteratorCleanupFailure(cleanupError) {
-      console.error("Arcane rejected v1 stream iterator cleanup failed.", cleanupError);
+      arcaneLogging.error("Arcane rejected v1 stream iterator cleanup failed.", cleanupError);
     });
     throw error;
   }
@@ -2455,7 +2456,7 @@ function validatedV1StreamHandle(opened, request) {
     Promise.resolve().then(function cancelInvalidV1Iterator() {
       return opened.cancel("The v1 provider returned an invalid stream iterator.");
     }).catch(function reportInvalidV1IteratorCleanupFailure(error) {
-      console.error("Arcane invalid v1 stream iterator cleanup failed.", error);
+      arcaneLogging.error("Arcane invalid v1 stream iterator cleanup failed.", error);
     });
     throw fail(
       "ARCANE_AI_INVALID_PROVIDER_RESULT",
@@ -2539,13 +2540,13 @@ function validatedV1StreamHandle(opened, request) {
         Promise.resolve().then(function returnUnderlyingV1Stream() {
           return iterator.return(value);
         }).catch(function reportUnderlyingV1StreamReturnFailure(error) {
-          console.error("Arcane v1 stream iterator return failed.", error);
+          arcaneLogging.error("Arcane v1 stream iterator return failed.", error);
         });
       }
       Promise.resolve().then(function cancelReturnedV1Stream() {
         return opened.cancel("The stream consumer stopped before completion.");
       }).catch(function reportReturnedV1StreamCancellationFailure(error) {
-        console.error("Arcane v1 stream early-return cancellation failed.", error);
+        arcaneLogging.error("Arcane v1 stream early-return cancellation failed.", error);
       });
       return { value, done: true };
     },
@@ -2778,7 +2779,7 @@ export function createBrowserWasmLlmProvider({
   store,
   loadDefaults = {},
   security,
-  logger = console,
+  logger = arcaneLogging,
 } = {}) {
   const configuredModels = providerModelSources(sources);
   const modelSources = configuredModels.sources;

package/browser-runtime/ai/browser-wllama-runtime.mjs

@@ -1,3 +1,4 @@
+import { arcaneLogging } from '../logging.mjs';
 import { Wllama } from "./wllama/index.mjs";
 
 const completeValue = (value) => value;
@@ -276,7 +277,7 @@ function initialEvidence() {
  * network or browser side effects until load() is called. Runtime URLs are
  * fixed relative to this module for npm and materialized /arcane/sdk trees.
  */
-export function createPackagedWllamaRuntime({ logger = console } = {}) {
+export function createPackagedWllamaRuntime({ logger = arcaneLogging } = {}) {
   let engine = null;
   let pending = null;
   let inferenceActive = false;

package/browser-runtime/ai/model-controller.mjs

@@ -1,3 +1,4 @@
+import { arcaneLogging } from '../logging.mjs';
 import { createArcaneEventSource } from "arcane-os/event-manager";
 
 export const ARCANE_AI_ADAPTER_PROTOCOL = "arcane-ai-adapter/1";
@@ -1372,7 +1373,7 @@ export class ModelController {
           Promise.resolve().then(()=>value.cancel(
             "The provider returned an invalid stream handle.",
           )).catch(function reportInvalidModelStreamCleanupFailure(error){
-            console.error("Arcane invalid model stream cleanup failed.",error);
+            arcaneLogging.error("Arcane invalid model stream cleanup failed.",error);
           });
         }
         throw new ArcaneAIError(
@@ -1386,7 +1387,7 @@ export class ModelController {
       }catch(error){
         Promise.resolve().then(()=>value.cancel(error)).catch(
           function reportRejectedModelIteratorCleanupFailure(cleanupError){
-            console.error("Arcane rejected model stream iterator cleanup failed.",cleanupError);
+            arcaneLogging.error("Arcane rejected model stream iterator cleanup failed.",cleanupError);
           },
         );
         throw error;
@@ -1395,7 +1396,7 @@ export class ModelController {
         Promise.resolve().then(()=>value.cancel(
           "The provider returned an invalid stream iterator.",
         )).catch(function reportInvalidModelIteratorCleanupFailure(error){
-          console.error("Arcane invalid model stream iterator cleanup failed.",error);
+          arcaneLogging.error("Arcane invalid model stream iterator cleanup failed.",error);
         });
         throw new ArcaneAIError(
           "ARCANE_AI_INVALID_PROVIDER_RESULT",
@@ -1468,7 +1469,7 @@ export class ModelController {
             const value = opened ?? await openPromise;
             await value.cancel?.(reason);
           } catch (error) {
-            console.error("Arcane model provider cancellation failed.",error);
+            arcaneLogging.error("Arcane model provider cancellation failed.",error);
           }
           try {
             await result;
@@ -1491,7 +1492,7 @@ export class ModelController {
         Promise.resolve().then(()=>this.cancel(
           "The stream consumer stopped before completion.",
         )).catch(function reportModelStreamReturnCancellationFailure(error){
-          console.error("Arcane model stream early-return cancellation failed.",error);
+          arcaneLogging.error("Arcane model stream early-return cancellation failed.",error);
         });
         return { value, done: true };
       },

package/browser-runtime/ai/speech-worker-client.mjs

@@ -3,8 +3,10 @@ import {
   normalizeSpeechWorkerErrorEnvelope,
   SPEECH_WORKER_PROTOCOL,
 } from "./speech-worker-runtime.mjs";
+import { arcaneLogging } from "../logging.mjs";
 
 const completeValue = (value) => value;
+let nextSpeechWorkerClientId = 0;
 
 const PUBLIC_WORKER_OPERATIONS = new Set([
   "load",
@@ -57,6 +59,7 @@ const WORKER_CLIENTS = new WeakSet();
  * Workers remain available.
  */
 class SpeechWorkerClient {
+  #diagnosticId = ++nextSpeechWorkerClientId;
   #role;
   #createWorker;
   #worker = null;
@@ -84,6 +87,29 @@ class SpeechWorkerClient {
     });
     this.#onTermination = onTermination;
     WORKER_CLIENTS.add(this);
+    this.#trace("created", { workerUrl: workerUrl.href });
+  }
+
+  #trace(phase, detail = {}, beforeTransfer = false) {
+    if (!arcaneLogging.enabled) return;
+    let snapshot = detail;
+    if (beforeTransfer) {
+      try {
+        // Preserve complete request content before postMessage transfers it.
+        snapshot = structuredClone(detail);
+      } catch {
+        // Retain the complete original if native cloning cannot represent it.
+      }
+    }
+    arcaneLogging.debug("[Arcane speech worker]", {
+      clientId: this.#diagnosticId,
+      role: this.#role,
+      phase,
+      timestamp: new Date().toISOString(),
+      timeMs: globalThis.performance?.now?.() ?? Date.now(),
+      pendingRequests: this.#pending.size,
+      ...snapshot,
+    });
   }
 
   #listen(target, type, listener) {
@@ -103,6 +129,7 @@ class SpeechWorkerClient {
     }
     const worker = validateWorker(this.#createWorker());
     this.#worker = worker;
+    this.#trace("started");
     this.#listen(worker, "message", (event) => {
       this.#handleMessage(event.data);
     });
@@ -126,6 +153,7 @@ class SpeechWorkerClient {
   }
 
   #handleMessage(message) {
+    this.#trace("response", { message });
     if (message?.protocol !== SPEECH_WORKER_PROTOCOL) {
       void this.terminate(clientError(
         "ARCANE_AI_ADAPTER_PROTOCOL_MISMATCH",
@@ -177,7 +205,9 @@ class SpeechWorkerClient {
   }
 
   request(op, payload, { signal = null } = {}) {
+    this.#trace("request.call", { op, payload, aborted: signal?.aborted });
     if (!PUBLIC_WORKER_OPERATIONS.has(op)) {
+      this.#trace("request.rejected", { op, reason: "unknown-operation" });
       return Promise.reject(clientError(
         "ARCANE_AI_INVALID_REQUEST",
         "The speech worker operation is not part of its protocol.",
@@ -185,12 +215,16 @@ class SpeechWorkerClient {
         `${this.#role}-worker-operation-unknown`,
       ));
     }
-    if (signal?.aborted) return Promise.reject(abortError(signal, this.#role, op));
+    if (signal?.aborted) {
+      this.#trace("request.cancelled", { op, reason: signal.reason });
+      return Promise.reject(abortError(signal, this.#role, op));
+    }
     let worker;
     try {
       worker = this.#start();
       this.#transport = worker;
     } catch (error) {
+      this.#trace("request.error", { op, error });
       return Promise.reject(error);
     }
     const id = this.#nextId;
@@ -206,6 +240,7 @@ class SpeechWorkerClient {
       function onAbort() {
         const pending = client.#pending.get(id);
         if (!pending) return;
+        client.#trace("request.cancelled", { id, op, reason: signal?.reason });
         if (client.#role === "tts" && op === "use") {
           client.#pending.delete(id);
           pending.cleanup();
@@ -213,13 +248,16 @@ class SpeechWorkerClient {
           const cancelId = client.#nextId;
           client.#nextId += 1;
           try {
-            client.#transport.postMessage({
+            const cancellation = {
               protocol: SPEECH_WORKER_PROTOCOL,
               id: cancelId,
               op: "cancel",
               payload: { targetId: id },
-            });
+            };
+            client.#trace("request.dispatch", { message: cancellation }, true);
+            client.#transport.postMessage(cancellation);
           } catch (error) {
+            client.#trace("request.error", { id: cancelId, op: "cancel", error });
             const failure = clientError(
               "ARCANE_AI_WORKER_MESSAGE_ERROR",
               "Unable to cancel an operation in the speech Worker.",
@@ -251,8 +289,10 @@ class SpeechWorkerClient {
       };
       const transfers = collectSpeechTransferables(payload);
       try {
+        client.#trace("request.dispatch", { message }, true);
         client.#transport.postMessage(message, transfers);
       } catch (error) {
+        client.#trace("request.error", { id, op, error });
         client.#pending.delete(id);
         cleanup();
         const failure = clientError(
@@ -272,6 +312,7 @@ class SpeechWorkerClient {
   }
 
   async terminate(reason = null, { intentional = true } = {}) {
+    this.#trace("terminate.call", { reason, intentional });
     if (typeof intentional !== "boolean") {
       throw new TypeError("Speech Worker termination intent must be a boolean.");
     }
@@ -303,6 +344,7 @@ class SpeechWorkerClient {
       if (termination && typeof termination.then === "function") await termination;
     } finally {
       for (const pending of pendingOperations) pending.reject(terminationReason);
+      this.#trace("terminated", { reason: terminationReason, intentional });
       this.#onTermination(completeValue({ reason: terminationReason, intentional }));
     }
   }

package/browser-runtime/event-manager.mjs

@@ -1,4 +1,5 @@
 import EventPubSub from 'event-pubsub';
+import {arcaneLogging} from './logging.mjs';
 import {createDOMInstrumentation} from './dom-event-instrumentation.mjs';
 
 export {
@@ -1368,7 +1369,7 @@ function createArcaneEventAuthority(){
                 return;
             }
         }catch{}
-        try{globalThis.console?.error?.('Arcane event listener failed.',error);}
+        try{arcaneLogging.error('Arcane event listener failed.',error);}
         catch{}
     }
 

package/browser-runtime/logging.mjs

@@ -0,0 +1,58 @@
+/** Read the shared user preference; null means the user has not loaded yet. */
+export function readArcaneDeveloperMode(target=globalThis){
+    try{
+        if(target?.user?.ready!==true){
+            return null;
+        }
+
+        return target.user.developer===true;
+    }catch{
+        return false;
+    }
+}
+
+function emitArcaneLog(method,diagnostic,args){
+    try{
+        if(diagnostic&&readArcaneDeveloperMode()!==true){
+            return;
+        }
+        globalThis.console?.[method]?.(...args);
+    }catch{
+        // Console diagnostics must never change the operation being observed.
+    }
+}
+
+const loggingOwnerKey=Symbol.for('arcane.logging');
+
+/**
+ * The shared developer console owner. Diagnostic methods read user.developer
+ * for every emission and use info so they remain visible at normal console
+ * levels. Warnings, errors, and failure traces remain visible in every mode.
+ * Arguments pass through unchanged and are never retained by this owner.
+ */
+export const arcaneLogging=globalThis[loggingOwnerKey]??{
+    get enabled(){
+        return readArcaneDeveloperMode()===true;
+    },
+    log(...args){
+        emitArcaneLog('info',true,args);
+    },
+    info(...args){
+        emitArcaneLog('info',true,args);
+    },
+    debug(...args){
+        emitArcaneLog('info',true,args);
+    },
+    warn(...args){
+        emitArcaneLog('warn',false,args);
+    },
+    error(...args){
+        emitArcaneLog('error',false,args);
+    },
+    trace(...args){
+        emitArcaneLog('trace',false,args);
+    }
+};
+
+globalThis[loggingOwnerKey]=arcaneLogging;
+globalThis.arcaneLogging=arcaneLogging;

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.12
+npm install --save-exact arcane-os@0.5.15
 ```
 
 For your first AI call, follow the [TWiN Cloud quick start](ai/twin-cloud.md).
@@ -34,12 +34,14 @@ alone does not make bare module names resolve in a browser.
 | --- | --- |
 | Use the Node.js package API | [SDK JavaScript API](sdk-api.md) |
 | Publish central events, capture complete time-travel history, or observe the DOM | [EventManager and event-stack reference](event-manager.md) |
+| Inspect complete AI and speech calls using the shared developer-mode preference | [Shared logger](sdk-api.md#arcanelogging) and [speech developer diagnostics](ai/browser-speech.md#developer-diagnostics) |
 | Use the `arcane` command | [CLI reference](cli.md) |
 | Generate named browser imports or inspect the selected physical runtime | [`arcane import-map`](cli.md#arcane-import-map) and [browser runtime delivery](protocols.md#browser-runtime-delivery) |
 | Choose browser, native, cloud, or cross-host behavior | [Availability and normalization](availability-and-normalization.md) |
 | 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) |
@@ -56,9 +58,9 @@ This repository contains explicitly versioned surfaces with different owners:
 
 | Surface | Source identity | Meaning |
 | --- | --- | --- |
-| SDK and CLI | `arcane-os` `0.5.12` | The Node.js toolchain, portable `arcane-os/event-manager`, `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.12`, 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.12`, `browser-runtime/` | The browser closure for events, 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
@@ -73,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.12`. 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
@@ -122,10 +124,10 @@ Public reference entries follow the established Arcane documentation model:
 
 ## Public runtime inventory
 
-The package exposes 204 semantic JavaScript records across 16 JavaScript
+The package exposes 198 semantic JavaScript records across 17 JavaScript
 entrypoints, plus eight JSON Schemas and package metadata. Ten entrypoints are
 Node.js control-plane surfaces,
-`arcane-os/event-manager`, `arcane-os/mail`, `arcane-os/preference-store`, and
+`arcane-os/event-manager`, `arcane-os/logging`, `arcane-os/mail`, `arcane-os/preference-store`, and
 `arcane-os/speech-playback` run in Node and browsers, and
 `arcane-os/ai/browser-wasm` plus `arcane-os/ai/browser-speech` are browser-only.
 The [machine-readable package