@mentra/miniapp 0.3.0-beta.0

package/dist/modules/system.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview SystemModule — OS-level utilities (share, open URL, clipboard, download).
+ *
+ * These bridge to native phone capabilities via LocalMiniappRuntime.
+ */
+import { MiniappRequestType } from "../protocol";
+export class SystemModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** Open the OS share sheet with the given content. */
+    async share(options) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.SHARE,
+            ...options,
+        });
+        return result ?? { success: false };
+    }
+    /** Open a URL in the system browser. Blocks dangerous schemes (javascript:, file:). */
+    openUrl(url) {
+        this.session.sendOneShot({
+            type: MiniappRequestType.OPEN_URL,
+            url,
+        });
+    }
+    /** Copy text to the system clipboard. */
+    async copyToClipboard(text) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.COPY_CLIPBOARD,
+            text,
+        });
+    }
+    /** Download a file. Opens the OS share sheet so user can choose save location. */
+    async download(options) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.DOWNLOAD,
+            ...options,
+        });
+        return result ?? { success: false };
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/modules/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/modules/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAiChD,MAAM,OAAO,YAAY;IACvB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,sDAAsD;IACtD,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAc;YACzD,IAAI,EAAE,kBAAkB,CAAC,KAAK;YAC9B,GAAG,OAAO;SACX,CAAC,CAAA;QACF,OAAO,MAAM,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACrC,CAAC;IAED,uFAAuF;IACvF,OAAO,CAAC,GAAW;QACjB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACvB,IAAI,EAAE,kBAAkB,CAAC,QAAQ;YACjC,GAAG;SACJ,CAAC,CAAA;IACJ,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACnC,IAAI,EAAE,kBAAkB,CAAC,cAAc;YACvC,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAiB;YAC5D,IAAI,EAAE,kBAAkB,CAAC,QAAQ;YACjC,GAAG,OAAO;SACX,CAAC,CAAA;QACF,OAAO,MAAM,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACrC,CAAC;CACF"}

package/dist/modules/transcription.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview TranscriptionModule — top-level transcription API.
+ *
+ * Mirrors cloud SDK v3's TranscriptionManager:
+ *
+ *   session.transcription.on(handler)                                // auto-detect
+ *   session.transcription.forLanguage("en-US", handler)              // single language
+ *   session.transcription.forLanguage(["en-US", "es-ES"], handler)   // multi-language
+ *   session.transcription.configure({languageHints, vocabulary, diarization})
+ *   session.transcription.stop()                                     // tear down all
+ *
+ * Hoisted to top-level (vs. nested under `session.mic`) because transcription
+ * is a domain in its own right, not a microphone-input event. The `mic`
+ * module still exposes lower-level audio chunks + VAD; this module is for
+ * "give me text from speech."
+ *
+ * MICROPHONE permission must be declared in miniapp.json. The phone runtime
+ * rejects with PERMISSION_NOT_DECLARED otherwise.
+ */
+import { MiniappSession } from "../session";
+import type { TranscriptionData, UnsubscribeFn } from "./events";
+/** Configuration for cloud-side transcription behavior. */
+export interface TranscriptionConfig {
+    /** ISO 639-1 language hints to improve detection accuracy (e.g. ["en", "ja"]). */
+    languageHints?: string[];
+    /** Custom vocabulary / boosted terms (e.g. ["MentraOS", "HIPAA"]). */
+    vocabulary?: string[];
+    /** Enable speaker diarisation. Defaults vary by provider. */
+    diarization?: boolean;
+}
+export interface TranscriptionOptions {
+    /**
+     * Use only on-device STT for this listener; never deliver cloud transcripts.
+     * Other listeners on the same stream keep their own routing choice. Requires
+     * a downloaded local STT model.
+     */
+    forceLocal?: boolean;
+}
+export declare class TranscriptionModule {
+    private readonly session;
+    private readonly unsubs;
+    private currentConfig;
+    constructor(session: MiniappSession);
+    /**
+     * Subscribe to all transcription events (auto-detect language). The
+     * detected language is in `data.language`.
+     *
+     * Wire-level: subscribes to `transcription:auto`. Today's wildcard fan-out
+     * (handlers on `transcription:auto` receive any `transcription:<lang>`
+     * event) preserves existing semantics.
+     */
+    on(handler: (data: TranscriptionData) => void, options?: TranscriptionOptions): UnsubscribeFn;
+    /**
+     * Subscribe to transcription for one or more specific languages. Each call
+     * is independent; multiple can be active simultaneously.
+     *
+     * @param language - BCP-47 tag(s), e.g. `"en-US"` or `["en-US", "es-ES"]`.
+     * @param handler  - Called for every event in any of the listed languages.
+     */
+    forLanguage(language: string | string[], handler: (data: TranscriptionData) => void, options?: TranscriptionOptions): UnsubscribeFn;
+    /**
+     * Apply transcription configuration (language hints, custom vocabulary,
+     * diarisation toggle). Sent to the cloud immediately. Cached locally so we
+     * could re-send on reconnect (future).
+     */
+    configure(config: TranscriptionConfig): void;
+    /** Tear down every transcription subscription this module owns. */
+    stop(): void;
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    /** @internal — current config, read by tests / future reconnect logic. */
+    _getConfig(): TranscriptionConfig | null;
+    private track;
+}
+//# sourceMappingURL=transcription.d.ts.map

package/dist/modules/transcription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription.d.ts","sourceRoot":"","sources":["../../src/modules/transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,iBAAiB,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAE9D,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,aAAa,CAAmC;gBAE3B,OAAO,EAAE,cAAc;IAEpD;;;;;;;OAOG;IACH,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa;IAMjG;;;;;;OAMG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,EAC1C,OAAO,GAAE,oBAAyB,GACjC,aAAa;IA0BhB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAQ5C,mEAAmE;IACnE,IAAI,IAAI,IAAI;IAWZ,mEAAmE;IACnE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,0EAA0E;IAC1E,UAAU,IAAI,mBAAmB,GAAG,IAAI;IAMxC,OAAO,CAAC,KAAK;CAOd"}

package/dist/modules/transcription.js

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview TranscriptionModule — top-level transcription API.
+ *
+ * Mirrors cloud SDK v3's TranscriptionManager:
+ *
+ *   session.transcription.on(handler)                                // auto-detect
+ *   session.transcription.forLanguage("en-US", handler)              // single language
+ *   session.transcription.forLanguage(["en-US", "es-ES"], handler)   // multi-language
+ *   session.transcription.configure({languageHints, vocabulary, diarization})
+ *   session.transcription.stop()                                     // tear down all
+ *
+ * Hoisted to top-level (vs. nested under `session.mic`) because transcription
+ * is a domain in its own right, not a microphone-input event. The `mic`
+ * module still exposes lower-level audio chunks + VAD; this module is for
+ * "give me text from speech."
+ *
+ * MICROPHONE permission must be declared in miniapp.json. The phone runtime
+ * rejects with PERMISSION_NOT_DECLARED otherwise.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class TranscriptionModule {
+    constructor(session) {
+        this.session = session;
+        this.unsubs = new Set();
+        this.currentConfig = null;
+    }
+    /**
+     * Subscribe to all transcription events (auto-detect language). The
+     * detected language is in `data.language`.
+     *
+     * Wire-level: subscribes to `transcription:auto`. Today's wildcard fan-out
+     * (handlers on `transcription:auto` receive any `transcription:<lang>`
+     * event) preserves existing semantics.
+     */
+    on(handler, options = {}) {
+        return this.track(this.session._subscribe(`${MiniappStreamType.TRANSCRIPTION}:auto`, handler, options));
+    }
+    /**
+     * Subscribe to transcription for one or more specific languages. Each call
+     * is independent; multiple can be active simultaneously.
+     *
+     * @param language - BCP-47 tag(s), e.g. `"en-US"` or `["en-US", "es-ES"]`.
+     * @param handler  - Called for every event in any of the listed languages.
+     */
+    forLanguage(language, handler, options = {}) {
+        const langs = Array.isArray(language) ? language : [language];
+        if (langs.length === 0)
+            return () => { };
+        const unsubs = [];
+        for (const lang of langs) {
+            unsubs.push(this.session._subscribe(`${MiniappStreamType.TRANSCRIPTION}:${lang}`, handler, options));
+        }
+        const combined = () => {
+            for (const u of unsubs) {
+                try {
+                    u();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        };
+        return this.track(combined);
+    }
+    /**
+     * Apply transcription configuration (language hints, custom vocabulary,
+     * diarisation toggle). Sent to the cloud immediately. Cached locally so we
+     * could re-send on reconnect (future).
+     */
+    configure(config) {
+        this.currentConfig = { ...config };
+        this.session.sendOneShot({
+            type: MiniappRequestType.TRANSCRIPTION_CONFIG,
+            config: { ...config },
+        });
+    }
+    /** Tear down every transcription subscription this module owns. */
+    stop() {
+        for (const u of this.unsubs) {
+            try {
+                u();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.unsubs.clear();
+    }
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("MICROPHONE");
+    }
+    /** @internal — current config, read by tests / future reconnect logic. */
+    _getConfig() {
+        return this.currentConfig ? { ...this.currentConfig } : null;
+    }
+    // ------------------------------------------------------------------------
+    track(unsub) {
+        this.unsubs.add(unsub);
+        return () => {
+            this.unsubs.delete(unsub);
+            unsub();
+        };
+    }
+}
+//# sourceMappingURL=transcription.js.map

package/dist/modules/transcription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription.js","sourceRoot":"","sources":["../../src/modules/transcription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAuBjE,MAAM,OAAO,mBAAmB;IAI9B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAHnC,WAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;QAC1C,kBAAa,GAA+B,IAAI,CAAA;IAED,CAAC;IAExD;;;;;;;OAOG;IACH,EAAE,CAAC,OAA0C,EAAE,UAAgC,EAAE;QAC/E,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,aAAa,OAAO,EAAE,OAAkC,EAAE,OAAO,CAAC,CAChH,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CACT,QAA2B,EAC3B,OAA0C,EAC1C,UAAgC,EAAE;QAElC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;QAEvC,MAAM,MAAM,GAAoB,EAAE,CAAA;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CAAC,UAAU,CACrB,GAAG,iBAAiB,CAAC,aAAa,IAAI,IAAI,EAAE,EAC5C,OAAkC,EAClC,OAAO,CACR,CACF,CAAA;QACH,CAAC;QACD,MAAM,QAAQ,GAAkB,GAAG,EAAE;YACnC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,CAAC,EAAE,CAAA;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,MAA2B;QACnC,IAAI,CAAC,aAAa,GAAG,EAAC,GAAG,MAAM,EAAC,CAAA;QAChC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACvB,IAAI,EAAE,kBAAkB,CAAC,oBAAoB;YAC7C,MAAM,EAAE,EAAC,GAAG,MAAM,EAAC;SACpB,CAAC,CAAA;IACJ,CAAC;IAED,mEAAmE;IACnE,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,CAAC,EAAE,CAAA;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED,mEAAmE;IACnE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAA;IAC1D,CAAC;IAED,0EAA0E;IAC1E,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAC,GAAG,IAAI,CAAC,aAAa,EAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5D,CAAC;IAED,2EAA2E;IAEnE,KAAK,CAAC,KAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACtB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACzB,KAAK,EAAE,CAAA;QACT,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/modules/translation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview TranslationModule — top-level translation API.
+ *
+ * Mirrors cloud SDK v3's TranslationManager surface:
+ *
+ *   session.translation.on(handler)                          // any pair
+ *   session.translation.to(target, handler)                  // any-source → target
+ *   session.translation.to([targets], handler)               // any-source → many
+ *   session.translation.fromTo(source, target, handler)      // specific pair
+ *   session.translation.fromTo(source, [targets], handler)   // source → many
+ *   session.translation.stop()                                // tear down all
+ *
+ * Internally each subscribe registers against a `translation:<source>:<target>`
+ * stream pattern; LocalMiniappRuntime's wildcard matcher routes incoming
+ * `translation:<src>:<dst>` events to any matching `*` patterns.
+ *
+ * MICROPHONE permission required.
+ */
+import { MiniappSession } from "../session";
+import type { TranslationData, UnsubscribeFn } from "./events";
+export type TranslationHandler = (data: TranslationData) => void;
+export declare class TranslationModule {
+    private readonly session;
+    private readonly unsubs;
+    constructor(session: MiniappSession);
+    /**
+     * Subscribe to every translation event from the cloud, regardless of
+     * source or target language.
+     *
+     * Uses the wildcard stream `translation:*:*` — cheap to register on the
+     * client, expensive on the cloud side (cloud fans every active pair out
+     * to this subscriber). Prefer `to` or `fromTo` when you know the
+     * language(s) you care about.
+     */
+    on(handler: TranslationHandler): UnsubscribeFn;
+    /**
+     * Subscribe to any translation that lands at the given target language(s),
+     * regardless of source. Useful for "I'm a Spanish speaker, translate
+     * whatever I hear to Spanish."
+     */
+    to(target: string | string[], handler: TranslationHandler): UnsubscribeFn;
+    /**
+     * Subscribe to a specific source → target translation pair. Pass an
+     * array for `target` to fan a single handler across multiple targets
+     * from the same source.
+     */
+    fromTo(source: string, target: string | string[], handler: TranslationHandler): UnsubscribeFn;
+    /**
+     * @deprecated Renamed to `fromTo(source, target, handler)` for cloud
+     * SDK v3 parity. This alias will be removed in a future release.
+     */
+    forLanguagePair(fromLang: string, toLang: string, handler: TranslationHandler): UnsubscribeFn;
+    /** Tear down every translation subscription this module owns. */
+    stop(): void;
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    private track;
+}
+//# sourceMappingURL=translation.d.ts.map

package/dist/modules/translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../src/modules/translation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAE5D,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;AAEhE,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAErB,OAAO,EAAE,cAAc;IAEpD;;;;;;;;OAQG;IACH,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAS9C;;;;OAIG;IACH,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,aAAa;IAwBzE;;;;OAIG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,OAAO,EAAE,kBAAkB,GAC1B,aAAa;IAwBhB;;;OAGG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC1B,aAAa;IAIhB,iEAAiE;IACjE,IAAI,IAAI,IAAI;IAWZ,mEAAmE;IACnE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAID,OAAO,CAAC,KAAK;CAOd"}

package/dist/modules/translation.js

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview TranslationModule — top-level translation API.
+ *
+ * Mirrors cloud SDK v3's TranslationManager surface:
+ *
+ *   session.translation.on(handler)                          // any pair
+ *   session.translation.to(target, handler)                  // any-source → target
+ *   session.translation.to([targets], handler)               // any-source → many
+ *   session.translation.fromTo(source, target, handler)      // specific pair
+ *   session.translation.fromTo(source, [targets], handler)   // source → many
+ *   session.translation.stop()                                // tear down all
+ *
+ * Internally each subscribe registers against a `translation:<source>:<target>`
+ * stream pattern; LocalMiniappRuntime's wildcard matcher routes incoming
+ * `translation:<src>:<dst>` events to any matching `*` patterns.
+ *
+ * MICROPHONE permission required.
+ */
+import { MiniappStreamType } from "../protocol";
+export class TranslationModule {
+    constructor(session) {
+        this.session = session;
+        this.unsubs = new Set();
+    }
+    /**
+     * Subscribe to every translation event from the cloud, regardless of
+     * source or target language.
+     *
+     * Uses the wildcard stream `translation:*:*` — cheap to register on the
+     * client, expensive on the cloud side (cloud fans every active pair out
+     * to this subscriber). Prefer `to` or `fromTo` when you know the
+     * language(s) you care about.
+     */
+    on(handler) {
+        return this.track(this.session._subscribe(`${MiniappStreamType.TRANSLATION}:*:*`, handler));
+    }
+    /**
+     * Subscribe to any translation that lands at the given target language(s),
+     * regardless of source. Useful for "I'm a Spanish speaker, translate
+     * whatever I hear to Spanish."
+     */
+    to(target, handler) {
+        const targets = Array.isArray(target) ? target : [target];
+        if (targets.length === 0)
+            return () => { };
+        const unsubs = [];
+        for (const t of targets) {
+            unsubs.push(this.session._subscribe(`${MiniappStreamType.TRANSLATION}:*:${t}`, handler));
+        }
+        const composite = () => {
+            for (const u of unsubs) {
+                try {
+                    u();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        };
+        return this.track(composite);
+    }
+    /**
+     * Subscribe to a specific source → target translation pair. Pass an
+     * array for `target` to fan a single handler across multiple targets
+     * from the same source.
+     */
+    fromTo(source, target, handler) {
+        const targets = Array.isArray(target) ? target : [target];
+        if (targets.length === 0)
+            return () => { };
+        const unsubs = [];
+        for (const t of targets) {
+            unsubs.push(this.session._subscribe(`${MiniappStreamType.TRANSLATION}:${source}:${t}`, handler));
+        }
+        const composite = () => {
+            for (const u of unsubs) {
+                try {
+                    u();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        };
+        return this.track(composite);
+    }
+    /**
+     * @deprecated Renamed to `fromTo(source, target, handler)` for cloud
+     * SDK v3 parity. This alias will be removed in a future release.
+     */
+    forLanguagePair(fromLang, toLang, handler) {
+        return this.fromTo(fromLang, toLang, handler);
+    }
+    /** Tear down every translation subscription this module owns. */
+    stop() {
+        for (const u of this.unsubs) {
+            try {
+                u();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.unsubs.clear();
+    }
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("MICROPHONE");
+    }
+    // ------------------------------------------------------------------------
+    track(unsub) {
+        this.unsubs.add(unsub);
+        return () => {
+            this.unsubs.delete(unsub);
+            unsub();
+        };
+    }
+}
+//# sourceMappingURL=translation.js.map

package/dist/modules/translation.js.map

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

package/dist/modules/ui.d.ts

@@ -0,0 +1,186 @@
+/**
+ * session.ui — bus between a background JSContext miniapp and its
+ * on-demand UI WebView. Supports two interaction patterns:
+ *
+ *   1. **Broadcast** (fire-and-forget, either direction)
+ *      - background → UI: `session.ui.send(channel, payload)`
+ *      - UI → background: `mentra.send(channel, payload)`
+ *      - subscribe:        `session.ui.on(channel, cb)` / `mentra.on(channel, cb)`
+ *
+ *   2. **RPC** (request/response, UI → background only)
+ *      - UI side:          `await mentra.request(channel, payload, options?)`
+ *      - background side:  `session.ui.handle(channel, (payload, ctx?) => result)`
+ *      - single handler per channel; double-register throws synchronously.
+ *      - errors thrown in the handler reject the caller's promise.
+ *      - cancellation via `options.signal` aborts the handler's `ctx.signal`
+ *        and drops the eventual reply.
+ *
+ * Broadcast vs. RPC is declared at the channel level: wrap a channel's
+ * payload type in `Rpc<Req, Res>` in the shared registry to make it RPC.
+ * Wrong-API-for-channel is a compile-time error.
+ *
+ * Buffering:
+ *   - `mentra.send` BUFFERS until `mentra.ready()` acks. The WebView is
+ *     the short-lived side and shouldn't drop user input.
+ *   - `session.ui.send` silently DROPS when no WebView is bound.
+ *     Background is the source of truth; UI state shouldn't accumulate.
+ *   - Per-channel inbound buffering (up to 32 payloads) covers the
+ *     `controller pushed before React attached the listener` race — see
+ *     the WebView shim for details.
+ *
+ * Wire envelopes (internal — not part of the SDK surface):
+ *   - `UI_OPEN` — WebView posted `{type:"ready"}`.
+ *   - `UI_CLOSE` — host tore down the WebView.
+ *   - `UI_MESSAGE` — WebView → background. `requestId` set on RPC calls.
+ *   - `UI_SEND` — background → WebView. `requestId` set on RPC replies.
+ *   - `UI_CANCEL` — either direction. Carries only `requestId`; aborts
+ *     the in-flight handler's signal.
+ */
+import type { MiniappSession } from "../session";
+export type UIChannelHandler<T = unknown> = (payload: T) => void;
+export type UIUnsubscribe = () => void;
+/**
+ * Brand for declaring an RPC channel in the shared Channels registry.
+ *
+ * Wrap a channel's payload type in `Rpc<Req, Res>` to mark it as
+ * request/response. The SDK's `mentra.request` / `session.ui.handle`
+ * accept only `Rpc<...>` channels; `mentra.send` / `session.ui.on`
+ * accept only non-RPC channels. Using the wrong API for the wrong
+ * channel is a compile-time error.
+ *
+ *   export interface Channels {
+ *     "live-transcript": {text: string}                    // broadcast
+ *     "compute-route":   Rpc<RouteOpts, RouteResult>       // RPC
+ *   }
+ */
+declare const __rpc_brand: unique symbol;
+export type Rpc<Req, Res> = {
+    readonly [__rpc_brand]: true;
+    readonly req: Req;
+    readonly res: Res;
+};
+/** True if `T` is an `Rpc<...>` channel entry. */
+export type IsRpc<T> = T extends Rpc<unknown, unknown> ? true : false;
+/** Request payload type of an `Rpc<Req, Res>` entry. */
+export type RpcReq<T> = T extends Rpc<infer Req, unknown> ? Req : never;
+/** Response payload type of an `Rpc<Req, Res>` entry. */
+export type RpcRes<T> = T extends Rpc<unknown, infer Res> ? Res : never;
+/** Options accepted by `mentra.request`. */
+export interface RpcRequestOptions {
+    /** Abort the in-flight call. Sends UI_CANCEL to the handler. */
+    signal?: AbortSignal;
+    /** Reject with `MentraRpcTimeoutError` after this many ms. No default. */
+    timeout?: number;
+}
+/** Context passed as the optional 2nd arg to an `ui.handle` handler. */
+export interface RpcHandlerContext {
+    /** Aborts when the UI side cancels the call (or its timeout fires). */
+    signal: AbortSignal;
+}
+/**
+ * Error thrown by `mentra.request` when the handler threw or returned an
+ * error envelope. Plain `Error` subclass — distinguished by `err.name`.
+ * `err.cause` is `{code?: string}` if the handler attached one.
+ */
+export declare class MentraRpcError extends Error {
+    constructor(message: string, options?: {
+        cause?: {
+            code?: string;
+        };
+    });
+}
+/** Thrown by `mentra.request` when its `{timeout}` elapses. */
+export declare class MentraRpcTimeoutError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Public surface mirrored on `session.ui`. Generic over a `Channels`
+ * type-map so miniapps importing the typed `shared/channels.ts` get
+ * compile-time enforcement on channel names + payload shapes.
+ *
+ * Broadcast vs. RPC channels are distinguished at the type level:
+ *   - Channel value `Rpc<Req, Res>` → only `handle()` accepts it on
+ *     background; only `mentra.request(...)` accepts it on UI.
+ *   - Channel value anything else   → only `send()`/`on()` accept it
+ *     on both sides.
+ *
+ * The default `Record<string, unknown>` mapping lets unannotated usage
+ * compile — the SDK doesn't impose a registry of its own.
+ */
+export interface UIModule<TChannels extends object = Record<string, unknown>> {
+    /** True iff a WebView is currently bound to this miniapp. */
+    isOpen(): boolean;
+    /**
+     * Subscribe to the "WebView mounted + ready()" lifecycle event. If
+     * a WebView is already mounted when subscribe() is called, the
+     * handler fires immediately for the current binding.
+     */
+    onOpen(cb: () => void): UIUnsubscribe;
+    /**
+     * Subscribe to the "WebView unmounted" lifecycle event. Fires once
+     * per close; if no WebView is bound at subscribe time the handler
+     * stays armed for the next mount → close cycle.
+     */
+    onClose(cb: () => void): UIUnsubscribe;
+    /**
+     * Broadcast a typed message to the bound WebView. Silently drops if
+     * no WebView is bound. Compile-error if `C` is an RPC channel.
+     */
+    send<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? never : C, payload: TChannels[C]): void;
+    /**
+     * Subscribe to broadcast messages from the bound WebView. Returns an
+     * unsubscribe fn. Compile-error if `C` is an RPC channel — use
+     * `handle()` for RPC channels.
+     */
+    on<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? never : C, cb: UIChannelHandler<TChannels[C]>): UIUnsubscribe;
+    /**
+     * Register the single handler for an RPC channel. The UI side calls
+     * `mentra.request(channel, payload, options?)`; this handler resolves
+     * the call.
+     *
+     * Throws synchronously if a handler is already registered for the
+     * channel. Returns a deregister fn that removes the handler.
+     *
+     * Compile-error if `C` is a broadcast (non-Rpc) channel.
+     */
+    handle<C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? C : never, handler: (payload: RpcReq<TChannels[C]>, ctx?: RpcHandlerContext) => Promise<RpcRes<TChannels[C]>> | RpcRes<TChannels[C]>): UIUnsubscribe;
+}
+export interface RpcErrorEnvelope {
+    message: string;
+    code?: string;
+    stage?: string;
+    transport?: string;
+}
+export declare class UIModuleImpl<TChannels extends object = Record<string, unknown>> implements UIModule<TChannels> {
+    private readonly session;
+    /** True between UI_OPEN and the matching UI_CLOSE. */
+    private bound;
+    /** Monotonic outbound seq number. Reset on bind. */
+    private nextSeq;
+    /** Open-lifecycle handlers — fire on every UI_OPEN. */
+    private readonly openHandlers;
+    private readonly closeHandlers;
+    /** channel → set of subscribers. */
+    private readonly channelHandlers;
+    /** channel → single registered RPC handler. */
+    private readonly rpcHandlers;
+    /** requestId → AbortController for in-flight RPC handler invocations. */
+    private readonly inflightRpc;
+    constructor(session: MiniappSession);
+    isOpen: () => boolean;
+    onOpen: (cb: () => void) => UIUnsubscribe;
+    onClose: (cb: () => void) => UIUnsubscribe;
+    send: <C extends keyof TChannels & string>(channel: C, payload: TChannels[C]) => void;
+    on: <C extends keyof TChannels & string>(channel: C, cb: UIChannelHandler<TChannels[C]>) => UIUnsubscribe;
+    handle: <C extends keyof TChannels & string>(channel: IsRpc<TChannels[C]> extends true ? C : never, handler: (payload: RpcReq<TChannels[C]>, ctx?: RpcHandlerContext) => Promise<RpcRes<TChannels[C]>> | RpcRes<TChannels[C]>) => UIUnsubscribe;
+    /** Fire every registered open handler once. Guarded per-handler. */
+    private fireOpenHandlers;
+    /** @internal — handle UI_OPEN / UI_CLOSE / UI_MESSAGE envelopes from the host. */
+    private handleInbound;
+    /** @internal — invoke a registered RPC handler and send back the reply. */
+    private dispatchRpcCall;
+    /** @internal — send a UI_SEND envelope tagged with a requestId. */
+    private sendRpcReply;
+}
+export {};
+//# sourceMappingURL=ui.d.ts.map

package/dist/modules/ui.d.ts.map

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