@corenel/tools-web 0.4.6 → 0.4.8

package/dist/speech/model.js

@@ -0,0 +1,135 @@
+/* The dictation model's lifecycle: is it here, get it here, remove it.
+ *
+ * Deliberately separate from session.ts because it has a SECOND CONSUMER that
+ * never opens a microphone -- the Settings row prefetches on wifi, reports what
+ * is stored, and clears it. Folding this into the session would make that row
+ * reach through a dictation object it has no use for.
+ *
+ * The two pieces of state here are different things and are stored differently:
+ *
+ *   INTENT   (localStorage) -- the user said yes to the download.
+ *   PRESENCE (Cache Storage) -- the bytes are actually on this device.
+ *
+ * Intent deliberately outlives presence. Browsers evict Cache Storage under
+ * memory pressure without telling the page, and someone who has already
+ * consented must not be asked again because the browser reclaimed some space --
+ * the model just re-downloads on next use. */
+import { SPEECH_MODEL_ID } from './protocol';
+import { sharedSpeechEngine } from './engine';
+export { SPEECH_MODEL_ID };
+/** Where the user's consent is remembered. */
+export const INTENT_KEY = 'prompd.web.speech.enabled';
+/** transformers.js keeps downloaded weights here. */
+const CACHE_NAME = 'transformers-cache';
+export function createModelHost({ caches, storage, loadPipeline, onEvict }) {
+    /* The in-flight load, so three surfaces asking at once download once. Cleared
+     * on failure -- a rejected promise cached here would turn one offline blip
+     * into a permanently broken button. */
+    let loading = null;
+    /* The warmed pipeline. Presence in memory is NOT presence on disk: isCached()
+     * still probes, because this says nothing about a later eviction. */
+    let warmed = null;
+    const modelUrls = async () => {
+        const cache = await caches.open(CACHE_NAME);
+        const keys = await cache.keys();
+        return keys.map((k) => k.url).filter((u) => u.includes(SPEECH_MODEL_ID));
+    };
+    return {
+        isEnabled: () => storage.getItem(INTENT_KEY) === '1',
+        setEnabled: (on) => {
+            if (on)
+                storage.setItem(INTENT_KEY, '1');
+            else
+                storage.removeItem(INTENT_KEY);
+        },
+        /* A REAL PROBE EVERY TIME. The tempting optimisation -- remember the answer
+         * -- is the bug this module exists to avoid: a remembered `true` after an
+         * eviction makes the caller skip the download and then wait forever for a
+         * model that is not there. */
+        isCached: async () => {
+            try {
+                /* THE WEIGHTS, not merely "something for this model".
+                 *
+                 * Matching any cached URL containing the model id counted config.json,
+                 * tokenizer_config.json and friends -- so a download that died after the
+                 * small metadata files reported "Ready on this site", skipped the
+                 * consent prompt, and left the button waiting on weights that were never
+                 * there. Observed in a real cache: the metadata lands in milliseconds,
+                 * the two .onnx files are ~28MB and take far longer, so the window where
+                 * this lies is the entire download. */
+                const urls = await modelUrls();
+                const onnx = urls.filter((u) => u.endsWith('.onnx'));
+                return onnx.some((u) => /encoder/i.test(u)) && onnx.some((u) => /decoder/i.test(u));
+            }
+            catch {
+                // No Cache Storage (private mode, blocked site data): treat as absent
+                // rather than throwing. The model simply downloads again.
+                return false;
+            }
+        },
+        ensureModel: (onProgress) => {
+            if (warmed)
+                return Promise.resolve();
+            if (loading)
+                return loading;
+            loading = loadPipeline(onProgress)
+                .then((p) => { warmed = p; })
+                .catch((e) => {
+                // Let the next caller try again rather than inheriting this failure.
+                loading = null;
+                throw e;
+            });
+            return loading;
+        },
+        /* Deletes only OUR entries. The transformers cache is shared -- nuking the
+         * whole thing would evict any other model the app has downloaded. */
+        evict: async () => {
+            try {
+                const cache = await caches.open(CACHE_NAME);
+                const urls = await modelUrls();
+                await Promise.all(urls.map((u) => cache.delete(u)));
+            }
+            catch {
+                // Nothing to remove if the cache is unavailable.
+            }
+            warmed = null;
+            loading = null;
+            onEvict?.();
+        },
+    };
+}
+/* ONE HOST PER PAGE.
+ *
+ * The composer's mic button and the Settings row are two views of the same
+ * thing. Given separate hosts they would disagree: Settings clears the model,
+ * the button's own instance still holds a warmed pipeline and happily records;
+ * or Settings prefetches and the button still believes nothing is downloaded.
+ *
+ * Created LAZILY rather than at module scope -- touching `caches` or
+ * `localStorage` at import time runs in every test and every worker that pulls
+ * this module in transitively, which is exactly how import-time side effects
+ * poison things that never asked for them. */
+let shared = null;
+export function browserModelHost() {
+    if (!shared)
+        shared = createBrowserModelHost();
+    return shared;
+}
+/** The browser's real host.
+ *
+ * WARMS THE WORKER, NOT THE MAIN THREAD. An earlier version built a pipeline
+ * here, on the main thread, purely so it could watch a download -- then threw it
+ * away and let the worker build its own. That duplicated the expensive part
+ * (ONNX instantiation, graph compilation) and did it in the one place the worker
+ * exists to protect. Warming the shared engine means the thing that gets warmed
+ * is the thing that transcribes, and the Settings prefetch now genuinely makes
+ * the first dictation fast rather than only pre-filling the HTTP cache. */
+export function createBrowserModelHost() {
+    return createModelHost({
+        caches: globalThis.caches,
+        storage: globalThis.localStorage,
+        loadPipeline: (onProgress) => sharedSpeechEngine().load(onProgress),
+        onEvict: () => sharedSpeechEngine().dispose(),
+    });
+}
+//# sourceMappingURL=model.js.map

package/dist/speech/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../speech/model.ts"],"names":[],"mappings":"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"}

package/dist/speech/protocol.d.ts

@@ -0,0 +1,38 @@
+/** The model the browser downloads and runs. English-only by design: Moonshine's
+ * other languages are separate monolingual models, i.e. separate downloads. */
+export declare const SPEECH_MODEL_ID = "onnx-community/moonshine-tiny-ONNX";
+/** The pipeline's input contract: mono PCM at this rate. Both the capture and
+ * the worker resample to it, so it lives where both can see it. */
+export declare const SAMPLE_RATE = 16000;
+export type MainToWorker = {
+    kind: 'load';
+} | {
+    kind: 'audio';
+    pcm: Float32Array;
+} | {
+    kind: 'flush';
+};
+export type WorkerToMain = {
+    kind: 'ready';
+}
+/** Download progress, whole percent. Reported from the WORKER because the
+ * worker is what fetches the weights -- the main thread no longer builds a
+ * pipeline of its own just to observe a download. */
+ | {
+    kind: 'progress';
+    pct: number;
+}
+/** A revisable guess. Never reaches the draft -- see session.ts. */
+ | {
+    kind: 'interim';
+    text: string;
+}
+/** Committed text, safe to append to what the user is writing. */
+ | {
+    kind: 'final';
+    text: string;
+} | {
+    kind: 'error';
+    message: string;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/speech/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../speech/protocol.ts"],"names":[],"mappings":"AAQA;+EAC+E;AAC/E,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE;mEACmE;AACnE,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACnB;;qDAEqD;GACnD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AACnC,oEAAoE;GAClE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACnC,kEAAkE;GAChE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/speech/protocol.js

@@ -0,0 +1,14 @@
+/* The wire between the main thread and the dictation worker.
+ *
+ * Its own module because BOTH sides import it and neither may import the other:
+ * the worker must not drag the session's DOM code (getUserMedia, MediaStream)
+ * into a worker scope that has none, and the session must not drag the
+ * transformers pipeline onto the main thread, which is the whole reason the
+ * worker exists. */
+/** The model the browser downloads and runs. English-only by design: Moonshine's
+ * other languages are separate monolingual models, i.e. separate downloads. */
+export const SPEECH_MODEL_ID = 'onnx-community/moonshine-tiny-ONNX';
+/** The pipeline's input contract: mono PCM at this rate. Both the capture and
+ * the worker resample to it, so it lives where both can see it. */
+export const SAMPLE_RATE = 16000;
+//# sourceMappingURL=protocol.js.map

package/dist/speech/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../speech/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;oBAMoB;AAEpB;+EAC+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,oCAAoC,CAAC;AAEpE;mEACmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC"}

package/dist/speech/session.d.ts

@@ -0,0 +1,34 @@
+import { type SpeechEngine } from './engine';
+export type SpeechErrorKind = 'permission' | 'unsupported' | 'inference';
+export interface SpeechError {
+    kind: SpeechErrorKind;
+    message: string;
+}
+/** Pulls PCM off a live stream. Returned handle stops the pull. */
+export interface Capture {
+    stop(): void;
+}
+export type CreateCapture = (stream: MediaStream, onChunk: (pcm: Float32Array) => void) => Capture;
+export interface DictationOpts {
+    onInterim(text: string): void;
+    onFinal(text: string): void;
+    onError(e: SpeechError): void;
+    /** Injected in tests; defaults to the page's shared engine. */
+    engine?: SpeechEngine;
+    getMedia?: () => Promise<MediaStream>;
+    createCapture?: CreateCapture;
+    /** How long stop() waits for the tail transcript before giving up. A dead
+     * worker must not be able to wedge stop(); the microphone is already released
+     * by then, so the only thing at risk is the last sentence. */
+    flushTimeoutMs?: number;
+}
+export interface Dictation {
+    /** Acquire the mic, warm the engine, begin listening. Never rejects: a denial
+     * is a state the UI renders, not a crash it has to catch. */
+    start(): Promise<void>;
+    /** Flush the tail, release the mic. Idempotent, safe before start(). */
+    stop(): Promise<void>;
+}
+export declare const defaultCreateCapture: CreateCapture;
+export declare function createDictation(opts: DictationOpts): Dictation;
+//# sourceMappingURL=session.d.ts.map

package/dist/speech/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../speech/session.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;AACzE,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAEvE,mEAAmE;AACnE,MAAM,WAAW,OAAO;IAAG,IAAI,IAAI,IAAI,CAAA;CAAE;AACzC,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,KAAK,OAAO,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;kEAE8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB;iEAC6D;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,wEAAwE;IACxE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAyBD,eAAO,MAAM,oBAAoB,EAAE,aAsBlC,CAAC;AAcF,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAgK9D"}

package/dist/speech/session.js

@@ -0,0 +1,254 @@
+/* One dictation session: microphone in, text out.
+ *
+ * THE INVARIANT: the microphone is released on every terminal path. Stop,
+ * permission denial, a failed load, a worker crash, an inference error -- all of
+ * them run the same teardown. On-device dictation's whole claim is that nothing
+ * leaves the machine, and a mic left hot after a crash makes that claim false in
+ * a way the user cannot see.
+ *
+ * THE SECOND RULE: interim text never reaches the caller's draft. The worker
+ * revises its guesses as more audio arrives; only `final` is committed.
+ *
+ * WHAT THIS MODULE DOES NOT OWN: the worker. It borrows the page's shared
+ * SpeechEngine and hands it back on stop. An earlier version built and
+ * terminated a worker per dictation, which re-instantiated the ONNX runtime on
+ * every single click. Runs are cheap now; only the first one pays. */
+import { SAMPLE_RATE } from './protocol';
+import { sharedSpeechEngine } from './engine';
+const defaultGetMedia = () => navigator.mediaDevices.getUserMedia({ audio: true });
+/* Real capture: resample to the pipeline's contract (mono, 16kHz) and hand up
+ * Float32 frames. ScriptProcessor is deprecated but is the only node available
+ * without shipping a separate worklet file; the buffer is small and the work per
+ * frame is a copy.
+ *
+ * Exported so the two things below can actually be tested. Both were silent
+ * failures found from use, not from the suite.
+ *
+ * RESUME, ALWAYS. This context is constructed after two awaits -- the permission
+ * prompt and the engine warm-up -- so it is created well outside the user
+ * gesture that started dictation, and Chrome hands back a SUSPENDED context.
+ * A suspended context never fires onaudioprocess, so not one sample reaches the
+ * worker: the button says "Stop dictating", the microphone light is on, and
+ * nothing is ever transcribed.
+ *
+ * AND THE GRAPH MUST NOT END AT THE SPEAKERS. A ScriptProcessor only pulls while
+ * it is connected to something live, but connecting it to ctx.destination pipes
+ * the microphone straight back out of the speakers -- you hear yourself, with
+ * feedback if you are not on headphones. A zero-gain node keeps the graph pulling
+ * and outputs silence. */
+export const defaultCreateCapture = (stream, onChunk) => {
+    const ctx = new AudioContext({ sampleRate: SAMPLE_RATE });
+    // Fire-and-forget: resume() rejects only if the context is already closed,
+    // and a failure here must not take down a dictation that may still work.
+    if (ctx.state === 'suspended')
+        void ctx.resume().catch(() => { });
+    const source = ctx.createMediaStreamSource(stream);
+    const node = ctx.createScriptProcessor(4096, 1, 1);
+    const mute = ctx.createGain();
+    mute.gain.value = 0;
+    node.onaudioprocess = (e) => { onChunk(new Float32Array(e.inputBuffer.getChannelData(0))); };
+    source.connect(node);
+    node.connect(mute);
+    mute.connect(ctx.destination);
+    return {
+        stop: () => {
+            node.onaudioprocess = null;
+            node.disconnect();
+            mute.disconnect();
+            source.disconnect();
+            void ctx.close().catch(() => { });
+        },
+    };
+};
+/** Map a getUserMedia rejection onto something the UI can explain. */
+function mediaError(e) {
+    const name = e.name;
+    if (name === 'NotAllowedError' || name === 'PermissionDeniedError') {
+        return { kind: 'permission', message: 'Microphone permission was denied.' };
+    }
+    if (name === 'NotFoundError' || name === 'DevicesNotFoundError') {
+        return { kind: 'unsupported', message: 'No microphone was found.' };
+    }
+    return { kind: 'unsupported', message: 'The microphone is unavailable in this browser.' };
+}
+export function createDictation(opts) {
+    const engine = opts.engine ?? sharedSpeechEngine();
+    const getMedia = opts.getMedia ?? defaultGetMedia;
+    const createCapture = opts.createCapture ?? defaultCreateCapture;
+    const flushTimeoutMs = opts.flushTimeoutMs ?? 4000;
+    let stream = null;
+    let capture = null;
+    let unsubscribe = null;
+    let listening = false;
+    let running = false;
+    /* THE RUN GENERATION -- and the reason it is a counter rather than a boolean.
+     *
+     * A `disposed` flag cannot express "a stop arrived while start() was still
+     * awaiting the permission prompt". In that window there is nothing to tear
+     * down AND no way to say "do not finish starting either", so start() would
+     * resume after the user answered, open the microphone, and leave it live with
+     * no reachable handle to close it -- clicking again would begin a second,
+     * independent session rather than reaching the orphan.
+     *
+     * So every run claims a generation, every await in start() re-checks it, and
+     * stop() bumps it UNCONDITIONALLY. */
+    let gen = 0;
+    /** Release whatever a run holds. Never throws. Safe with partial state. */
+    function release(s, c) {
+        try {
+            c?.stop();
+        }
+        catch { /* releasing anyway */ }
+        // The microphone itself. This is the line that matters.
+        try {
+            s?.getTracks().forEach((t) => t.stop());
+        }
+        catch { /* releasing anyway */ }
+    }
+    /** The one teardown every terminal path runs. Bumping `gen` also cancels a
+     * start() sitting between its awaits. The ENGINE IS NOT DISPOSED -- it belongs
+     * to the page, and the next dictation reuses it warm. */
+    function teardown() {
+        gen += 1;
+        listening = false;
+        running = false;
+        unsubscribe?.();
+        unsubscribe = null;
+        const s = stream;
+        const c = capture;
+        stream = null;
+        capture = null;
+        release(s, c);
+    }
+    return {
+        async start() {
+            if (running)
+                return;
+            running = true;
+            const myGen = ++gen;
+            const stale = () => myGen !== gen;
+            // Mic FIRST. A denial must not warm an engine for a run that never starts.
+            let s;
+            try {
+                s = await getMedia();
+            }
+            catch (e) {
+                running = false;
+                opts.onError(mediaError(e));
+                return;
+            }
+            /* The window the generation exists for: stop() ran while the permission
+             * prompt was up. This run owns `s` and nothing else can see it. */
+            if (stale()) {
+                release(s, null);
+                return;
+            }
+            stream = s;
+            // Warm on the first dictation only; later ones resolve immediately.
+            try {
+                await engine.load();
+            }
+            catch (e) {
+                if (stale())
+                    return;
+                opts.onError({ kind: 'inference', message: e.message });
+                teardown();
+                return;
+            }
+            if (stale())
+                return;
+            unsubscribe = engine.subscribe((m) => {
+                if (myGen !== gen)
+                    return;
+                if (m.kind === 'interim') {
+                    opts.onInterim(m.text);
+                    return;
+                }
+                if (m.kind === 'final') {
+                    opts.onFinal(m.text);
+                    return;
+                }
+                if (m.kind === 'error') {
+                    opts.onError({ kind: 'inference', message: m.message });
+                    teardown();
+                }
+            }, () => {
+                if (myGen !== gen)
+                    return;
+                opts.onError({ kind: 'inference', message: 'The speech engine stopped unexpectedly.' });
+                teardown();
+            });
+            listening = true;
+            capture = createCapture(s, (pcm) => {
+                if (!listening || myGen !== gen)
+                    return;
+                engine.post({ kind: 'audio', pcm });
+            });
+        },
+        async stop() {
+            /* Nothing listening -- but STILL tear down, because this is what cancels a
+             * start() stuck at the permission prompt. A bare `return` here is what once
+             * left a microphone open with no handle to close it. */
+            if (!listening) {
+                teardown();
+                return;
+            }
+            // Stop feeding first, so the flush covers a fixed buffer rather than
+            // racing new frames into it.
+            listening = false;
+            try {
+                capture?.stop();
+            }
+            catch { /* tearing down anyway */ }
+            capture = null;
+            /* THE MICROPHONE GOES NOW, not after the tail arrives. Transcribing the
+             * last sentence takes a moment, and leaving the OS recording indicator lit
+             * for that long after the user pressed stop is the one thing this feature
+             * cannot do. The tail is computed from audio already captured; it does not
+             * need the device. */
+            const s = stream;
+            stream = null;
+            try {
+                s?.getTracks().forEach((t) => t.stop());
+            }
+            catch { /* releasing anyway */ }
+            /* Hand the tail to a DEDICATED subscriber. The run's own subscriber is
+             * dropped first so the final cannot be delivered twice, and this one
+             * unsubscribes the moment it has what it came for.
+             *
+             * stop() used to post the flush and tear down in the same tick, so the
+             * final came back to nobody -- every dictation silently discarded the last
+             * thing you said. */
+            await new Promise((resolve) => {
+                unsubscribe?.();
+                unsubscribe = null;
+                let settled = false;
+                let off = null;
+                let timer = null;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timer)
+                        clearTimeout(timer);
+                    off?.();
+                    resolve();
+                };
+                off = engine.subscribe((m) => {
+                    if (m.kind !== 'final')
+                        return;
+                    // An empty flush is what a stop with no speech in it produces; it is
+                    // not a transcript and must not reach the draft.
+                    const text = m.text.trim();
+                    if (text)
+                        opts.onFinal(text);
+                    finish();
+                }, () => finish());
+                timer = setTimeout(finish, flushTimeoutMs);
+                engine.post({ kind: 'flush' });
+            });
+            teardown();
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/speech/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../speech/session.ts"],"names":[],"mappings":"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"}

package/dist/speech/speechWorker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=speechWorker.d.ts.map

package/dist/speech/speechWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechWorker.d.ts","sourceRoot":"","sources":["../../speech/speechWorker.ts"],"names":[],"mappings":""}

package/dist/speech/speechWorker.js

@@ -0,0 +1,105 @@
+/* The dictation worker: ONNX inference off the main thread.
+ *
+ * Inference on the main thread would jank the composer while the user types --
+ * which is the one place this feature must not be felt, since the user is
+ * looking at the text as it lands.
+ *
+ * Interim vs final is decided HERE, and the rule is simple: everything produced
+ * while audio is still arriving is a revisable guess (`interim`); the flush at
+ * the end of a dictation produces the committed text (`final`). The main thread
+ * trusts that distinction absolutely -- only `final` reaches the user's draft. */
+import { SPEECH_MODEL_ID, SAMPLE_RATE } from './protocol';
+/* STATIC, not dynamic -- and that is deliberate.
+ *
+ * THIS FILE IS ITSELF THE LAZY BOUNDARY: the worker is constructed only when a
+ * dictation starts, so nothing here is fetched until then. A dynamic import
+ * inside it buys no extra laziness and costs the build outright -- it forces
+ * code-splitting in the worker bundle, and Vite emits workers as `iife` by
+ * default, which cannot code-split ("Invalid value 'iife' for option
+ * output.format"). The alternative was setting worker.format = 'es' globally in
+ * vite.shared.ts, which changes worker output for both apps and the existing
+ * agent worker to fix one module's mistake. */
+import { pipeline } from '@huggingface/transformers';
+let transcriber = null;
+/** Everything heard since the last flush, at SAMPLE_RATE. */
+let buffer = new Float32Array(0);
+/** Guards against a second inference starting while one is running -- they would
+ * queue up behind each other and interim text would fall further behind speech. */
+let busy = false;
+const post = (m) => { self.postMessage(m); };
+/** Re-transcribe roughly this often. Moonshine is built for short utterances, so
+ * re-running the whole buffer is cheap and avoids stitching partial windows. */
+const INTERIM_EVERY_SAMPLES = SAMPLE_RATE; // ~1s of speech
+let sinceInterim = 0;
+function append(pcm) {
+    const next = new Float32Array(buffer.length + pcm.length);
+    next.set(buffer, 0);
+    next.set(pcm, buffer.length);
+    buffer = next;
+}
+function textOf(out) {
+    const one = Array.isArray(out) ? out[0] : out;
+    return (one?.text ?? '').trim();
+}
+async function load() {
+    if (transcriber) {
+        post({ kind: 'ready' });
+        return;
+    }
+    try {
+        const p = await pipeline('automatic-speech-recognition', SPEECH_MODEL_ID, {
+            dtype: 'q8',
+            progress_callback: (x) => {
+                const pct = x.progress;
+                if (typeof pct === 'number')
+                    post({ kind: 'progress', pct: Math.round(pct) });
+            },
+        });
+        transcriber = p;
+        post({ kind: 'ready' });
+    }
+    catch (e) {
+        post({ kind: 'error', message: `The speech engine failed to load: ${e.message}` });
+    }
+}
+async function transcribe(final) {
+    if (!transcriber || buffer.length === 0) {
+        if (final)
+            post({ kind: 'final', text: '' });
+        return;
+    }
+    try {
+        const text = textOf(await transcriber(buffer));
+        if (final) {
+            post({ kind: 'final', text });
+            buffer = new Float32Array(0);
+            sinceInterim = 0;
+        }
+        else if (text) {
+            post({ kind: 'interim', text });
+        }
+    }
+    catch (e) {
+        post({ kind: 'error', message: `Transcription failed: ${e.message}` });
+    }
+}
+self.onmessage = (ev) => {
+    const m = ev.data;
+    if (m.kind === 'load') {
+        void load();
+        return;
+    }
+    if (m.kind === 'audio') {
+        append(m.pcm);
+        sinceInterim += m.pcm.length;
+        if (sinceInterim >= INTERIM_EVERY_SAMPLES && !busy) {
+            sinceInterim = 0;
+            busy = true;
+            void transcribe(false).finally(() => { busy = false; });
+        }
+        return;
+    }
+    if (m.kind === 'flush')
+        void transcribe(true);
+};
+//# sourceMappingURL=speechWorker.js.map

package/dist/speech/speechWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechWorker.js","sourceRoot":"","sources":["../../speech/speechWorker.ts"],"names":[],"mappings":"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"}

package/dist/workerClient.d.ts

@@ -10,6 +10,7 @@ import type { FileService } from '@corenel/protocol';
 import type { ToolDecl } from '@corenel/protocol';
 import type { IMemoryProvider } from '@corenel/protocol';
 import type { RunConstraints, Breach, BudgetState } from '@corenel/harness/core/budget';
+import type { ModelRouting } from '@corenel/harness/providers/gateway';
 /** Options for runNode — like RunOpts but the node's internal turns arrive via
  * onNodeEvent (the node-tagged stream); onEvent only ever sees a terminal error. */
 export interface RunNodeOpts {
@@ -141,6 +142,11 @@ export interface WorkerAgentOpts {
      * run. A getter so connecting/disconnecting a sidecar is picked up per run
      * without recreating the worker. Mirrors getFileService. */
     getRemoteTools?: () => ToolDecl[];
+    /** Model routing to carry to the worker per run (the setting and the custom
+     * providers live in localStorage/sessionStorage, which the worker cannot
+     * read). A getter so a Settings change applies to the next run without
+     * recreating the worker. Mirrors getGraphConfig. */
+    getModelRouting?: () => ModelRouting | undefined;
     /** Execute a sidecar tool by name on the main thread (which holds the WS
      * connection + governs). Answers the worker's tool-request. `signal` aborts
      * when the calling RUN aborts or ends — long host-side executions