arcane-os 0.40.0 → 0.41.0

package/browser-runtime/dependencies/js-queue/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "js-queue",
+  "version": "3.1.1",
+  "description": "A tiny FIFO task queue with explicit flow control for Node and browsers",
+  "type": "module",
+  "main": "./queue.js",
+  "module": "./queue.js",
+  "browser": "./queue.js",
+  "exports": {
+    ".": {
+      "import": "./queue.js",
+      "require": "./queue.js",
+      "default": "./queue.js"
+    },
+    "./queue": {
+      "import": "./queue.js",
+      "require": "./queue.js"
+    },
+    "./queue.js": {
+      "import": "./queue.js",
+      "require": "./queue.js"
+    },
+    "./queue-vanilla.js": "./queue-vanilla.js",
+    "./stack": {
+      "import": "./stack.js",
+      "require": "./stack.js"
+    },
+    "./stack.js": {
+      "import": "./stack.js",
+      "require": "./stack.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "queue.js",
+    "queue-vanilla.js",
+    "stack.js",
+    "assets/js-queue-header.png",
+    "assets/vanilla-test-header.png",
+    "assets/benchmark-construct.svg",
+    "assets/benchmark-tasks.svg",
+    "README.md",
+    "CHANGELOG.md",
+    "MIGRATION.md",
+    "licence.md"
+  ],
+  "sideEffects": [
+    "./queue-vanilla.js"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "test": "node ./scripts/test.js",
+    "test:unit": "node ./scripts/test.js unit",
+    "test:functional": "node ./scripts/test.js functional",
+    "test:behavioral": "node ./scripts/test.js behavioral",
+    "test:integration": "node ./scripts/test.js integration",
+    "test:regression": "node ./scripts/test.js regression",
+    "test:core": "node ./scripts/test.js core",
+    "test:playground": "node ./scripts/test.js playground",
+    "test:package": "node ./scripts/test.js package",
+    "test:consumer": "node ./scripts/test.js consumer",
+    "test:server": "node ./scripts/test.js server",
+    "test:docs": "node ./scripts/test.js docs",
+    "coverage": "vanilla-test coverage",
+    "coverage:node": "vanilla-test coverage node",
+    "coverage:chrome": "vanilla-test coverage chrome",
+    "benchmark": "node --expose-gc ./scripts/benchmark.js",
+    "start": "node ./scripts/serve.js",
+    "check": "npm test && npm run coverage:node"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RIAEvangelist/js-queue.git"
+  },
+  "keywords": [
+    "queue",
+    "fifo",
+    "task-queue",
+    "flow-control",
+    "async",
+    "browser",
+    "node",
+    "esm",
+    "commonjs"
+  ],
+  "author": "Brandon Nozaki Miller",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/RIAEvangelist/js-queue/issues"
+  },
+  "homepage": "https://riaevangelist.github.io/js-queue/",
+  "dependencies": {
+    "easy-stack": "2.1.0"
+  },
+  "devDependencies": {
+    "vanilla-test": "2.1.1"
+  }
+}

package/browser-runtime/dependencies/js-queue/queue.js

@@ -0,0 +1,78 @@
+function validateTasks(tasks){
+    const invalidIndex=tasks.findIndex(task=>typeof task !== 'function');
+    if(invalidIndex !== -1){
+        throw new TypeError(`Queue task at index ${invalidIndex} must be a function.`);
+    }
+}
+
+class Queue{
+    #contents=[];
+    #running=false;
+
+    constructor(){
+        this.autoRun=true;
+        this.stop=false;
+    }
+
+    add(...tasks){
+        validateTasks(tasks);
+        this.#contents.push(...tasks);
+
+        if(!this.#running && !this.stop && this.autoRun){
+            this.next();
+        }
+
+        return this;
+    }
+
+    next(){
+        if(this.stop || this.#contents.length === 0){
+            this.#running=false;
+            return;
+        }
+
+        this.#running=true;
+        const task=this.#contents.shift();
+
+        try{
+            task.call(this);
+        }catch(error){
+            this.#running=false;
+            throw error;
+        }
+    }
+
+    clear(){
+        this.#contents=[];
+        return this.#contents;
+    }
+
+    get contents(){
+        return this.#contents;
+    }
+
+    set contents(tasks){
+        if(!Array.isArray(tasks)){
+            throw new TypeError('Queue contents must be an array of functions.');
+        }
+
+        validateTasks(tasks);
+        this.#contents=tasks;
+    }
+
+    get running(){
+        return this.#running;
+    }
+
+    get size(){
+        return this.#contents.length;
+    }
+}
+
+Queue.Queue=Queue;
+
+export {
+    Queue as default,
+    Queue,
+    Queue as 'module.exports'
+};

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

@@ -1,12 +1,14 @@
 # Browser speech providers
 
 `arcane-os/ai/browser-speech` supplies caller-selected Whisper speech-to-text,
-Kokoro text-to-speech, and DigitalOcean FAL text-to-speech providers. Its local path
+Kokoro text-to-speech, and TWiN Cloud text-to-speech providers. Its local path
 provides artifact storage, live module routing, role Workers, provider/2
 adapters, bounded parallel TTS synthesis, audio normalization, cancellation,
 and cleanup.
 
-## DigitalOcean FAL text-to-speech
+<a id="digitalocean-fal-text-to-speech"></a>
+
+## TWiN Cloud text-to-speech
 
 Use the same AI speech queue with an explicitly selected remote provider.
 The application supplies its current DigitalOcean inference key through a
@@ -14,17 +16,18 @@ function returning a string or promise; never place that key in source, logs, or
 This example receives an existing `ai` and application-owned key reader:
 
 ```javascript
-import {createDigitalOceanFalTTSProvider} from 'arcane-os/ai/browser-speech';
+import {createTwinCloudTTSProvider} from 'arcane-os/ai/browser-speech';
 
 async function selectCloudVoice(ai, getApiKey) {
-  const provider = createDigitalOceanFalTTSProvider({
-    id: 'my-digitalocean-voice',
+  const provider = createTwinCloudTTSProvider({
+    id: 'my-cloud-voice',
     model: {
       id: 'fal-ai/elevenlabs/tts/multilingual-v2',
       defaultVoice: 'Rachel'
     },
     getApiKey,
-    maxConcurrentRequests: 4
+    maxConcurrentRequests: 4,
+    followUpQueue: {maxConcurrentRequests: 4, intervalMs: 250}
   });
   await ai.configureSpeechProvider('tts', provider, {
     modelId: provider.catalog()[0].id
@@ -33,6 +36,10 @@ async function selectCloudVoice(ai, getApiKey) {
 }
 ```
 
+`createDigitalOceanFalTTSProvider` remains a compatibility export of the same
+factory. Existing provider IDs and credentials remain valid; the TWiN Cloud
+name does not change the underlying DigitalOcean FAL endpoint or protocol.
+
 Construction and configuration make no network request. Explicit
 `ai.setSpeechMuted(false)` awaits the key reader, checks credential presence, and activates
 the adapter; its ready state does not prove remote credential validity.
@@ -53,11 +60,49 @@ punctuation segmentation, concurrent provider queue, and original-order
 playback remain the only owners. Use
 `ai.configureTTSSegmentation({punctuation:'any',wordCadence:null})` when each
 punctuation boundary should submit promptly. This is incremental playback of
-completed synthesis jobs, not a live audio stream from DigitalOcean.
-
-The transport submits `POST https://inference.do-ai.run/v1/async-invoke`, then
-reads that job until its completed `output.audio.url` is available. Each
-segment is submitted once; only status reads retry a `429` with `Retry-After`.
+completed synthesis jobs, not a live audio stream from TWiN Cloud.
+
+The SDK submits `POST https://inference.do-ai.run/v1/async-invoke` immediately
+after credential readiness, outside the follow-up queue. It then reads that job
+until its completed `output.audio.url` is available. The provider's
+`maxConcurrentRequests` retains its whole-synthesis-job meaning; it is separate
+from `followUpQueue.maxConcurrentRequests`.
+
+One provider-local `js-queue` owns only follow-up status/result GETs and the final
+audio GET. `followUpQueue` defaults to `{maxConcurrentRequests:4,intervalMs:250}`;
+the application may supply those settings explicitly. A follow-up slot remains
+occupied through the complete JSON, audio Blob, or error response body. Dispatch
+starts observe `intervalMs`, with at most the configured number in flight. Each
+job awaits its current response and body before immediately enqueueing another
+request only when incomplete or eligible for a retry. There is no additional
+per-job polling delay.
+
+A readable `Retry-After` changes only the affected job's next eligibility, not
+sibling requests or initial submissions. A readable `429` permits one retry of
+that submission or status read; submission retries retain a one-second minimum, while
+follow-up retries use the queue cadence and any longer readable `Retry-After`.
+An accepted job's status Fetch network failure may retry once for the same job;
+JSON parsing failures are not network retries. Repeated failures surface their
+complete diagnostics without an endless retry loop; a failed job does not cancel
+siblings. Retry diagnostics remain in the developer console, outside conversation
+history.
+
+The queue is created when this cloud factory is called, not when the browser
+speech entrypoint is imported. Local Kokoro and Whisper do not use this queue;
+their setup, Workers, synthesis/transcription, and lifecycle remain independent.
+
+The SDK pins published `js-queue` through npm. Its browser Queue entry, original
+package metadata, and license are projected unchanged by
+`node tools/sync-js-queue.mjs` after an SDK dependency update. The existing runtime
+materializer serves that same entry; applications do not need another import-map
+setting. `easy-stack` remains an npm dependency and is not imported by the Queue
+entry. Do not hand-edit this upstream projection.
+
+An ambiguous submission network failure is not automatically resubmitted: a
+browser cannot distinguish a rejected preflight from an accepted paid job whose
+response was lost. This contract has no submission idempotency mechanism, and
+unreadable response headers cannot supply a retry delay. Follow-up pacing does
+not claim to free upstream concurrency slots or fix CORS.
 The audio download never receives the inference Authorization header.
 The selected multilingual-v2 service supports speed `0.7` through `1.2`;
 unsupported speeds reject rather than being silently clamped. Complete
@@ -924,8 +969,8 @@ records; this contract does not freeze them or shorten their content.
 | --- | --- | --- |
 | Browser | Shipped | Requires Workers, Fetch, Blob/File, object URLs, DBOPFS/OPFS, and Web Locks. Blob/File STT requests also require the browser audio decoder. |
 | Native WebView | Conditional | Available when the WebView exposes the browser APIs above. It does not invoke Core speech. |
-| Node | Remote adapter available; local execution unavailable | DigitalOcean FAL uses Fetch and Blob. The local providers have no SDK Node speech-storage, Worker, or audio-decoder host. |
-| Remote TTS | Explicitly selected | DigitalOcean FAL uses standard Fetch and Blob with an application-owned key; no Worker, OPFS, or local model is needed for this adapter. |
+| Node | Remote adapter available; local execution unavailable | TWiN Cloud uses Fetch and Blob. The local providers have no SDK Node speech-storage, Worker, or audio-decoder host. |
+| Remote TTS | Explicitly selected | TWiN Cloud uses standard Fetch and Blob with an application-owned key; no Worker, OPFS, or local model is needed for this adapter. |
 
 STT and TTS own independent provider lifecycles. A failure or cancellation in
 one role does not disable the other role or authorize a fallback provider.
@@ -941,7 +986,8 @@ import {
   createBrowserSpeechAuthority,
   createBrowserWhisperProvider,
   createDbopfsSpeechArtifactStore,
-  createDigitalOceanFalTTSProvider
+  createDigitalOceanFalTTSProvider,
+  createTwinCloudTTSProvider
 } from 'arcane-os/ai/browser-speech';
 ```
 

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

@@ -6,7 +6,7 @@
     "minimumVersion": "22.23.2 for Node entrypoints",
     "moduleSystem": "ESM"
   },
-  "memberCount": 218,
+  "memberCount": 219,
   "runtimeSubpathPatterns": {
     "arcane-os/modules/*": "./runtime/arcane/modules/*",
     "arcane-os/entities/*": "./runtime/arcane/entities/*"
@@ -3111,14 +3111,28 @@
       "name": "createDigitalOceanFalTTSProvider",
       "displayName": "createDigitalOceanFalTTSProvider()",
       "kind": "function",
-      "signature": "createDigitalOceanFalTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,fetch=globalThis.fetch}={})",
+      "signature": "createDigitalOceanFalTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,followUpQueue:{maxConcurrentRequests=4,intervalMs=250}={},fetch=globalThis.fetch}={})",
       "entrypoints": ["arcane-os/ai/browser-speech"],
       "primaryImport": "arcane-os/ai/browser-speech",
       "group": "Browser speech providers",
-      "summary": "Creates an explicitly selected DigitalOcean FAL remote TTS provider using standard Fetch and completed audio jobs.",
+      "summary": "Compatibility export of createTwinCloudTTSProvider using the same function and implementation.",
       "availability": "Browser or Node with Fetch, Blob, AbortController, and an application-owned DigitalOcean inference key",
       "protocol": "arcane-ai-provider/2 tts/synthesize",
-      "normalization": "Construction and activation make no adapter network requests. Activation awaits the application-owned string or promise key reader. localOnly false, concurrent requests, complete audio Blob results, and local cancellation without claiming remote-job cancellation. Applications own model, voice, credentials, and activation."
+      "normalization": "Same TWiN Cloud options, queued follow-ups, complete audio Blob results, and cancellation contract. Existing imports, stored provider IDs, and credentials remain valid without migration."
+    },
+    {
+      "id": "browser-speech:createTwinCloudTTSProvider",
+      "name": "createTwinCloudTTSProvider",
+      "displayName": "createTwinCloudTTSProvider()",
+      "kind": "function",
+      "signature": "createTwinCloudTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,followUpQueue:{maxConcurrentRequests=4,intervalMs=250}={},fetch=globalThis.fetch}={})",
+      "entrypoints": ["arcane-os/ai/browser-speech"],
+      "primaryImport": "arcane-os/ai/browser-speech",
+      "group": "Browser speech providers",
+      "summary": "Creates an explicitly selected TWiN Cloud remote TTS provider with immediate synthesis submission and configurable queued audio follow-ups.",
+      "availability": "Browser or Node with Fetch, Blob, AbortController, and an application-owned inference key",
+      "protocol": "arcane-ai-provider/2 tts/synthesize",
+      "normalization": "Construction and activation make no adapter network requests. SDK initial POSTs bypass the provider-local js-queue; follow-up status/result/audio GETs use followUpQueue capacity and cadence through complete body consumption. Retry-After affects only its job. Whole-job maxConcurrentRequests remains independent. Local Kokoro and Whisper paths are unchanged. Applications own model, voice, credentials, activation, and queue settings."
     },
     {
       "id": "browser-speech:createBrowserKokoroProvider",

package/docs/reference/pwa.md

@@ -93,6 +93,16 @@ The application entry and generated PWA shell records are retained. Select the
 resources needed by every offline page, including its shared modules and styles.
 The worker script itself is never an application cache entry.
 
+For direct installed-package root applications, public `arcane import-map`
+generation follows the same source resource graph as `arcane dev` before writing
+the static offline inventory. Imports from unvisited pages, shared runtime
+modules, component styles, and statically declared Worker URLs retain their
+authored query values. SDK component `./arcane/` resource attributes resolve from
+that component's actual runtime root, including installed package aliases and
+nested component directories; ordinary application document bases keep their
+normal meaning. The graph selects resources already present in the configured
+routes. It does not invent resource paths or enumerate user-specific page URLs.
+
 These settings describe published application resources. They do not select
 user uploads, provider responses, live API requests, saved conversations,
 preferences, IndexedDB, OPFS, or a model owner's download/cache lifecycle.
@@ -180,7 +190,7 @@ without loading certificates; see [explicit HTTP development](cli.md#explicit-ht
 `--public` selects the IPv4 wildcard bind address; it does not enable PWA
 configuration, change manifest metadata, or determine browser installability.
 
-Source inventory work begins when the browser requests the worker or current
+Live source inventory work begins when the browser requests the worker or current
 offline manifest, after the page can start. It traverses the selected route
 inventory once for that request, follows page and runtime resource references
 to retain selected query variants, and shares an in-flight traversal with
@@ -189,6 +199,11 @@ document corpus bodies remain under their existing owner. It does not rebuild
 the application. Installation metadata and bootstrap requests reuse the current
 generated bundle.
 
+An explicit root import-map refresh also performs that traversal to produce the
+committed static PWA files. It opens no server or listener. Its generated
+inventory is available to ordinary static hosting without first visiting each
+page through the development server.
+
 The SDK owns version information in `arcane-offline.json`:
 
 | Field | Owner and update rule |

package/docs/reference/runtime-components.md

@@ -1566,8 +1566,10 @@ boundary applies to STT activation, transcription, TTS lifecycle, synthesis,
 and playback failures.
 
 `reportTTSError()` recognizes `synthesis`, `decode`, `playback-start`, and
-`playback-resume`. It mutes and stops the failed operation, preserves sticky
-provider readiness, and emits `speech-synthesis-error` with the exact boundary,
+`playback-resume`. It preserves the user's mute choice, sticky provider
+readiness, and accepted sibling speech jobs. The AI runtime owns settlement of
+the failed job; reporting an error neither stops the queue nor retries it. The
+component emits `speech-synthesis-error` with the exact boundary,
 stable reason/code, generic user-safe status, and complete Error in the local
 event detail.
 
@@ -1600,8 +1602,16 @@ same capture operation id rather than inventing a second correlation boundary.
 User Unmute calls the shared `AI.setSpeechMuted(false)` lifecycle owner before
 or with publishing the TTS load intent, so the runtime can legally load TTS.
 Configured `initialMuted:false` records that same unmute intent even when the
-TTS route is still unselected or loading; the component remains publicly muted
-until the selected role reaches `ready`, then applies the preserved intent.
+TTS route is still unselected or loading. Public `muted` expresses the user's
+choice; role availability and the AI runtime still prevent playback until the
+selected role reaches `ready`, when the waiting intent is applied. A failed
+load ends its activation attempt without changing that choice or starting
+another attempt. Retry voice explicitly starts a new attempt, including when
+the preserved choice is unmuted; an unloaded selected voice offers Load voice.
+When a role returns to ready, permitted queued playback resumes through the
+existing AI owner without repeating activation or replaying failed jobs.
+Synthesis, decode, and playback failures also
+preserve that choice and do not automatically replay failed speech.
 Mute calls `AI.setSpeechMuted(true)`, stops playback, cancels active TTS work,
 and unloads the selected TTS role. Lifecycle failures remain visible through
 `speech-tts-lifecycle-error` and sticky role state.

package/docs/reference/sdk-api.md

@@ -67,7 +67,7 @@ runtime layouts.
 | `arcane-os/ai/browser-wasm` | Caller-selected browser-local Wllama inference, complete DBOPFS model storage, streaming, cancellation, and structural tool-call results. |
 | `arcane-os/ai/tool-text-stream` | Shared selected tool-argument text observer for provider integration. |
 | `arcane-os/ai/twin-cloud` | Complete TWiN Cloud requests from Node or a browser with an explicit key/model and shared retry/cancellation behavior. |
-| `arcane-os/ai/browser-speech` | Caller-selected browser-local Whisper STT and Kokoro TTS, explicit DigitalOcean FAL remote TTS, ordinary upstream assets, role lifecycle, and cancellation. |
+| `arcane-os/ai/browser-speech` | Caller-selected browser-local Whisper STT and Kokoro TTS, explicit TWiN Cloud remote TTS, ordinary upstream assets, role lifecycle, and cancellation. |
 | `arcane-os/mail` | Portable Mail runtime, durable outbox, complete transport responses, and provider-neutral acceptance contracts. |
 
 These lowercase runtime-module entrypoints expose their existing exports; they
@@ -178,7 +178,8 @@ browser map are cataloged separately in [Runtime modules](runtime-modules.md).
 | `getPwaInstall()` | function | `arcane-os/pwa` | Progressive web applications | Browser native installation events; waiting state while no prompt is available |
 | `mountPwaInstallPrompt()` | function | `arcane-os/pwa` | Progressive web applications | Browser document and managed HTML import; resolves to null without a document |
 | `createDbopfsSpeechArtifactStore()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser with ready DBOPFS, Web Locks, Fetch, File/Blob, and object URLs |
-| `createDigitalOceanFalTTSProvider()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser or Node with Fetch, Blob, and an application-supplied DigitalOcean inference key |
+| `createDigitalOceanFalTTSProvider()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Compatibility name for `createTwinCloudTTSProvider()` |
+| `createTwinCloudTTSProvider()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser or Node with Fetch, Blob, and an application-supplied inference key |
 | `removeBrowserSpeechModelCache()` | function | `arcane-os/ai/browser-speech` | Browser speech providers | Browser CacheStorage; explicit removal of one selected upstream model |
 | `createNativeBuildPlan()` | function | `arcane-os` | Targets, native plans, and providers | Node; selected browser/native target or provider as documented |
 | `createNativeTargetAdapter()` | function | `arcane-os` | Targets, native plans, and providers | Node; selected browser/native target or provider as documented |
@@ -7184,36 +7185,41 @@ async function transcribeAfterUserChoice(audioBlob) {
 }
 ```
 
-## createDigitalOceanFalTTSProvider()
+## createTwinCloudTTSProvider()
 
 ### Overview
 
-Creates a `localOnly:false` provider/2 TTS adapter for the caller-selected
-DigitalOcean FAL model. It submits independent synthesis jobs, polls their
-completion, and returns each complete downloaded audio `Blob`. The shared AI
+Creates a `localOnly:false` TWiN Cloud provider/2 TTS adapter for the caller-selected
+model. It submits independent synthesis jobs, polls their completion, and returns
+each complete downloaded audio `Blob`. The shared AI
 queue owns punctuation segmentation, bounded concurrent requests, and playback
 in input order; this is not provider-native live audio streaming.
 
-### Signature and parameters
+### Signature and result
 
 ```text
-createDigitalOceanFalTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,fetch=globalThis.fetch}={})
+createTwinCloudTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,followUpQueue:{maxConcurrentRequests=4,intervalMs=250}={},fetch=globalThis.fetch}={})
 ```
 
 `id` is the application-owned provider identifier. `model` contains the selected
 `id` and `defaultVoice`; the supported multilingual-v2 selection is
 `fal-ai/elevenlabs/tts/multilingual-v2`. `getApiKey()` returns the
 application's current DigitalOcean inference key or a promise for it. The credential is never
-included in catalog or status. `maxConcurrentRequests` is a positive integer;
-the runtime owns admission and its FIFO queue. Optional `fetch` supplies the
-standard Fetch interface.
+included in catalog or status. `maxConcurrentRequests` remains the positive
+whole-synthesis-job capacity used by the shared AI runtime. It is independent
+from `followUpQueue.maxConcurrentRequests`, which controls follow-up HTTP
+operations. `followUpQueue.intervalMs` controls the spacing between those
+dispatch starts. Optional `fetch` supplies the standard Fetch interface.
 
 ### Availability and normalization
 
 The adapter needs Fetch, Blob, and AbortController; it needs no Worker or
 DBOPFS. Browser access depends on endpoint CORS support. Construction makes
-no network request. Inspection and activation await the application's key
-reader without making an SDK network request. Activation checks
+no network request. Its provider-local `js-queue` is created only when this
+factory is called; importing the entrypoint does not create a queue or load a
+model. Local Kokoro and Whisper retain their independent paths. Inspection and
+activation await the application's key reader without making an SDK network
+request. Activation checks
 local credential presence, not remote validity. Status reports remote
 execution and current activity. Requests preserve complete text, selected
 voice, and speed; multilingual-v2 speed outside `0.7` through `1.2` rejects
@@ -7221,6 +7227,22 @@ instead of clamping. Returned media is fetched without the inference key.
 Cancelling a credential wait leaves the application's shared refresh alone
 and prevents a late result from starting this cancelled operation.
 
+The SDK sends each initial synthesis POST immediately after credential readiness,
+outside the follow-up queue. One queue handles only status/result GETs and the
+final audio download. Its defaults are four in-flight follow-ups and 250 ms
+between dispatch starts, with each slot held through complete JSON, Blob, or
+error-body consumption. Each job awaits its response and body before enqueueing
+its next incomplete-status check; there is no per-job polling delay.
+
+A readable `Retry-After` postpones only the affected job's next eligibility.
+Other jobs and initial submissions remain independent. One readable HTTP 429
+retry is allowed per submission or status read; POST retries retain a one-second minimum, and
+follow-up retries use the configured queue cadence plus any longer readable
+`Retry-After`. An accepted job's failed status Fetch may retry once after a
+network failure, not after a JSON parsing failure. Repeated failures surface
+complete developer diagnostics without cancelling sibling jobs. An ambiguous
+paid POST network failure is never automatically replayed.
+
 Each provider/2 `tts/synthesize` request returns one complete audio Blob.
 Request cancellation, unload, and disposal stop local polling/downloads and
 discard late results; they cannot promise cancellation of an already submitted
@@ -7230,13 +7252,14 @@ does not select a fallback or silently resubmit a paid synthesis POST.
 ### Example
 
 ```javascript
-import {createDigitalOceanFalTTSProvider} from 'arcane-os/ai/browser-speech';
+import {createTwinCloudTTSProvider} from 'arcane-os/ai/browser-speech';
 
 async function configureCloudVoice(ai, getApiKey) {
-  const provider = createDigitalOceanFalTTSProvider({
+  const provider = createTwinCloudTTSProvider({
     id: 'selected-cloud-voice',
     model: {id: 'fal-ai/elevenlabs/tts/multilingual-v2', defaultVoice: 'Rachel'},
-    getApiKey
+    getApiKey,
+    followUpQueue: {maxConcurrentRequests: 4, intervalMs: 250}
   });
   await ai.configureSpeechProvider('tts', provider);
   return provider;
@@ -7245,7 +7268,42 @@ async function configureCloudVoice(ai, getApiKey) {
 
 Call activation and synthesis from the application's explicit speech action.
 For streaming text, cancellation, and independent STT configuration, see
-[DigitalOcean FAL speech](ai/browser-speech.md#digitalocean-fal-text-to-speech).
+[TWiN Cloud speech](ai/browser-speech.md#twin-cloud-text-to-speech).
+
+## createDigitalOceanFalTTSProvider()
+
+### Overview
+
+Compatibility export of `createTwinCloudTTSProvider`, using the same function
+and implementation. The canonical public name is TWiN Cloud; the underlying
+DigitalOcean FAL endpoint and job protocol remain unchanged.
+
+### Signature and result
+
+```text
+createDigitalOceanFalTTSProvider({id,model,getApiKey,maxConcurrentRequests=4,followUpQueue:{maxConcurrentRequests=4,intervalMs=250}={},fetch=globalThis.fetch}={})
+```
+
+Accepts the same options and returns the same provider as
+[`createTwinCloudTTSProvider()`](#createtwincloudttsprovider).
+
+### Availability and normalization
+
+The alias shares the canonical factory's Browser and Node requirements,
+immediate submission, queued follow-ups, cancellation, and result contract.
+Existing caller imports, stored provider IDs, and credentials remain valid;
+renaming a caller's import requires no saved-data migration.
+
+### Example
+
+```javascript
+import {
+  createTwinCloudTTSProvider,
+  createDigitalOceanFalTTSProvider
+} from 'arcane-os/ai/browser-speech';
+
+console.log(createDigitalOceanFalTTSProvider === createTwinCloudTTSProvider);
+```
 
 ## createBrowserKokoroProvider()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -124,6 +124,7 @@
   },
   "dependencies": {
     "event-pubsub": "6.1.0",
+    "js-queue": "3.1.1",
     "node-http-server": "10.0.0",
     "strong-type": "2.0.1",
     "vanilla-test": "2.1.3"