arcane-os 0.2.2 → 0.2.3

package/docs/reference/runtime-components.md

@@ -61,7 +61,7 @@ A component file does not register its own custom element. The `<html-import>` h
 | [`theme-editor.html`](#theme-editorhtml) | Edits, previews, saves, and resets semantic custom theme tokens. | `configure()`<br>`getTheme()`<br>`setTheme()`<br>`setBusy()`<br>`setStatus()` | `theme-editor-ready`<br>`theme-preview`<br>`theme-save`<br>`theme-reset` | Fully normalized Theme values |
 | [`theme-switcher.html`](#theme-switcherhtml) | Selects and refreshes system, light, dark, or custom theme mode. | `setMode()`<br>`refresh()` | No component-specific event | Preference/native appearance behavior mixed; no component-ready contract |
 | [`unified-inbox.html`](#unified-inboxhtml) | Displays provider-neutral communication threads with active/loading state. | `configure()`<br>`setThreads()`<br>`setActive()`<br>`setLoading()` | `unified-inbox-ready`<br>`inbox-refresh`<br>`thread-select` | DOM-normalized |
-| [`voice-transcription.html`](#voice-transcriptionhtml) | Records segmented microphone audio, transcribes, persists, and completes a combined transcript. | `configure()`<br>`startRecording()`<br>`stopRecording()`<br>`save()`<br>`completeTranscription()/complete()`<br>`clear()`<br>`reset()`<br>`destroy()` | `voice-transcription-ready`<br>`voice-transcription-state`<br>`voice-transcription-segment`<br>`voice-transcription-change`<br>`voice-transcription-complete`<br>`speech-transcription-complete` | State/text normalized; media/provider behavior mixed |
+| [`voice-transcription.html`](#voice-transcriptionhtml) | Records segmented microphone audio only after authoritative STT admission, exposes explicit selected-STT activation, transcribes with cancellation, persists, and completes a combined transcript. | `configure()`<br>`requestSTTActivation()`<br>`startRecording()`<br>`stopRecording()`<br>`save()`<br>`completeTranscription()/complete()`<br>`clear()`<br>`reset()`<br>`destroy()` | `voice-transcription-ready`<br>`voice-transcription-state`<br>`voice-transcription-segment`<br>`voice-transcription-change`<br>`voice-transcription-complete`<br>`speech-transcription-complete`<br>`speech-transcription-cancelled`<br>`speech-stt-activation-request`<br>`speech-stt-activation-error` | Sticky runtime STT readiness, explicit activation, request cancellation, and state/text are normalized; media/provider behavior remains external |
 | [`weather-widget.html`](#weather-widgethtml) | Displays normalized current and daily weather with refresh intent. | `setWeather()`<br>`clear()` | `weather-widget-ready`<br>`weather-refresh` | Display normalized; provider supplied externally |
 | [`web-navigator.html`](#web-navigatorhtml) | Guards embedded/external navigation and surfaces allow/block/open intents. | `configure()`<br>`navigate()`<br>`currentUrl()` | `web-navigator-ready`<br>`web-navigate`<br>`web-navigation-blocked`<br>`web-open-external` | Navigation intent/decision normalized; browser navigation result platform-native |
 
@@ -866,7 +866,8 @@ Events: `speech-ready`, `speech-transcription-complete`,
 `speech-stt-activation-error`, and `speech-tts-lifecycle-error`.
 
 Shared dependencies: [`AI.js`](runtime-modules.md#aijs),
-[`AIRuntimeState.js`](runtime-modules.md#airuntimestatejs), and
+[`AIRuntimeState.js`](runtime-modules.md#airuntimestatejs),
+[`ComponentContracts.js`](runtime-modules.md#componentcontractsjs), and
 [`DBLS.js`](runtime-modules.md#dblsjs).
 
 The Hold to talk control remains disabled unless sticky STT state is `ready`,
@@ -1113,19 +1114,81 @@ Events: `unified-inbox-ready`, `inbox-refresh`, `thread-select`.
 
 ### Overview
 
-Records segmented microphone audio, transcribes, persists, and completes a combined transcript.
+Records segmented microphone audio only after authoritative STT admission,
+exposes explicit selected-STT activation, transcribes with cancellation,
+persists, and completes a combined transcript.
 
 ### Public surface
 
-Methods/properties: `configure()`, `startRecording()`, `stopRecording()`, `save()`, `completeTranscription()/complete()`, `clear()`, `reset()`, `destroy()`.
+Methods/properties: `configure()`, `requestSTTActivation()`, `startRecording()`,
+`stopRecording()`, `save()`, `completeTranscription()/complete()`, `clear()`,
+`reset()`, `destroy()`.
 
-Events: `voice-transcription-ready`, `voice-transcription-state`, `voice-transcription-segment`, `voice-transcription-change`, `voice-transcription-complete`, `speech-transcription-complete`.
+Events: `voice-transcription-ready`, `voice-transcription-state`,
+`voice-transcription-segment`, `voice-transcription-change`,
+`voice-transcription-complete`, `speech-transcription-complete`,
+`speech-transcription-cancelled`, `speech-stt-activation-request`, and
+`speech-stt-activation-error`.
 
-Shared dependencies: [`MD.js`](runtime-modules.md#mdjs), [`ComponentContracts.js`](runtime-modules.md#componentcontractsjs), [`AI.js`](runtime-modules.md#aijs).
+Shared dependencies: [`MD.js`](runtime-modules.md#mdjs),
+[`ComponentContracts.js`](runtime-modules.md#componentcontractsjs),
+[`AIRuntimeState.js`](runtime-modules.md#airuntimestatejs), and
+[`AI.js`](runtime-modules.md#aijs).
 
 ### Availability and normalization
 
-**Browser and supported native WebViews.** State/text normalized; media/provider behavior mixed. HTMLImport + DOM; injected Arcane/provider modules where listed. Native methods remain subject to the bound app's capabilities. [Deep protocol details](protocols.md).
+**Browser and supported native WebViews.** The component subscribes
+synchronously to sticky `AIRuntimeState.roles.stt`; its recording Start button
+and public `startRecording()` both fail closed unless that role is exactly
+`ready` and not busy. A configured `transcribe(file,context)` callback remains
+request plumbing rather than readiness authority. Its context now includes the
+owned `signal` additively. The default route calls
+`AI.fetchSTT(file,undefined,signal)` so the callback position remains valid and
+readiness loss or destruction can abort delivery.
+
+For a selected `unloaded`, `loading`, `unloading`, or `error` role, the component
+keeps recording Start disabled and presents the same keyboard-operable Start
+transcription/Try again or Cancel loading control as `speech.html`. Both use the
+shared `createSTTActivationController()` contract. User operation emits the
+cancelable `speech-stt-activation-request` event with frozen `{intent,state}`;
+`preventDefault()` suppresses the callback. The default
+`requestSTTActivation(intent)` publishes the frozen
+`{role:'stt',action:'load'|'unload',reason:'user'}` intent. Callback failure emits
+`speech-stt-activation-error` with frozen `{request,error,message}`. Import and
+state observation emit no activation request and never begin a model download.
+
+If sticky readiness is lost during microphone acquisition, capture, or the STT
+request, the component invalidates the session, aborts the owned request signal,
+releases media, discards late completion, and emits
+`speech-transcription-cancelled` with frozen `{reason:'runtime-unready'}`. A
+current provider cancellation returns the component workflow to `idle` and
+emits the same event with `reason:'stt-provider-request-cancelled'`; destroying
+an active capture or transcription emits `reason:'component-destroyed'`.
+Stale teardown results remain suppressed. A
+current save failure, including `AbortError`, enters the visible `error` state.
+Readiness loss after transcription has finished does not invalidate an already
+pending application save or completion callback: its settlement remains
+observable, while any new recording remains gated by current sticky readiness.
+Assigning `value` or calling `configure({initialValue})` explicitly supersedes
+an in-flight microphone start, STT request, save, or completion. The component
+advances its generation, aborts owned STT delivery, releases owned media, emits
+`speech-transcription-cancelled` with
+`reason:'transcript-replaced'`, and suppresses
+late settlement before publishing the assigned transcript. Assigning transcript
+text during active recording preserves that recording and changes the transcript
+to which the captured segment will be appended.
+`destroy()` aborts the state subscription, cancels active work, removes the
+activation listener, sets component `ready` to `false`, and returns `true`;
+repeated destruction is
+idempotent. Destruction is terminal: Start, activation, and Complete remain
+disabled and status remains unavailable. `voice-transcription-state` detail is
+the frozen `{message,state,stt}` record, where `state` remains the component
+workflow and `stt` is the authoritative immutable role record. Transcript
+completion stays available when STT is unavailable before destruction.
+State/text, explicit activation, and request cancellation are normalized;
+provider/model authority and media behavior remain external. HTMLImport + DOM;
+injected Arcane/provider modules where listed.
+Native methods remain subject to the bound app's capabilities. [Deep protocol details](protocols.md).
 
 ### Example
 

package/docs/reference/runtime-modules.md

@@ -41,7 +41,7 @@ Apps import renderer ESM from `/arcane/modules/<file>`. Classic scripts, the OPF
 | [`CommunicationHub.js`](#communicationhubjs) | esm | Fans out provider refresh/send operations and aggregates normalized threads/messages. | Cross-host with injected providers | Normalized aggregates; refresh contains per-provider failures. |
 | [`CommunicationPreferences.js`](#communicationpreferencesjs) | esm | Stores app-scoped, non-secret communication provider preferences. | Browser / native WebView hybrid | Normalized preference record; storage failures mixed. |
 | [`CommunicationProviderRegistry.js`](#communicationproviderregistryjs) | esm | Registers and queries validated provider definitions, channels, and required methods. | Cross-host | Strict normalized registry. |
-| [`ComponentContracts.js`](#componentcontractsjs) | esm | Owns normalized configuration/value contracts shared by chart, dashboard, Markdown, and voice components. | Cross-host | Fully normalized labels, rows, definitions, visibility, formats, editor and voice options. |
+| [`ComponentContracts.js`](#componentcontractsjs) | esm | Owns normalized configuration/value contracts and shared explicit STT activation behavior for chart, dashboard, Markdown, and voice components. | Cross-host | Fully normalized labels, rows, definitions, visibility, formats, editor and voice options, plus capability-neutral STT activation intent and presentation state. |
 | [`ConfiguredAIChatSession.js`](#configuredaichatsessionjs) | esm | Owns bounded in-memory AI turns, context construction, response-length instruction, and atomic history commit. | Native bridge by default; cross-host with injected chat | Normalized session/result; provider rejection preserved. |
 | [`ConversationActionItems.js`](#conversationactionitemsjs) | esm | Normalizes, creates, updates, remembers, selects, and formats bounded conversation action items. | Cross-host | Fully normalized status/base/presentation contract. |
 | [`ConversationClosingReport.js`](#conversationclosingreportjs) | esm | Defines the closing-report tool, instruction, result normalizer, call classifier, and formatter. | Cross-host | Fully normalized report contract. |
@@ -259,11 +259,10 @@ request ownership is active.
 
 ### Availability and normalization
 
-**Cross-host runtime with provider-specific execution.** Published SDK `0.2.1`
-ships the browser-WASM LLM and browser Whisper/Kokoro adapters but predates the
-legacy speech adapters described above. Current source also supplies the narrow
-AI.js legacy OpenAI/Ollama/Core-speech adapters; other native, Core, or cloud
-adapters may be supplied externally only when they implement the same
+**Cross-host runtime with provider-specific execution.** Published SDK `0.2.2`
+ships the browser-WASM LLM and browser Whisper/Kokoro adapters and supplies the
+narrow AI.js legacy OpenAI/Ollama/Core-speech adapters; other native, Core, or
+cloud adapters may be supplied externally only when they implement the same
 `arcane-ai-provider/2` boundary. A
 provider must prove a matching `arcane-ai-model-authority/1` inspection before load.
 `localOnly` routing fails closed; it never selects a cloud or non-local route as
@@ -792,17 +791,40 @@ console.log(Object.keys(module));
 
 ### Overview
 
-Owns normalized configuration/value contracts shared by chart, dashboard, Markdown, and voice components.
+Owns normalized configuration/value contracts and shared explicit STT activation
+behavior for chart, dashboard, Markdown, and voice components.
 
 ### Public surface
 
-Six constant sets and twelve normalization/formatting helpers.
+Constant sets plus normalization, formatting, and explicit STT activation
+helpers. `createSTTActivationController({host,button,onChange,EventClass=CustomEvent})`
+consumes only normalized
+[`AIRuntimeState`](#airuntimestatejs) `stt` role records. Its frozen controller
+exposes `action`, `error`, `label`, `pending`, `selected`, `status`, `title`, and
+`visible` getters plus `request(action)`, `synchronize(role)`, and `destroy()`.
+`host` supplies `dispatchEvent(event)` and `requestSTTActivation(intent)`;
+`button` supplies `addEventListener()` and `removeEventListener()`; and
+`onChange()` is called whenever presentation should be rendered again. Browser
+callers use the default `CustomEvent`; non-DOM callers must inject a compatible
+`EventClass` constructor.
 
-Exact exports: `CHART_LABELS`, `DASHBOARD_LABELS`, `MARKDOWN_FORMATS`, `MARKDOWN_LABELS`, `VOICE_LABELS`, `VOICE_MESSAGES`, `appendTranscription`, `applyMarkdownFormat`, `effectiveDashboardVisibility`, `normalizeChartOptions`, `normalizeChartRows`, `normalizeDashboardDefinitions`, `normalizeDashboardOptions`, `normalizeDashboardVisibility`, `normalizeMarkdownFormats`, `normalizeMarkdownOptions`, `normalizeVoiceOptions`.
+`request('load'|'unload')` emits the cancelable
+`speech-stt-activation-request` event with frozen `{intent,state}` before it
+invokes `host.requestSTTActivation(intent)`. Callback failure emits
+`speech-stt-activation-error` with frozen `{request,error,message}`. Syncing
+sticky state only changes the controller's observation and presentation; it
+never emits a lifecycle intent, chooses a provider, or starts a download.
+`destroy()` removes its button listener and suppresses late callback effects.
+
+Exact exports: `CHART_LABELS`, `DASHBOARD_LABELS`, `MARKDOWN_FORMATS`, `MARKDOWN_LABELS`, `VOICE_LABELS`, `VOICE_MESSAGES`, `appendTranscription`, `applyMarkdownFormat`, `createSTTActivationController`, `effectiveDashboardVisibility`, `normalizeChartOptions`, `normalizeChartRows`, `normalizeDashboardDefinitions`, `normalizeDashboardOptions`, `normalizeDashboardVisibility`, `normalizeMarkdownFormats`, `normalizeMarkdownOptions`, `normalizeVoiceOptions`.
 
 ### Availability and normalization
 
-**Cross-host.** Fully normalized labels, rows, definitions, visibility, formats, editor and voice options. Transport: In-process only. [Deep protocol details](protocols.md).
+**Cross-host with an injected event constructor outside DOM hosts.** Fully
+normalized labels, rows, definitions, visibility, formats, editor and voice
+options, plus capability-neutral STT activation intent and presentation state.
+Provider authority and lifecycle execution remain with the configured runtime
+owner. Transport: In-process only. [Deep protocol details](protocols.md).
 
 ### Example
 
@@ -1083,7 +1105,7 @@ source body as implicit authority, and never persists a caller-owned body.
 **Browser or compatible host with an injected DBOPFS adapter.** The adapter
 keeps the existing `get`, `set`, `getAllKeys`, and `delete` method names; Node
 can use the same class only through an explicitly imported runtime module and a
-compatible storage adapter; SDK `0.2.1` publishes no Node package subpath or
+compatible storage adapter; SDK `0.2.2` publishes no Node package subpath or
 Node storage implementation for it. Bootstrap uses a bounded concurrent
 generation, commits its manifest last, cleans partial data on failure, and
 rejects case-colliding IDs. Search

package/docs/reference/sdk-api.md

@@ -17,7 +17,7 @@ This table is the Node `package.json#exports` map: it defines package
 entrypoints for SDK/tooling code. It is distinct from the generated browser
 import map that resolves application-facing `arcane/*` modules and the focused
 EventManager entry. See [browser runtime delivery](protocols.md#browser-runtime-delivery)
-for that 91-entry physical-runtime contract in SDK `0.2.1`.
+for that 91-entry physical-runtime contract in SDK `0.2.2`.
 
 | Specifier | Purpose |
 | --- | --- |
@@ -47,7 +47,7 @@ Protocol mechanics are intentionally kept in the [deep protocol guide](protocols
 
 ## Canonical member inventory
 
-SDK `0.2.1` exports exactly 169 distinct JavaScript members across 13
+SDK `0.2.2` exports exactly 169 distinct JavaScript members across 13
 JavaScript entrypoints. The complete export map has 23 subpaths: the other 10
 are the runtime manifest, eight JSON Schemas, and package metadata. Runtime
 projection modules in the managed browser map are cataloged separately in
@@ -814,7 +814,7 @@ same deterministic map. The package root also contains the public
 {
   schemaVersion: 1,
   kind: 'arcane-app-runtime-projection',
-  sdkVersion: '0.2.1',
+  sdkVersion: '0.2.2',
   pathPrefix: 'arcane/',
   fileCount,
   totalBytes,
@@ -2698,7 +2698,7 @@ The import-map operation also reports the stable operation-specific strings
 `ARCANE_IMPORT_MAP_COLLISION`; package assembly can additionally report
 `ARCANE_IMPORT_MAP_CLEANUP_FAILED`. They are normalized `ArcaneError.code`
 values, but are not properties added to this frozen general registry in SDK
-`0.2.1`.
+`0.2.2`.
 
 ### Value and import
 
@@ -3364,7 +3364,7 @@ workspace it additionally returns the exact installed package authority:
     packageSource,
     canonicalPackageRoot,
     packageName: 'arcane-os',
-    packageVersion: '0.2.1',
+    packageVersion: '0.2.2',
     runtimeRoot,
     browserRuntimeRoot,
     runtimeManifest,
@@ -3374,9 +3374,9 @@ workspace it additionally returns the exact installed package authority:
 ```
 
 The dependency can be named `arcane-os` or be one exact npm alias for
-`npm:arcane-os@0.2.1`. The selected installation must still be one direct,
+`npm:arcane-os@0.2.2`. The selected installation must still be one direct,
 physical, non-link package directory whose manifest identifies exactly as
-`arcane-os@0.2.1`; duplicate canonical/alias declarations fail closed.
+`arcane-os@0.2.2`; duplicate canonical/alias declarations fail closed.
 `allowMissingManagedImportMap` is an internal packaging/development seam. An
 ordinary caller should leave it `false`.
 
@@ -3553,7 +3553,7 @@ const toolchain = createToolchain({
 
 // Only this explicit call refreshes the managed map and configured HTML entry.
 const result = await toolchain.importMap();
-console.log(result.importMap.entryCount); // 91 in SDK 0.2.1
+console.log(result.importMap.entryCount); // 91 in SDK 0.2.2
 console.log(result.importMap.documentPaths, result.importMap.documentCount);
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/runtime/ARCANE_RUNTIME_RELEASE.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "builder": "arcane-sdk-runtime-v1",
-  "sdkVersion": "0.2.2",
+  "sdkVersion": "0.2.3",
   "source": {
     "authority": "sdk-canonical",
     "repository": "https://github.com/TheWizardNexus/arcane-os-sdk.git",
@@ -14,8 +14,8 @@
     }
   },
   "fileCount": 160,
-  "totalBytes": 3643083,
-  "contentSha256": "0b09b1fd548152416f583d5e117197c7886b5a9e63071e43493577b4090e4a8c",
+  "totalBytes": 3655536,
+  "contentSha256": "f96a27bd79a809201708f73ca729bc60ab02696daf619365f77267a28b47b4b3",
   "files": [
     {
       "path": "arcane/components/app-bar.html",
@@ -159,8 +159,8 @@
     },
     {
       "path": "arcane/components/speech.html",
-      "bytes": 49596,
-      "sha256": "2a8b2929d28699ab9011f358b09b5fd2d53a0703542b2fee5cda8334261c6c86"
+      "bytes": 41300,
+      "sha256": "0ed5dd29c37747702f114114ad66bedd419fd39bed35fc12362c63c6357a41d9"
     },
     {
       "path": "arcane/components/summary-strip.html",
@@ -199,8 +199,8 @@
     },
     {
       "path": "arcane/components/voice-transcription.html",
-      "bytes": 14471,
-      "sha256": "7fab0ca767c252f661f7a3a5e09cf7325692b64a1d03e5731dc5d4f83c80c124"
+      "bytes": 26991,
+      "sha256": "8140b918791df5043be9254d52bf7864fe91759ab6e5e60af2364d6b4a8fcb7b"
     },
     {
       "path": "arcane/components/weather-widget.html",
@@ -494,8 +494,8 @@
     },
     {
       "path": "arcane/modules/ComponentContracts.js",
-      "bytes": 20507,
-      "sha256": "4115d4ce8081e1dbaeb0a1a2fa3201ecddabf05a471f76e4deb7a071f9c31d20"
+      "bytes": 28736,
+      "sha256": "f5ba011094835b45258ee833a90bfa17980e860ef9ceac88aa56ecad3abe9d53"
     },
     {
       "path": "arcane/modules/ConfiguredAIChatSession.js",

package/runtime/arcane/components/speech.html

@@ -156,6 +156,9 @@
         requestAIRuntimeIntent,
         subscribeAIRuntimeState
     } = await import('../modules/AIRuntimeState.js');
+    const {
+        createSTTActivationController
+    } = await import('../modules/ComponentContracts.js');
 
     const host = this;
     const shadowRoot = host.shadowRoot;
@@ -254,191 +257,6 @@
         )
     );
 
-    function createSTTActivationController({
-        host,
-        button,
-        onChange,
-        EventClass = CustomEvent
-    }) {
-        let role = null;
-        let requestPending = false;
-        let requestError = '';
-        let requestGeneration = 0;
-        let destroyed = false;
-
-        function visibleError(error, fallback) {
-            const message = typeof error?.message === 'string'
-                ? error.message.trim()
-                : '';
-            return (message || fallback).slice(0, 240);
-        }
-
-        function cancellation(error) {
-            return error?.name === 'AbortError'
-                || [
-                    'ARCANE_AI_REQUEST_ABORTED',
-                    'ARCANE_AI_OPERATION_SUPERSEDED'
-                ]
-                    .includes(error?.code);
-        }
-
-        function selected() {
-            return typeof role?.providerId === 'string'
-                && role.providerId.length > 0
-                && typeof role?.modelId === 'string'
-                && role.modelId.length > 0;
-        }
-
-        function action() {
-            if (!selected()) {
-                return null;
-            }
-            if (role.state === 'loading') {
-                return 'unload';
-            }
-            if (!role.busy && ['unloaded', 'error'].includes(role.state)) {
-                return 'load';
-            }
-            return null;
-        }
-
-        async function request(nextAction) {
-            if (destroyed || requestPending || action() !== nextAction) {
-                return false;
-            }
-            const generation = ++requestGeneration;
-            requestError = '';
-            const intent = Object.freeze(
-                {
-                    role: 'stt',
-                    action: nextAction,
-                    reason: 'user'
-                }
-            );
-            const activationRequest = Object.freeze({intent, state: role});
-            const activationEvent = new EventClass(
-                'speech-stt-activation-request',
-                {
-                    bubbles: true,
-                    composed: true,
-                    cancelable: true,
-                    detail: activationRequest
-                }
-            );
-            requestPending = true;
-            const accepted = host.dispatchEvent(activationEvent);
-            if (!accepted
-                || destroyed
-                || generation !== requestGeneration
-                || action() !== nextAction) {
-                if (!destroyed && generation === requestGeneration) {
-                    requestPending = false;
-                    onChange();
-                }
-                return false;
-            }
-            onChange();
-            try {
-                await host.requestSTTActivation(intent);
-                if (destroyed || generation !== requestGeneration) {
-                    return false;
-                }
-                return true;
-            } catch (error) {
-                if (destroyed || generation !== requestGeneration) {
-                    return false;
-                }
-                if (nextAction === 'load'
-                    && cancellation(error)
-                    && ['unloaded', 'unloading'].includes(role?.state)) {
-                    return false;
-                }
-                const message = visibleError(
-                    error,
-                    `The transcription ${nextAction} request failed.`
-                );
-                requestError = message;
-                host.dispatchEvent(
-                    new EventClass(
-                        'speech-stt-activation-error',
-                        {
-                            bubbles: true,
-                            composed: true,
-                            detail: Object.freeze(
-                                {
-                                    request: activationRequest,
-                                    error,
-                                    message
-                                }
-                            )
-                        }
-                    )
-                );
-                return false;
-            } finally {
-                if (!destroyed && generation === requestGeneration) {
-                    requestPending = false;
-                    onChange();
-                }
-            }
-        }
-
-        function activateSelectedSTT() {
-            const nextAction = action();
-            if (nextAction) {
-                void request(nextAction);
-            }
-        }
-
-        function synchronize(nextRole) {
-            if (destroyed) {
-                return;
-            }
-            if (role?.state !== nextRole.state
-                || role?.providerId !== nextRole.providerId
-                || role?.modelId !== nextRole.modelId
-                || role?.loaded !== nextRole.loaded
-                || role?.busy !== nextRole.busy
-                || role?.operationId !== nextRole.operationId) {
-                requestGeneration += 1;
-                requestError = '';
-                requestPending = false;
-            }
-            role = nextRole;
-        }
-
-        function destroy() {
-            if (destroyed) {
-                return;
-            }
-            destroyed = true;
-            requestGeneration += 1;
-            requestPending = false;
-            button.removeEventListener('click', activateSelectedSTT);
-        }
-
-        button.addEventListener('click', activateSelectedSTT);
-        return Object.freeze(
-            {
-                get action() {
-                    return action();
-                },
-                get error() {
-                    return requestError;
-                },
-                get pending() {
-                    return requestPending;
-                },
-                get selected() {
-                    return selected();
-                },
-                request,
-                synchronize,
-                destroy
-            }
-        );
-    }
-
     function unavailableRole(role) {
         return Object.freeze(
             {
@@ -598,10 +416,7 @@
     function renderControls() {
         const transcriptionReady = sttRole.state === 'ready';
         const microphoneReady = host.availability.microphone;
-        const activationVisible = sttActivationController.selected
-            && sttRole.state !== 'ready'
-            && ['unloaded', 'loading', 'unloading', 'error']
-                .includes(sttRole.state);
+        const activationVisible = sttActivationController.visible;
         recordButton.hidden = activationVisible;
         recordButton.disabled = !transcriptionReady
             || !microphoneReady
@@ -620,8 +435,8 @@
             || sttActivationController.pending
             || sttRole.state === 'unloading'
             || sttActivationController.action === null;
-        sttActivationButton.textContent = transcriptionActivationLabel();
-        sttActivationButton.title = transcriptionActivationTitle();
+        sttActivationButton.textContent = sttActivationController.label;
+        sttActivationButton.title = sttActivationController.title;
         sttActivationButton.setAttribute(
             'aria-label',
             sttActivationButton.title
@@ -636,41 +451,6 @@
         renderTTSControl();
     }
 
-    function transcriptionActivationLabel() {
-        if (sttActivationController.pending) {
-            return 'Requesting…';
-        }
-        if (sttRole.state === 'loading') {
-            return 'Cancel loading';
-        }
-        if (sttRole.state === 'unloading') {
-            return 'Canceling…';
-        }
-        if (sttRole.state === 'error') {
-            return 'Try again';
-        }
-        return 'Start transcription';
-    }
-
-    function transcriptionActivationTitle() {
-        if (sttActivationController.pending) {
-            return 'Requesting transcription activation.';
-        }
-        if (sttRole.state === 'loading') {
-            return 'Cancel loading the selected transcription service.';
-        }
-        if (sttRole.state === 'unloading') {
-            return 'The selected transcription service is being released.';
-        }
-        if (sttRole.state === 'error') {
-            return sttActivationController.error || visibleErrorMessage(
-                sttRole.error,
-                'Retry loading the selected transcription service.'
-            );
-        }
-        return 'Start the selected transcription service.';
-    }
-
     function transcriptionButtonTitle() {
         if (destroyed || sttRole.state === 'disposed') {
             return 'Transcription is unavailable.';
@@ -776,34 +556,10 @@
     }
 
     function describeSTTRole() {
-        if (sttActivationController.error) {
-            return `Transcription activation error: ${sttActivationController.error}.`;
-        }
-        if (sttActivationController.pending) {
-            return 'Transcription activation requested.';
-        }
-        if (sttRole.state === 'ready') {
-            if (!host.availability.microphone) {
-                return 'Microphone unavailable.';
-            }
-            return sttRole.busy ? 'Transcription busy.' : 'Transcription ready.';
-        }
-        if (sttRole.state === 'loading') {
-            return `Transcription ${formatRoleProgress(sttRole.progress, 'loading')}; Cancel is available.`;
-        }
-        if (sttRole.state === 'unloading') {
-            return `Transcription ${formatRoleProgress(sttRole.progress, 'releasing')}.`;
-        }
-        if (sttRole.state === 'error') {
-            return `Transcription error: ${visibleErrorMessage(sttRole.error, 'Unknown error')}.`;
-        }
-        if (sttRole.state === 'disposed') {
-            return 'Transcription disposed.';
-        }
-        if (sttRole.state === 'unloaded' && sttActivationController.selected) {
-            return 'Transcription selected and waiting to load.';
+        if (sttRole.state === 'ready' && !host.availability.microphone) {
+            return 'Microphone unavailable.';
         }
-        return 'Transcription unavailable.';
+        return sttActivationController.status;
     }
 
     function describeTTSRole() {