@mihe-dev/js 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Neek Digital Solutions Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,115 @@
-# Temporary Holding Version
+# @mihe-dev/js
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Mihe is an assistant you embed in your web app. It knows your screens,
+components and actions, and it operates the app for your users, under your
+own permission model: it finds things, opens screens, fills in and points
+at forms, and runs actions, asking for approval wherever you say it must.
+Users can type or talk to it.
+
+This is the framework-free package: plain JavaScript or TypeScript, for Vue,
+Svelte, Angular, server-rendered pages, or no framework at all. For React,
+use `@mihe-dev/react`, which is built on this one.
+
+## Install
+
+```bash
+npm install @mihe-dev/js
+```
+
+The package is ES modules with TypeScript types, and has no dependencies
+beyond `@mihe-dev/protocol`.
+
+No build step? It also ships as one self-contained file, for WordPress, a
+server-rendered page or a plain `static/` folder:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@mihe-dev/js@0.1.0/dist/mihe.iife.min.js"></script>
+<script>
+  const mihe = Mihe.createMihe({ url: "wss://runtime.mihe.dev/v1/ws", publicKey: "pk_live_…", getUserToken });
+  Mihe.mountWidget(mihe);
+</script>
+```
+
+`dist/mihe.min.js` is the same as an ES module. Pin the version in the URL,
+or copy the file into your site.
+
+## A first integration
+
+```ts
+import { createMihe } from "@mihe-dev/js";
+
+const mihe = createMihe({
+  url: "wss://runtime.mihe.dev/v1/ws",
+  publicKey: "pk_live_…",
+  // Your server mints this token for the signed-in user, signed with your
+  // app secret. It carries who they are and what they may do.
+  getUserToken: () => fetch("/api/mihe/token").then((r) => r.text()),
+  navigate: (route) => { location.hash = route; },
+  // Refetch what the page shows after the assistant changes data.
+  onActionComplete: () => refresh(),
+});
+
+// On each page: tell the assistant where the user is and what they can see.
+// Keep the returned function and call it when they leave.
+const leave = mihe.setScreen({
+  screenId: "orders.list",
+  route: "/orders",
+  title: "Orders",
+  visibleData: { pending: 16 },
+});
+```
+
+Every `set…` and `register…` method returns a function that removes what it
+declared. Calling one again with the same id updates the declaration rather
+than adding a second.
+
+```ts
+mihe.registerComponent(button, "orders.new", { type: "button", label: "New order" });
+mihe.registerAction("print_receipt", ({ orderId }) => printReceipt(orderId));
+mihe.registerTable({
+  id: "orders.table",
+  label: "Orders",
+  columns: [{ key: "number", label: "Order" }, { key: "total", label: "Total" }],
+  rows: orders,
+  rowId: (order) => order.id,
+  rowIdName: "orderId",
+});
+mihe.bindTrigger(document.querySelector("#ask")!);
+```
+
+The widget is `<mihe-assistant>`, a web component in its own shadow root,
+so your page's CSS can't reach it:
+
+```ts
+import { mountWidget } from "@mihe-dev/js";
+
+mountWidget(mihe);                                           // the orb
+mountWidget(mihe, { form: "classic" });                      // launcher and panel
+mountWidget(mihe, { layout: "inline", container: sidebar }); // the panel, in your layout
+```
+
+Theme it with `--mihe-accent`, `--mihe-radius` and `--mihe-font` on the
+`mihe-assistant` element. If your page already has a floating widget in the
+same corner, such as a support chat, lift Mihe above it:
+`mountWidget(mihe, { offset: { bottom: 92 } })`.
+
+Or draw your own UI. State is a snapshot you subscribe to:
+
+```ts
+mihe.subscribe(() => render(mihe.getState()));
+mihe.send("How many orders are pending?");
+```
+
+Create an app and its keys in the [dashboard](https://app.mihe.dev), then
+follow the [quickstart](https://mihe.dev/docs/quickstart).
+
+## Documentation
+
+- [Quickstart](https://mihe.dev/docs/quickstart)
+- [SDK reference](https://mihe.dev/docs/sdk-reference)
+- [Security](https://mihe.dev/docs/security): what the assistant can and
+  cannot do, and why
+
+## License
+
+MIT © Neek Digital Solutions Ltd

package/dist/audio.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Microphone capture and speaker playback for voice sessions.
+ *
+ * One format everywhere: **16-bit PCM, 24 kHz, mono, little endian**, matching
+ * the voice socket and the provider behind it. Nothing on this path transcodes,
+ * which is the point — a resampler in a latency-critical loop buys nothing when
+ * every participant already agrees on the rate.
+ *
+ * Two browser realities shape the code:
+ *
+ * - **iOS Safari will not start audio without a user gesture.** Push-to-talk
+ *   makes that free: the button press *is* the gesture. `resume()` is called on
+ *   press rather than at construction for exactly this reason, and calling it
+ *   from anywhere else will produce a context stuck in `suspended` with no
+ *   error.
+ * - **`AudioContext` may refuse the sample rate we ask for.** Chrome, Firefox,
+ *   and current Safari honour it; older Safari does not. So capture resamples
+ *   when it has to rather than assuming, and playback hands the browser a
+ *   buffer tagged 24 kHz and lets the graph resample it.
+ */
+/** Float samples in [-1, 1] to little-endian 16-bit PCM. */
+export declare function toPcm16(samples: Float32Array): ArrayBuffer;
+/** Little-endian 16-bit PCM back to float samples. */
+export declare function fromPcm16(buffer: ArrayBuffer): Float32Array;
+/**
+ * How loud a chunk of speech is, from 0 (silence) to 1 (as loud as speech gets).
+ *
+ * RMS rather than peak, because a peak jumps on every consonant and a ring
+ * drawn from it flickers instead of breathing. Scaled by eye: ordinary speech
+ * into a laptop microphone sits around 0.05 to 0.15 RMS, so a square root and
+ * a gain put a normal voice in the middle of the range rather than at its foot.
+ */
+export declare function pcmLevel(pcm: ArrayBuffer): number;
+/**
+ * Linear resample, used only when the browser refused our sample rate.
+ *
+ * Linear rather than anything better on purpose: the input is a voice at
+ * 44.1 or 48 kHz going to 24 kHz, the output is fed to a speech model rather
+ * than to a listener, and a windowed-sinc filter would cost more than it could
+ * possibly be worth here. When the rates already match this is not called at
+ * all.
+ */
+export declare function resample(samples: Float32Array, fromRate: number, toRate: number): Float32Array;
+/**
+ * The microphone, as a stream of PCM frames.
+ *
+ * Capture runs continuously once started and is *gated* rather than stopped
+ * between utterances: `getUserMedia` takes hundreds of milliseconds and shows a
+ * permission prompt the first time, so tearing it down on every button release
+ * would clip the beginning of the next sentence — which is exactly where the
+ * word the model needs most usually is.
+ */
+export declare class MicrophoneCapture {
+    private readonly onFrame;
+    private context;
+    private stream;
+    private node;
+    private source;
+    private open;
+    constructor(onFrame: (pcm: ArrayBuffer) => void);
+    /** True while frames are being delivered. */
+    get capturing(): boolean;
+    /**
+     * Ask for the microphone and build the graph. Must be called from a user
+     * gesture on iOS Safari.
+     */
+    start(): Promise<void>;
+    /** Begin delivering frames. */
+    unmute(): void;
+    /** Stop delivering frames, without releasing the microphone. */
+    mute(): void;
+    /** Release the device and tear down the graph. */
+    stop(): Promise<void>;
+}
+/**
+ * The assistant's voice, as a queue of scheduled buffers.
+ *
+ * Chunks are scheduled back to back against the audio clock rather than played
+ * on arrival, because `AudioBufferSourceNode.start()` with no time argument
+ * plays *now* — and forty of those a second produce overlapping speech. The
+ * running `nextStart` cursor is what turns a stream of chunks into continuous
+ * audio.
+ */
+export declare class SpeakerQueue {
+    private readonly onLevel?;
+    /**
+     * Called with each chunk's level at the moment it starts playing, not when
+     * it arrives. The provider streams seconds ahead of the speaker, so a level
+     * taken on arrival would animate words the user has not heard yet.
+     */
+    constructor(onLevel?: ((level: number) => void) | undefined);
+    private levelTimers;
+    private context;
+    private gain;
+    private sources;
+    /** Audio-clock time the next chunk should begin at. */
+    private nextStart;
+    /** Audio-clock time the current run of speech began. */
+    private startedAt;
+    /** Must be called from a user gesture on iOS Safari. */
+    start(): Promise<void>;
+    /** Queue a chunk of assistant speech. */
+    enqueue(pcm: ArrayBuffer): void;
+    /**
+     * How much of the current utterance the user has actually heard, in
+     * milliseconds.
+     *
+     * This is the number the runtime needs to truncate the model's history on a
+     * barge-in, and it is not the same as how much has been *received*: the
+     * provider streams several seconds ahead of the speaker, so trusting bytes
+     * delivered would tell the model the user heard a sentence they were
+     * interrupted three words into.
+     */
+    heardMs(): number;
+    /** True while anything is scheduled or playing. */
+    get speaking(): boolean;
+    /** Drop everything queued — an interruption, or the end of a session. */
+    flush(): void;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../js/src/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmEH,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAU1D;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAOjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,YAAY,CAed;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAOhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,IAAI,CAAuD;IACnE,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,IAAI,CAAS;gBAEQ,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI;IAEhE,6CAA6C;IAC7C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE5B,+BAA+B;IAC/B,MAAM,IAAI,IAAI;IAId,gEAAgE;IAChE,IAAI,IAAI,IAAI;IAIZ,kDAAkD;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IALrC;;;;OAIG;gBAC0B,OAAO,CAAC,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,aAAA;IAE9D,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAAoC;IACnD,uDAAuD;IACvD,OAAO,CAAC,SAAS,CAAK;IACtB,wDAAwD;IACxD,OAAO,CAAC,SAAS,CAAK;IAEtB,wDAAwD;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,yCAAyC;IACzC,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAgD/B;;;;;;;;;OASG;IACH,OAAO,IAAI,MAAM;IAMjB,mDAAmD;IACnD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,yEAAyE;IACzE,KAAK,IAAI,IAAI;IAmBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/audio.js

@@ -0,0 +1,377 @@
+/**
+ * Microphone capture and speaker playback for voice sessions.
+ *
+ * One format everywhere: **16-bit PCM, 24 kHz, mono, little endian**, matching
+ * the voice socket and the provider behind it. Nothing on this path transcodes,
+ * which is the point — a resampler in a latency-critical loop buys nothing when
+ * every participant already agrees on the rate.
+ *
+ * Two browser realities shape the code:
+ *
+ * - **iOS Safari will not start audio without a user gesture.** Push-to-talk
+ *   makes that free: the button press *is* the gesture. `resume()` is called on
+ *   press rather than at construction for exactly this reason, and calling it
+ *   from anywhere else will produce a context stuck in `suspended` with no
+ *   error.
+ * - **`AudioContext` may refuse the sample rate we ask for.** Chrome, Firefox,
+ *   and current Safari honour it; older Safari does not. So capture resamples
+ *   when it has to rather than assuming, and playback hands the browser a
+ *   buffer tagged 24 kHz and lets the graph resample it.
+ */
+import { VOICE_SAMPLE_RATE } from "@mihe-dev/protocol";
+/**
+ * Frames sent up per second. 50 works out to 20 ms per frame — small enough
+ * that the end of an utterance is not padded by a buffer waiting to fill, and
+ * large enough that the socket is not doing a send per millisecond.
+ */
+const FRAME_MS = 20;
+/**
+ * Playback runs this far ahead of the speaker.
+ *
+ * Without it every chunk that arrives a few milliseconds late produces an
+ * audible click as the graph runs dry between buffers. With it, network jitter
+ * up to this much is inaudible, at the cost of the same delay before the first
+ * word. 200 ms is well under the threshold where a reply feels slow.
+ */
+const JITTER_BUFFER_MS = 200;
+/** The AudioWorklet processor, injected as a Blob so the package ships one file. */
+const CAPTURE_WORKLET = `
+class MiheCapture extends AudioWorkletProcessor {
+  constructor(options) {
+    super();
+    // A render quantum is 128 samples — about 5 ms at 24 kHz — so posting one
+    // per call means roughly 190 messages a second, each becoming its own
+    // WebSocket frame and its own JSON envelope upstream. Under push-to-talk
+    // that was merely wasteful; with the microphone open continuously it
+    // saturated the relay and audio started being dropped, which reads to the
+    // user as the assistant simply not answering.
+    // Defaulted rather than assumed. An absent option would make \`target\`
+    // undefined, every arithmetic result NaN, and the fill loop exit without
+    // ever posting — total silence, no error, and nothing in any log to say
+    // the microphone had stopped working.
+    this.target = options?.processorOptions?.frameSamples || 480;
+    this.buffer = new Float32Array(this.target);
+    this.filled = 0;
+  }
+
+  process(inputs) {
+    const channel = inputs[0] && inputs[0][0];
+    // No input yet, or the track ended. Keep the node alive either way:
+    // returning false here permanently removes it from the graph, and the
+    // user is only between utterances.
+    if (!channel) return true;
+
+    let offset = 0;
+    while (offset < channel.length) {
+      const take = Math.min(this.target - this.filled, channel.length - offset);
+      this.buffer.set(channel.subarray(offset, offset + take), this.filled);
+      this.filled += take;
+      offset += take;
+
+      if (this.filled === this.target) {
+        this.port.postMessage(this.buffer.slice());
+        this.filled = 0;
+      }
+    }
+
+    return true;
+  }
+}
+registerProcessor('mihe-capture', MiheCapture);
+`;
+/** Float samples in [-1, 1] to little-endian 16-bit PCM. */
+export function toPcm16(samples) {
+    const buffer = new ArrayBuffer(samples.length * 2);
+    const view = new DataView(buffer);
+    for (let i = 0; i < samples.length; i += 1) {
+        // Clamped before scaling: a sample above 1 would wrap to a large negative
+        // number, which is heard as a loud click rather than as clipping.
+        const clamped = Math.max(-1, Math.min(1, samples[i] ?? 0));
+        view.setInt16(i * 2, clamped * 0x7fff, true);
+    }
+    return buffer;
+}
+/** Little-endian 16-bit PCM back to float samples. */
+export function fromPcm16(buffer) {
+    const view = new DataView(buffer);
+    const samples = new Float32Array(buffer.byteLength / 2);
+    for (let i = 0; i < samples.length; i += 1) {
+        samples[i] = view.getInt16(i * 2, true) / 0x7fff;
+    }
+    return samples;
+}
+/**
+ * How loud a chunk of speech is, from 0 (silence) to 1 (as loud as speech gets).
+ *
+ * RMS rather than peak, because a peak jumps on every consonant and a ring
+ * drawn from it flickers instead of breathing. Scaled by eye: ordinary speech
+ * into a laptop microphone sits around 0.05 to 0.15 RMS, so a square root and
+ * a gain put a normal voice in the middle of the range rather than at its foot.
+ */
+export function pcmLevel(pcm) {
+    const samples = fromPcm16(pcm);
+    if (samples.length === 0)
+        return 0;
+    let sum = 0;
+    for (const sample of samples)
+        sum += sample * sample;
+    const rms = Math.sqrt(sum / samples.length);
+    return Math.min(1, Math.sqrt(rms) * 1.8);
+}
+/**
+ * Linear resample, used only when the browser refused our sample rate.
+ *
+ * Linear rather than anything better on purpose: the input is a voice at
+ * 44.1 or 48 kHz going to 24 kHz, the output is fed to a speech model rather
+ * than to a listener, and a windowed-sinc filter would cost more than it could
+ * possibly be worth here. When the rates already match this is not called at
+ * all.
+ */
+export function resample(samples, fromRate, toRate) {
+    if (fromRate === toRate)
+        return samples;
+    const ratio = fromRate / toRate;
+    const length = Math.floor(samples.length / ratio);
+    const out = new Float32Array(length);
+    for (let i = 0; i < length; i += 1) {
+        const position = i * ratio;
+        const index = Math.floor(position);
+        const next = Math.min(index + 1, samples.length - 1);
+        const fraction = position - index;
+        out[i] = (samples[index] ?? 0) * (1 - fraction) + (samples[next] ?? 0) * fraction;
+    }
+    return out;
+}
+/**
+ * The microphone, as a stream of PCM frames.
+ *
+ * Capture runs continuously once started and is *gated* rather than stopped
+ * between utterances: `getUserMedia` takes hundreds of milliseconds and shows a
+ * permission prompt the first time, so tearing it down on every button release
+ * would clip the beginning of the next sentence — which is exactly where the
+ * word the model needs most usually is.
+ */
+export class MicrophoneCapture {
+    onFrame;
+    context = null;
+    stream = null;
+    node = null;
+    source = null;
+    open = false;
+    constructor(onFrame) {
+        this.onFrame = onFrame;
+    }
+    /** True while frames are being delivered. */
+    get capturing() {
+        return this.open;
+    }
+    /**
+     * Ask for the microphone and build the graph. Must be called from a user
+     * gesture on iOS Safari.
+     */
+    async start() {
+        if (this.context) {
+            await this.context.resume();
+            return;
+        }
+        this.stream = await navigator.mediaDevices.getUserMedia({
+            audio: {
+                channelCount: 1,
+                // All three on: the assistant's own voice comes out of the same device
+                // in a hands-free session, and without cancellation the model hears
+                // itself and answers its own last sentence.
+                echoCancellation: true,
+                noiseSuppression: true,
+                autoGainControl: true,
+            },
+        });
+        const context = new AudioContext({ sampleRate: VOICE_SAMPLE_RATE });
+        this.context = context;
+        this.source = context.createMediaStreamSource(this.stream);
+        const deliver = (samples) => {
+            if (!this.open)
+                return;
+            this.onFrame(toPcm16(resample(samples, context.sampleRate, VOICE_SAMPLE_RATE)));
+        };
+        try {
+            const url = URL.createObjectURL(new Blob([CAPTURE_WORKLET], { type: "application/javascript" }));
+            await context.audioWorklet.addModule(url);
+            URL.revokeObjectURL(url);
+            const worklet = new AudioWorkletNode(context, "mihe-capture", {
+                processorOptions: {
+                    // Measured in the context's own samples: the resample to 24 kHz
+                    // happens after this, on the main thread.
+                    frameSamples: Math.round((context.sampleRate * FRAME_MS) / 1000),
+                },
+            });
+            worklet.port.onmessage = (event) => deliver(event.data);
+            this.source.connect(worklet);
+            // Worklets are not pulled unless something downstream asks for their
+            // output. A zero-gain node is the standard way to run the graph without
+            // routing the microphone to the speaker.
+            const sink = context.createGain();
+            sink.gain.value = 0;
+            worklet.connect(sink).connect(context.destination);
+            this.node = worklet;
+        }
+        catch {
+            // Older Safari, and any browser that blocks Blob worklet modules under a
+            // strict CSP. Deprecated but universally present, and it runs on the
+            // main thread, which for one mono voice track is fine.
+            const frames = Math.max(256, 2 ** Math.round(Math.log2((context.sampleRate * FRAME_MS) / 1000)));
+            const processor = context.createScriptProcessor(frames, 1, 1);
+            processor.onaudioprocess = (event) => deliver(new Float32Array(event.inputBuffer.getChannelData(0)));
+            this.source.connect(processor);
+            processor.connect(context.destination);
+            this.node = processor;
+        }
+        await context.resume();
+    }
+    /** Begin delivering frames. */
+    unmute() {
+        this.open = true;
+    }
+    /** Stop delivering frames, without releasing the microphone. */
+    mute() {
+        this.open = false;
+    }
+    /** Release the device and tear down the graph. */
+    async stop() {
+        this.open = false;
+        this.node?.disconnect();
+        this.source?.disconnect();
+        this.stream?.getTracks().forEach((track) => track.stop());
+        await this.context?.close().catch(() => undefined);
+        this.node = null;
+        this.source = null;
+        this.stream = null;
+        this.context = null;
+    }
+}
+/**
+ * The assistant's voice, as a queue of scheduled buffers.
+ *
+ * Chunks are scheduled back to back against the audio clock rather than played
+ * on arrival, because `AudioBufferSourceNode.start()` with no time argument
+ * plays *now* — and forty of those a second produce overlapping speech. The
+ * running `nextStart` cursor is what turns a stream of chunks into continuous
+ * audio.
+ */
+export class SpeakerQueue {
+    onLevel;
+    /**
+     * Called with each chunk's level at the moment it starts playing, not when
+     * it arrives. The provider streams seconds ahead of the speaker, so a level
+     * taken on arrival would animate words the user has not heard yet.
+     */
+    constructor(onLevel) {
+        this.onLevel = onLevel;
+    }
+    levelTimers = new Set();
+    context = null;
+    gain = null;
+    sources = new Set();
+    /** Audio-clock time the next chunk should begin at. */
+    nextStart = 0;
+    /** Audio-clock time the current run of speech began. */
+    startedAt = 0;
+    /** Must be called from a user gesture on iOS Safari. */
+    async start() {
+        if (this.context) {
+            await this.context.resume();
+            return;
+        }
+        const context = new AudioContext({ sampleRate: VOICE_SAMPLE_RATE });
+        this.gain = context.createGain();
+        this.gain.connect(context.destination);
+        this.context = context;
+        await context.resume();
+    }
+    /** Queue a chunk of assistant speech. */
+    enqueue(pcm) {
+        const context = this.context;
+        if (!context || !this.gain)
+            return;
+        const samples = fromPcm16(pcm);
+        if (samples.length === 0)
+            return;
+        // Tagged 24 kHz regardless of the context's own rate, so a browser that
+        // refused our request resamples on playback instead of playing the
+        // assistant at the wrong pitch.
+        const buffer = context.createBuffer(1, samples.length, VOICE_SAMPLE_RATE);
+        buffer.getChannelData(0).set(samples);
+        const source = context.createBufferSource();
+        source.buffer = buffer;
+        source.connect(this.gain);
+        const now = context.currentTime;
+        if (this.nextStart < now) {
+            // Either the first chunk of an utterance or a gap the network opened up.
+            // Restarting the cursor ahead of `now` is what the jitter buffer is:
+            // scheduling at `now` exactly means anything arriving late is already
+            // too late.
+            this.nextStart = now + JITTER_BUFFER_MS / 1000;
+            this.startedAt = this.nextStart;
+        }
+        source.start(this.nextStart);
+        if (this.onLevel) {
+            const level = pcmLevel(pcm);
+            const report = this.onLevel;
+            const timer = setTimeout(() => {
+                this.levelTimers.delete(timer);
+                report(level);
+            }, Math.max(0, (this.nextStart - now) * 1000));
+            this.levelTimers.add(timer);
+        }
+        this.nextStart += buffer.duration;
+        this.sources.add(source);
+        source.onended = () => this.sources.delete(source);
+    }
+    /**
+     * How much of the current utterance the user has actually heard, in
+     * milliseconds.
+     *
+     * This is the number the runtime needs to truncate the model's history on a
+     * barge-in, and it is not the same as how much has been *received*: the
+     * provider streams several seconds ahead of the speaker, so trusting bytes
+     * delivered would tell the model the user heard a sentence they were
+     * interrupted three words into.
+     */
+    heardMs() {
+        if (!this.context || this.startedAt === 0)
+            return 0;
+        const heard = this.context.currentTime - this.startedAt;
+        return Math.max(0, Math.round(heard * 1000));
+    }
+    /** True while anything is scheduled or playing. */
+    get speaking() {
+        return this.sources.size > 0;
+    }
+    /** Drop everything queued — an interruption, or the end of a session. */
+    flush() {
+        for (const source of this.sources) {
+            try {
+                source.stop();
+            }
+            catch {
+                // Already ended. `stop()` on a finished node throws in some browsers.
+            }
+        }
+        this.sources.clear();
+        this.nextStart = 0;
+        this.startedAt = 0;
+        // Levels for audio that will now never play, and a last zero so a ring
+        // following them settles instead of freezing mid-word.
+        for (const timer of this.levelTimers)
+            clearTimeout(timer);
+        this.levelTimers.clear();
+        this.onLevel?.(0);
+    }
+    async stop() {
+        this.flush();
+        this.gain?.disconnect();
+        await this.context?.close().catch(() => undefined);
+        this.gain = null;
+        this.context = null;
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

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

package/dist/chart.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Chart summaries, worked out where the numbers are (amendment 67, step 4).
+ *
+ * The model explains a trend from these figures, so it is handed the start,
+ * end, high, low, total and largest steps rather than a list to do arithmetic
+ * over, which models get wrong.
+ */
+import type { ChartPoint, SeriesSummary } from "@mihe-dev/protocol";
+export declare function summarise(points: ChartPoint[], ordered: boolean): SeriesSummary | undefined;
+/**
+ * At most `limit` points, evenly spaced, keeping both ends. The summary
+ * already carries the high and low, which thinning could skip.
+ */
+export declare function thin<T>(points: T[], limit: number): T[];
+//# sourceMappingURL=chart.d.ts.map