arcane-os 0.5.16 → 0.5.18

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 ## Unreleased
 
+- Use `strong-type` predicates throughout SDK-owned toolchain, runtime,
+  browser-provider, and component code while retaining existing defaults,
+  domain rules, public errors, and nominal constructor behavior. Align the
+  direct dependency and both shipped projections at `strong-type` 2.0.1,
+  replacing the portable runtime's 1.1.0 snapshot and avoiding Error allocation
+  for ordinary false predicates. Keep managed browser imports and Node reference
+  loading on the same declared dependency.
+- Remove `AIResponseLength` exports; applications own response verbosity.
+  Parse URL-audit HTML with the native HTML parser.
+
+## 0.5.18
+
+- Add `AI.prepareTTS()` for detached punctuation-segmented synthesis, optional
+  DBOPFS audio storage, complete semantic-input reuse, shared pending work and
+  independent preparation cancellation. Persist MIME metadata with each audio
+  segment and retain successful segments after interruption or partial failure.
+- Add `AI.playPreparedTTS()` to replay prepared or pending audio through the
+  existing audio-clock scheduler. Playback has its own completion, pause,
+  resume, stop, state and error surface; stopping playback keeps detached
+  preparation alive. Cached audio plays without loading a speech model.
+- Keep Markdown cleanup at its shared owner, preserve the existing TTS APIs,
+  and share provider capacity across preparation requests. Applications own
+  content grouping, storage keys, preparation order and retention policy.
+
+## 0.5.17
+
+- Restore the public `SPEECH_VOICE_OPTIONS` ordered records and
+  `SPEECH_VOICE_ALIASES` membership set used by existing speech controls. Both
+  remain ordinary mutable compatibility values, and `SpeechPlayback` does not
+  select a voice from them automatically.
+- Restore the optional `SpeechPlayback` constructor `onState(detail)` callback.
+  Canonical state dispatch remains first; callback failures are reported
+  without replacing playback settlement. Preserve capability-gated eager
+  submission, the provider-owned default capacity of four, indexed playback
+  order, native/custom serialization, cancellation, and Replay behavior.
+- Apply the shared repeated-formatting-mark cleanup automatically to every TTS
+  entry path, including direct fetch, provider-runtime synthesis, browser
+  Kokoro requests, streaming chunks, and `SpeechPlayback`. Export the shared
+  `MarkdownSpeech` and `stripSpeechFormatting()` owner from
+  `arcane-os/speech-text`; keep original caller records unchanged and use
+  operation-local SDK metadata to prevent a second cleanup pass. No application
+  option is required, and the prior `textFormat` extra no longer disables or
+  selects cleanup.
+
 ## 0.5.16
 
 - Add optional Markdown narration filtering before `AI.streamTTS()`

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.16` SDK contract. Applications pin one exact npm
+This checkout defines the `0.5.18` 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.16 new hello-speech --path ./hello-speech --target browser
+npx arcane-os@0.5.18 new hello-speech --path ./hello-speech --target browser
 cd hello-speech
 npm install
 npm run dev
@@ -115,7 +115,13 @@ import SpeechPlayback from 'arcane/SpeechPlayback';
 
 const audio = document.body.appendChild(document.createElement('audio'));
 audio.controls = true;
-const narration = new SpeechPlayback({audio, speech: ai});
+const narration = new SpeechPlayback({
+  audio,
+  speech: ai,
+  onState(detail) {
+    console.log('Speech state:', detail.state);
+  }
+});
 const speakAll = document.body.appendChild(document.createElement('button'));
 speakAll.textContent = 'Speak all segments';
 speakAll.addEventListener('click', async function speakAllSegments() {
@@ -132,6 +138,20 @@ 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.
 
+Existing speech controls can also import the shared compatibility catalogs.
+They list the ten existing value/label choices but do not choose a voice for
+the application or prove that a selected provider supports one:
+
+```javascript
+import {
+  SPEECH_VOICE_ALIASES,
+  SPEECH_VOICE_OPTIONS
+} from 'arcane/SpeechPlayback';
+
+console.log(SPEECH_VOICE_OPTIONS[0]); // {value: 'alloy', label: 'Alloy'}
+console.log(SPEECH_VOICE_ALIASES.has('alloy')); // true
+```
+
 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).
@@ -290,13 +310,14 @@ TTS stream without taking over synthesis or playback:
 ```js
 ai.configureTTSSegmentation({
     punctuation:'any',
-    wordCadence:4
+    wordCadence:null
 });
 ```
 
 The compatibility default remains sentence punctuation with no word cadence.
-The configured stream preserves every character and punctuation mark, chooses
-the earliest complete boundary, begins synthesis as each segment becomes
+Within the already prepared speech text, the configured segmentation preserves
+every character and punctuation mark, chooses the earliest complete boundary,
+begins synthesis as each segment becomes
 available, and plays the completed audio in exact segment order. Ready adjacent
 buffers are scheduled consecutively on the browser audio clock rather than
 waiting for an `ended` callback before the next start.
@@ -305,13 +326,15 @@ 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.
+Every TTS call automatically removes repeated same formatting marks (`*`, `#`,
+`_`, backtick, `~`) from its outbound speech-input copy before synthesis.
+Streaming calls also recognize a run split across chunks. Single marks and
+ordinary repeated punctuation remain literal. No application option is needed;
+an existing `textFormat` extra is ignored and cannot disable cleanup. Original
+messages and caller payloads remain unchanged for display, storage, and model
+input. The `arcane-os/speech-text` entrypoint exports the same
+`MarkdownSpeech` streaming class and `stripSpeechFormatting()` one-pass helper
+for code that needs the speech-only transformation directly.
 
 The SDK runtime also owns `DBOPFSDocumentLibrary`,
 `DocumentLexicalSearch`, and `PersistentAIChatSession`. Document bootstrap is
@@ -334,7 +357,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.16 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.5.18 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run dev
@@ -344,7 +367,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.16
+npm install --save-dev --save-exact arcane-os@0.5.18
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -360,7 +383,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.16` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.5.18` 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`,
@@ -380,7 +403,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.16.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.5.18.tgz
 npm ci
 ```
 
@@ -389,7 +412,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.16` registry package and
+the local declaration with the exact `arcane-os@0.5.18` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -528,7 +551,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.5.16` exposes one browser target and five explicitly paired
+Version `0.5.18` 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/bin/arcane-test.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import Is from 'strong-type';
 import {spawn} from 'node:child_process';
 import {lstat,readdir,realpath} from 'node:fs/promises';
 import {register} from 'node:module';
@@ -6,6 +7,8 @@ import path from 'node:path';
 import {fileURLToPath,pathToFileURL} from 'node:url';
 import test,{DEFAULT_TEST_TIMEOUT_MS,runRegisteredTests} from '../src/testing.mjs';
 
+const is = new Is(false);
+
 const SINGLE_FILE_ARGUMENT='--arcane-single-test-file';
 const RUNNER_PATH=fileURLToPath(import.meta.url);
 const TEST_FILE_PATTERN=/\.test\.(?:mjs|cjs|js)$/u;
@@ -27,7 +30,7 @@ const COORDINATOR_MANAGED_IMPORT_MAP=!ISOLATED_MODE
     &&MANAGED_IMPORT_MAP_SOURCE!==''
     ?MANAGED_IMPORT_MAP_SOURCE
     :undefined;
-const ISOLATED_SEND=ISOLATED_MODE&&typeof process.send==='function'
+const ISOLATED_SEND=ISOLATED_MODE&&is.function(process.send)
     ?process.send.bind(process)
     :null;
 delete process.env[MANAGED_IMPORT_MAP_ENV];
@@ -55,12 +58,12 @@ async function readManagedImportMapContext(source,signal,testFile){
     let context;
     try{context=JSON.parse(source);}
     catch(error){importMapFailure(`Managed import-map context is not valid JSON: ${error.message}`);}
-    if(context===null||typeof context!=='object'||Array.isArray(context)
+    if(context===null||!is.object(context)||is.array(context)
         ||context.protocol!==MANAGED_IMPORT_MAP_PROTOCOL
         ||!APPLICATION_MAP_BOUNDARIES.has(context.boundary)
-        ||typeof context.baseURL!=='string'
-        ||context.imports===null||typeof context.imports!=='object'
-        ||Array.isArray(context.imports)){
+        ||!is.string(context.baseURL)
+        ||context.imports===null||!is.object(context.imports)
+        ||is.array(context.imports)){
         importMapFailure('Managed import-map context is malformed.');
     }
     let suppliedBase;
@@ -281,8 +284,8 @@ function parseTaskkillTargets(output,leaderPid){
         const target=Number(matches[0][1]);
         const parent=matches.length===2?Number(matches[1][1]):null;
         if(
-            !Number.isSafeInteger(target)||target<=0
-            ||(parent!==null&&(!Number.isSafeInteger(parent)||parent<=0))
+            !is.safeInteger(target)||target<=0
+            ||(parent!==null&&(!is.safeInteger(parent)||parent<=0))
             ||/\d/u.test(line.replaceAll(/\bPID\s+\d+\b/giu,'PID'))
         )return null;
         entries.push({target,parent});
@@ -592,21 +595,21 @@ function runIsolatedFile(file,signal){
         const onMessage=message=>{
             if(
                 message?.protocol!==IPC_PROTOCOL
-                ||typeof message.type!=='string'
+                ||!is.string(message.type)
             )return;
             if(message.type==='phase'){
                 if(
                     completion!==null
                     ||watchdogFailure!==null
-                    ||typeof message.id!=='string'
+                    ||!is.string(message.id)
                     ||message.id===''
                 )return;
                 if(message.status==='started'){
                     if(
-                        typeof message.kind!=='string'
-                        ||typeof message.name!=='string'
+                        !is.string(message.kind)
+                        ||!is.string(message.name)
                         ||(message.timeoutMs!==null&&(
-                            !Number.isSafeInteger(message.timeoutMs)
+                            !is.safeInteger(message.timeoutMs)
                             ||message.timeoutMs<1
                             ||message.timeoutMs>3_600_000
                         ))
@@ -796,7 +799,7 @@ async function main(){
             ||message?.type!=='abort'
         )return;
         const error=new Error(
-            typeof message.reason==='string'?message.reason:'The coordinator cancelled the test file.'
+            is.string(message.reason)?message.reason:'The coordinator cancelled the test file.'
         );
         error.code='ARCANE_TEST_CANCELLED';
         controller.abort(error);

package/browser-runtime/ai/browser-speech-artifacts.mjs

@@ -1,7 +1,10 @@
+import Is from "../dependencies/strong-type/index.js";
 import {
   normalizeModelSecurity,
 } from "./model-controller.mjs";
 
+const is = new Is(false);
+
 const completeValue = (value) => value;
 
 export const BROWSER_SPEECH_ARTIFACT_PROTOCOL =
@@ -20,10 +23,10 @@ const ARTIFACT_GRAPHS = new WeakSet();
 const ARTIFACT_GRAPH_METADATA = new WeakMap();
 const ARTIFACT_ERRORS = new WeakSet();
 const STORES = new WeakSet();
-const PLATFORM_CREATE_OBJECT_URL = typeof globalThis.URL?.createObjectURL === "function"
+const PLATFORM_CREATE_OBJECT_URL = is.function(globalThis.URL?.createObjectURL)
   ? globalThis.URL.createObjectURL.bind(globalThis.URL)
   : null;
-const PLATFORM_REVOKE_OBJECT_URL = typeof globalThis.URL?.revokeObjectURL === "function"
+const PLATFORM_REVOKE_OBJECT_URL = is.function(globalThis.URL?.revokeObjectURL)
   ? globalThis.URL.revokeObjectURL.bind(globalThis.URL)
   : null;
 const ARTIFACT_ERROR_REASONS = completeValue({
@@ -70,7 +73,7 @@ function speechError(code, message, cause, reason = ARTIFACT_ERROR_REASONS[code]
     : new Error(message, { cause });
   error.name = "ArcaneBrowserSpeechError";
   error.code = code;
-  if (typeof reason === "string" && reason) error.reason = reason;
+  if (is.string(reason) && reason) error.reason = reason;
   ARTIFACT_ERRORS.add(error);
   return error;
 }
@@ -104,7 +107,7 @@ function throwIfAborted(signal) {
 }
 
 function requiredText(value, label) {
-  if (typeof value !== "string" || !value.trim()) {
+  if (!is.string(value) || !value.trim()) {
     throw new TypeError(`${label} must be a nonempty string.`);
   }
   return value.trim();
@@ -115,7 +118,7 @@ function identifier(value, label) {
 }
 
 function artifactGraphText(value, label, reason = "artifact-graph-field-text-required") {
-  if (typeof value !== "string" || !value.trim()) {
+  if (!is.string(value) || !value.trim()) {
     throw artifactGraphTypeError(reason, `${label} must be a nonempty string.`);
   }
   return value.trim();
@@ -176,7 +179,7 @@ function graphPositiveInteger(
   label,
   reason = "artifact-graph-positive-safe-integer-required",
 ) {
-  if (!Number.isSafeInteger(value) || value < 1) {
+  if (!is.safeInteger(value) || value < 1) {
     throw artifactGraphTypeError(
       reason,
       `${label} must be a positive safe integer.`,
@@ -272,7 +275,7 @@ function lexicalCompare(left, right) {
 }
 
 function normalizeFile(value, kind, index) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
+  if (!value || !is.object(value) || is.array(value)) {
     throw new TypeError(`${kind} file ${String(index)} must be an object.`);
   }
   const path = requiredText(value.path ?? value.name, `${kind} file path`);
@@ -289,7 +292,7 @@ function normalizeFile(value, kind, index) {
     index,
     path,
     url,
-    mediaType: typeof value.mediaType === "string" && value.mediaType.trim()
+    mediaType: is.string(value.mediaType) && value.mediaType.trim()
       ? value.mediaType.trim()
       : kind === "runtime" && /\.(?:m?js)$/iu.test(path)
         ? "text/javascript"
@@ -300,7 +303,7 @@ function normalizeFile(value, kind, index) {
 function uniqueFiles(files, label, kind, {
   allowEmpty = false,
 } = {}) {
-  if (!Array.isArray(files) || (!allowEmpty && files.length < 1)) {
+  if (!is.array(files) || (!allowEmpty && files.length < 1)) {
     throw new TypeError(
       allowEmpty
         ? `${label} files must be an array.`
@@ -330,7 +333,7 @@ function publicFile(file) {
 }
 
 function normalizeArtifactGraphFile(value, index) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
+  if (!value || !is.object(value) || is.array(value)) {
     throw artifactGraphTypeError(
       "artifact-graph-file-descriptor-not-object",
       `Artifact graph file ${String(index)} must be an object.`,
@@ -398,7 +401,7 @@ function normalizeArtifactGraphFile(value, index) {
     );
   }
   const requestUrls = value.runtimeRequestUrls ?? [];
-  if (!Array.isArray(requestUrls)) {
+  if (!is.array(requestUrls)) {
     throw artifactGraphTypeError(
       "artifact-graph-runtime-request-routes-not-array",
       `Artifact graph file ${path} runtimeRequestUrls must be an array.`,
@@ -461,14 +464,14 @@ function normalizeGraphTargetPath(value, label, filesByPath, javascript = false)
 }
 
 function normalizeArtifactGraphVoices(value, defaultVoice, filesByPath) {
-  if (!Array.isArray(value) || value.length < 1) {
+  if (!is.array(value) || value.length < 1) {
     throw artifactGraphTypeError(
       "artifact-graph-voice-inventory-missing",
       "A TTS artifact graph requires a nonempty voices array.",
     );
   }
   const voices = value.map((voice, index) => {
-    if (!voice || typeof voice !== "object" || Array.isArray(voice)) {
+    if (!voice || !is.object(voice) || is.array(voice)) {
       throw artifactGraphTypeError(
         "artifact-graph-voice-descriptor-not-object",
         `Artifact graph voice ${String(index)} must be an object.`,
@@ -567,19 +570,19 @@ export function createBrowserSpeechArtifactGraph({
       "artifact-graph-provider-id-missing",
       "artifact-graph-provider-id-length-exceeded",
     );
-  if (!model || typeof model !== "object" || Array.isArray(model)) {
+  if (!model || !is.object(model) || is.array(model)) {
     throw artifactGraphTypeError(
       "artifact-graph-model-descriptor-missing",
       "Browser speech artifact graph model descriptor is required.",
     );
   }
-  if (!runtime || typeof runtime !== "object" || Array.isArray(runtime)) {
+  if (!runtime || !is.object(runtime) || is.array(runtime)) {
     throw artifactGraphTypeError(
       "artifact-graph-runtime-descriptor-missing",
       "Browser speech artifact graph runtime descriptor is required.",
     );
   }
-  if (!Array.isArray(files) || files.length < 1) {
+  if (!is.array(files) || files.length < 1) {
     throw artifactGraphTypeError(
       "artifact-graph-file-inventory-missing",
       "Browser speech artifact graph requires a nonempty files array.",
@@ -677,7 +680,7 @@ export function createBrowserSpeechArtifactGraph({
     );
   }
   const onnxWasm = runtime.onnxWasm;
-  if (!onnxWasm || typeof onnxWasm !== "object" || Array.isArray(onnxWasm)) {
+  if (!onnxWasm || !is.object(onnxWasm) || is.array(onnxWasm)) {
     throw artifactGraphTypeError(
       "artifact-graph-onnx-wasm-descriptor-missing",
       "Browser speech artifact graph runtime onnxWasm descriptor is required.",
@@ -880,10 +883,10 @@ export function createBrowserSpeechAuthority({
   if (role !== "stt" && role !== "tts") {
     throw new TypeError('Browser speech role must be "stt" or "tts".');
   }
-  if (!model || typeof model !== "object" || Array.isArray(model)) {
+  if (!model || !is.object(model) || is.array(model)) {
     throw new TypeError("Browser speech model descriptor is required.");
   }
-  if (!runtime || typeof runtime !== "object" || Array.isArray(runtime)) {
+  if (!runtime || !is.object(runtime) || is.array(runtime)) {
     throw new TypeError("Browser speech runtime descriptor is required.");
   }
   const normalizedSecurity = normalizeModelSecurity(
@@ -1084,14 +1087,14 @@ function storageNames(authority, files) {
 }
 
 async function* byteChunks(body, signal) {
-  if (body instanceof Uint8Array || body instanceof ArrayBuffer || ArrayBuffer.isView(body)) {
+  if (is.instanceCheck(body, Uint8Array) || is.instanceCheck(body, ArrayBuffer) || is.arrayBufferView(body)) {
     throwIfAborted(signal);
-    yield body instanceof Uint8Array
+    yield is.instanceCheck(body, Uint8Array)
       ? body
       : new Uint8Array(body.buffer ?? body, body.byteOffset ?? 0, body.byteLength);
     return;
   }
-  if (body && typeof body.getReader === "function") {
+  if (body && is.function(body.getReader)) {
     const reader = body.getReader();
     const abort = () => void reader.cancel(signal?.reason).catch(() => undefined);
     signal?.addEventListener?.("abort", abort, { once: true });
@@ -1100,7 +1103,7 @@ async function* byteChunks(body, signal) {
         throwIfAborted(signal);
         const { done, value } = await reader.read();
         if (done) return;
-        yield value instanceof Uint8Array ? value : new Uint8Array(value);
+        yield is.instanceCheck(value, Uint8Array) ? value : new Uint8Array(value);
       }
     } finally {
       signal?.removeEventListener?.("abort", abort);
@@ -1347,7 +1350,7 @@ function ordinaryArtifactUrl(value, base) {
 }
 
 function isBareModuleSpecifier(value) {
-  return typeof value === "string"
+  return is.string(value)
     && !value.startsWith("./")
     && !value.startsWith("../")
     && !value.startsWith("/")
@@ -1696,7 +1699,7 @@ async function createOrdinaryArtifactObjectUrls(
 ) {
   const create = objectUrlFactory?.create ?? PLATFORM_CREATE_OBJECT_URL;
   const revoke = objectUrlFactory?.revoke ?? PLATFORM_REVOKE_OBJECT_URL;
-  if (typeof create !== "function" || typeof revoke !== "function") {
+  if (!is.function(create) || !is.function(revoke)) {
     throw artifactGraphError(
       "artifact-graph-object-url-platform-unavailable",
       "Artifact materialization requires native Blob URL creation and revocation.",
@@ -1706,11 +1709,11 @@ async function createOrdinaryArtifactObjectUrls(
   const materializedByPath = new Map();
   const created = [];
   async function materialize(descriptor, body) {
-    const blob = body instanceof Blob && body.type === descriptor.mediaType
+    const blob = is.instanceCheck(body, Blob) && body.type === descriptor.mediaType
       ? body
       : new Blob([body], { type: descriptor.mediaType });
     const moduleUrl = create(blob);
-    if (typeof moduleUrl !== "string") {
+    if (!is.string(moduleUrl)) {
       throw artifactGraphError(
         "artifact-graph-object-url-platform-unavailable",
         `Artifact file ${descriptor.path} did not produce an object URL.`,
@@ -1777,7 +1780,7 @@ async function createOrdinaryArtifactObjectUrls(
 function createObjectUrls(files, factory) {
   const create = factory?.create ?? ((blob) => URL.createObjectURL(blob));
   const revoke = factory?.revoke ?? ((url) => URL.revokeObjectURL(url));
-  if (typeof create !== "function" || typeof revoke !== "function") {
+  if (!is.function(create) || !is.function(revoke)) {
     throw new TypeError("Browser speech objectUrlFactory requires create() and revoke().");
   }
   const created = [];
@@ -1830,14 +1833,14 @@ export function createDbopfsSpeechArtifactStore({
   fetchImpl = null,
   objectUrlFactory = null,
 } = {}) {
-  if (!dbopfs || typeof dbopfs.getTableHandle !== "function") {
+  if (!dbopfs || !is.function(dbopfs.getTableHandle)) {
     throw new TypeError("createDbopfsSpeechArtifactStore requires an existing DBOPFS instance.");
   }
-  if (dbopfs.readyPromise !== undefined && typeof dbopfs.readyPromise?.then !== "function") {
+  if (dbopfs.readyPromise !== undefined && !is.function(dbopfs.readyPromise?.then)) {
     throw new TypeError("The DBOPFS readyPromise must be thenable.");
   }
   const locks = dbopfs.lockManager ?? globalThis.navigator?.locks;
-  if (!locks || typeof locks.request !== "function") {
+  if (!locks || !is.function(locks.request)) {
     throw new TypeError(
       "createDbopfsSpeechArtifactStore requires the browser Web Locks API.",
     );
@@ -1873,7 +1876,7 @@ export function createDbopfsSpeechArtifactStore({
     if (dbopfs.readyPromise) await dbopfs.readyPromise;
     tablePromise ||= Promise.resolve(dbopfs.getTableHandle(tableName));
     const result = await tablePromise;
-    if (!result || typeof result.getFileHandle !== "function" || typeof result.removeEntry !== "function") {
+    if (!result || !is.function(result.getFileHandle) || !is.function(result.removeEntry)) {
       throw speechError("ARCANE_AI_STORAGE_UNAVAILABLE", "DBOPFS did not provide a speech artifact table.");
     }
     return result;
@@ -1934,7 +1937,7 @@ export function createDbopfsSpeechArtifactStore({
     const metadata = artifactMetadata(authority);
     const names = storageNames(authority, metadata.files);
     const priorSelection = await readJsonFile(names.selection);
-    const priorCount = Array.isArray(priorSelection?.files)
+    const priorCount = is.array(priorSelection?.files)
       ? priorSelection.files.length
       : 0;
     const fileNames = Array.from(
@@ -2000,7 +2003,7 @@ export function createDbopfsSpeechArtifactStore({
     const metadata = artifactMetadata(authority);
     const names = storageNames(authority, metadata.files);
     const fetchFunction = fetchImpl ?? globalThis.fetch?.bind(globalThis);
-    if (typeof fetchFunction !== "function") {
+    if (!is.function(fetchFunction)) {
       throw speechError("ARCANE_AI_ARTIFACT_SOURCE_UNAVAILABLE", "Browser fetch is unavailable.");
     }
     await removeUnlocked(authority);
@@ -2039,16 +2042,16 @@ export function createDbopfsSpeechArtifactStore({
         let responseOk;
         let responseStatus;
         try {
-          if (!response || typeof response !== "object") {
+          if (!response || !is.object(response)) {
             throw new TypeError("The artifact fetch result is not an object.");
           }
           responseBody = response.body;
           responseOk = response.ok;
           responseStatus = response.status;
           if (
-            typeof responseOk !== "boolean"
-            || !Number.isInteger(responseStatus)
-            || (responseBody !== null && typeof responseBody?.getReader !== "function")
+            !is.boolean(responseOk)
+            || !is.integer(responseStatus)
+            || (responseBody !== null && !is.function(responseBody?.getReader))
           ) {
             throw new TypeError("The artifact fetch result is not a readable Fetch Response.");
           }