@mentra/engine 0.1.0-beta.0

package/build/facades/reports.d.ts

@@ -0,0 +1,36 @@
+import type { ReportAttachmentInput, ReportContext, ReportStatus, SubmitReportInput } from "@mentra/cloud-client";
+export type { ReportAttachmentInput, ReportContext, ReportDetails, ReportStatus, ReportTrigger, } from "@mentra/cloud-client";
+export type EngineSubmitReportInput = (Omit<Extract<SubmitReportInput, {
+    kind: "bug";
+}>, "context"> & {
+    context?: Partial<ReportContext>;
+    screenshots?: ReportAttachmentInput[];
+}) | (Omit<Extract<SubmitReportInput, {
+    kind: "feedback";
+}>, "context"> & {
+    context?: Partial<ReportContext>;
+});
+export type EngineSubmitAutomaticReportInput = Omit<Extract<SubmitReportInput, {
+    kind: "automatic";
+}>, "context"> & {
+    context?: Partial<ReportContext>;
+    screenshots?: ReportAttachmentInput[];
+    throttleKey?: string;
+    throttleWindowMs?: number;
+};
+export type ReportSubmitResult = {
+    status: "submitted";
+    reportId: string;
+    reportStatus: ReportStatus;
+} | {
+    status: "skipped";
+    reason: "throttled_within_window";
+} | {
+    status: "failed";
+    error: string;
+};
+export declare const reports: {
+    submit(input: EngineSubmitReportInput): Promise<ReportSubmitResult>;
+};
+export declare function submitAutomaticReport(input: EngineSubmitAutomaticReportInput): Promise<ReportSubmitResult>;
+//# sourceMappingURL=reports.d.ts.map

package/build/facades/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAO7B,YAAY,EACV,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,uBAAuB,GAC/B,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,KAAK,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;CACtC,CAAC,GACF,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,UAAU,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;CACjC,CAAC,CAAA;AAEN,MAAM,MAAM,gCAAgC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;IAAC,IAAI,EAAE,WAAW,CAAA;CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IAChH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAID,MAAM,MAAM,kBAAkB,GAC1B;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAC,GACnE;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAC,GACtD;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAA;AA8HrC,eAAO,MAAM,OAAO;kBACJ,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGpE,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1G"}

package/build/facades/reports.js

@@ -0,0 +1,134 @@
+/**
+ * reports facade — `engine.reports`: user/system report submission over the
+ * Cloud V2 core client.
+ *
+ * Host/OEM code owns UI and wording. Engine owns MentraOS mechanics: context
+ * collection, recent phone logs, Cloud V2 calls, local automatic throttling,
+ * screenshots, and notifying connected glasses.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useGlassesStore } from "../stores/glasses";
+import { isGlassesConnected } from "../services/GlassesReadiness";
+import { cloudClientService } from "../services/CloudClientService";
+import { collectDiagnosticContext } from "../utils/diagnosticContext";
+import { logBuffer } from "../utils/devLogging";
+const DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS = 90_000;
+const automaticReportThrottleRegistry = new Map();
+function automaticThrottleShouldSkip(key, nowMs, windowMs) {
+    const previous = automaticReportThrottleRegistry.get(key);
+    if (previous !== undefined && nowMs - previous < windowMs) {
+        return true;
+    }
+    pruneAutomaticThrottleRegistry(nowMs, windowMs);
+    return false;
+}
+function markAutomaticThrottleSuccess(key, nowMs, windowMs) {
+    automaticReportThrottleRegistry.set(key, nowMs);
+    pruneAutomaticThrottleRegistry(nowMs, windowMs);
+}
+function pruneAutomaticThrottleRegistry(nowMs, windowMs) {
+    for (const [entryKey, entryTime] of automaticReportThrottleRegistry) {
+        if (nowMs - entryTime > windowMs * 3) {
+            automaticReportThrottleRegistry.delete(entryKey);
+        }
+    }
+}
+function notifyGlasses(reportId, apiBaseUrl) {
+    if (!isGlassesConnected(useGlassesStore.getState().connection))
+        return;
+    void (async () => {
+        try {
+            await cloudClientService.syncCoreTokenToBluetooth();
+            await BluetoothSdk.sendIncidentId(reportId, apiBaseUrl ?? cloudClientService.getCoreUrl());
+        }
+        catch (error) {
+            console.warn("reports.submit: notify glasses failed:", error instanceof Error ? error.message : error);
+        }
+    })();
+}
+async function submitReportInternal(input) {
+    const throttle = input.kind === "automatic" && input.throttleKey
+        ? {
+            key: input.throttleKey,
+            windowMs: input.throttleWindowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,
+        }
+        : null;
+    if (input.kind === "automatic" && input.throttleKey) {
+        const shouldSkip = automaticThrottleShouldSkip(input.throttleKey, Date.now(), throttle?.windowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS);
+        if (shouldSkip)
+            return { status: "skipped", reason: "throttled_within_window" };
+    }
+    const context = await collectDiagnosticContext(input.context);
+    let reportId;
+    let reportStatus;
+    let artifactsComplete = true;
+    try {
+        const res = input.kind === "feedback"
+            ? await cloudClientService.core.reports.submit({
+                kind: "feedback",
+                feedback: input.feedback,
+                context,
+            })
+            : input.kind === "bug"
+                ? await cloudClientService.core.reports.submit({
+                    kind: "bug",
+                    trigger: input.trigger,
+                    report: input.report,
+                    context,
+                })
+                : await cloudClientService.core.reports.submit({
+                    kind: "automatic",
+                    trigger: input.trigger,
+                    report: input.report,
+                    context,
+                });
+        reportId = res.reportId;
+        reportStatus = res.status;
+    }
+    catch (error) {
+        return { status: "failed", error: error instanceof Error ? error.message : String(error) };
+    }
+    if (input.kind !== "feedback") {
+        const logs = logBuffer.getRecentLogs();
+        if (logs.length > 0) {
+            try {
+                await cloudClientService.core.reports.addLogs(reportId, "phone", logs);
+            }
+            catch (error) {
+                artifactsComplete = false;
+                console.warn("reports.submit: add phone logs failed:", error instanceof Error ? error.message : error);
+            }
+        }
+        notifyGlasses(reportId, cloudClientService.getCoreUrl());
+        if (input.screenshots && input.screenshots.length > 0) {
+            try {
+                await cloudClientService.core.reports.addScreenshots(reportId, input.screenshots);
+            }
+            catch (error) {
+                artifactsComplete = false;
+                console.warn("reports.submit: add screenshots failed:", error instanceof Error ? error.message : error);
+            }
+        }
+        try {
+            const completed = await cloudClientService.core.reports.complete(reportId);
+            reportStatus = completed.status;
+        }
+        catch (error) {
+            artifactsComplete = false;
+            console.warn("reports.submit: complete report failed:", error instanceof Error ? error.message : error);
+        }
+    }
+    if (throttle && artifactsComplete) {
+        markAutomaticThrottleSuccess(throttle.key, Date.now(), throttle.windowMs);
+    }
+    return { status: "submitted", reportId, reportStatus };
+}
+export const reports = {
+    submit(input) {
+        return submitReportInternal(input);
+    },
+};
+export function submitAutomaticReport(input) {
+    return submitReportInternal(input);
+}
+//# sourceMappingURL=reports.js.map

package/build/facades/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../src/facades/reports.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * reports facade — `engine.reports`: user/system report submission over the\n * Cloud V2 core client.\n *\n * Host/OEM code owns UI and wording. Engine owns MentraOS mechanics: context\n * collection, recent phone logs, Cloud V2 calls, local automatic throttling,\n * screenshots, and notifying connected glasses.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportStatus,\n  SubmitReportInput,\n} from \"@mentra/cloud-client\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {isGlassesConnected} from \"../services/GlassesReadiness\"\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {collectDiagnosticContext} from \"../utils/diagnosticContext\"\nimport {logBuffer} from \"../utils/devLogging\"\n\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n} from \"@mentra/cloud-client\"\n\nexport type EngineSubmitReportInput =\n  | (Omit<Extract<SubmitReportInput, {kind: \"bug\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n      screenshots?: ReportAttachmentInput[]\n    })\n  | (Omit<Extract<SubmitReportInput, {kind: \"feedback\"}>, \"context\"> & {\n      context?: Partial<ReportContext>\n    })\n\nexport type EngineSubmitAutomaticReportInput = Omit<Extract<SubmitReportInput, {kind: \"automatic\"}>, \"context\"> & {\n  context?: Partial<ReportContext>\n  screenshots?: ReportAttachmentInput[]\n  throttleKey?: string\n  throttleWindowMs?: number\n}\n\ntype InternalSubmitReportInput = EngineSubmitReportInput | EngineSubmitAutomaticReportInput\n\nexport type ReportSubmitResult =\n  | {status: \"submitted\"; reportId: string; reportStatus: ReportStatus}\n  | {status: \"skipped\"; reason: \"throttled_within_window\"}\n  | {status: \"failed\"; error: string}\n\nconst DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS = 90_000\nconst automaticReportThrottleRegistry = new Map<string, number>()\n\nfunction automaticThrottleShouldSkip(key: string, nowMs: number, windowMs: number): boolean {\n  const previous = automaticReportThrottleRegistry.get(key)\n  if (previous !== undefined && nowMs - previous < windowMs) {\n    return true\n  }\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n  return false\n}\n\nfunction markAutomaticThrottleSuccess(key: string, nowMs: number, windowMs: number): void {\n  automaticReportThrottleRegistry.set(key, nowMs)\n  pruneAutomaticThrottleRegistry(nowMs, windowMs)\n}\n\nfunction pruneAutomaticThrottleRegistry(nowMs: number, windowMs: number): void {\n  for (const [entryKey, entryTime] of automaticReportThrottleRegistry) {\n    if (nowMs - entryTime > windowMs * 3) {\n      automaticReportThrottleRegistry.delete(entryKey)\n    }\n  }\n}\n\nfunction notifyGlasses(reportId: string, apiBaseUrl?: string | null): void {\n  if (!isGlassesConnected(useGlassesStore.getState().connection)) return\n  void (async () => {\n    try {\n      await cloudClientService.syncCoreTokenToBluetooth()\n      await BluetoothSdk.sendIncidentId(reportId, apiBaseUrl ?? cloudClientService.getCoreUrl())\n    } catch (error) {\n      console.warn(\"reports.submit: notify glasses failed:\", error instanceof Error ? error.message : error)\n    }\n  })()\n}\n\nasync function submitReportInternal(input: InternalSubmitReportInput): Promise<ReportSubmitResult> {\n  const throttle =\n    input.kind === \"automatic\" && input.throttleKey\n      ? {\n          key: input.throttleKey,\n          windowMs: input.throttleWindowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n        }\n      : null\n\n  if (input.kind === \"automatic\" && input.throttleKey) {\n    const shouldSkip = automaticThrottleShouldSkip(\n      input.throttleKey,\n      Date.now(),\n      throttle?.windowMs ?? DEFAULT_AUTOMATIC_REPORT_THROTTLE_MS,\n    )\n    if (shouldSkip) return {status: \"skipped\", reason: \"throttled_within_window\"}\n  }\n\n  const context = await collectDiagnosticContext(input.context)\n  let reportId: string\n  let reportStatus: ReportStatus\n  let artifactsComplete = true\n  try {\n    const res =\n      input.kind === \"feedback\"\n        ? await cloudClientService.core.reports.submit({\n            kind: \"feedback\",\n            feedback: input.feedback,\n            context,\n          })\n        : input.kind === \"bug\"\n          ? await cloudClientService.core.reports.submit({\n              kind: \"bug\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n          : await cloudClientService.core.reports.submit({\n              kind: \"automatic\",\n              trigger: input.trigger,\n              report: input.report,\n              context,\n            })\n    reportId = res.reportId\n    reportStatus = res.status\n  } catch (error) {\n    return {status: \"failed\", error: error instanceof Error ? error.message : String(error)}\n  }\n\n  if (input.kind !== \"feedback\") {\n    const logs = logBuffer.getRecentLogs()\n    if (logs.length > 0) {\n      try {\n        await cloudClientService.core.reports.addLogs(reportId, \"phone\", logs)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add phone logs failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    notifyGlasses(reportId, cloudClientService.getCoreUrl())\n\n    if (input.screenshots && input.screenshots.length > 0) {\n      try {\n        await cloudClientService.core.reports.addScreenshots(reportId, input.screenshots)\n      } catch (error) {\n        artifactsComplete = false\n        console.warn(\"reports.submit: add screenshots failed:\", error instanceof Error ? error.message : error)\n      }\n    }\n\n    try {\n      const completed = await cloudClientService.core.reports.complete(reportId)\n      reportStatus = completed.status\n    } catch (error) {\n      artifactsComplete = false\n      console.warn(\"reports.submit: complete report failed:\", error instanceof Error ? error.message : error)\n    }\n  }\n\n  if (throttle && artifactsComplete) {\n    markAutomaticThrottleSuccess(throttle.key, Date.now(), throttle.windowMs)\n  }\n\n  return {status: \"submitted\", reportId, reportStatus}\n}\n\nexport const reports = {\n  submit(input: EngineSubmitReportInput): Promise<ReportSubmitResult> {\n    return submitReportInternal(input)\n  },\n}\n\nexport function submitAutomaticReport(input: EngineSubmitAutomaticReportInput): Promise<ReportSubmitResult> {\n  return submitReportInternal(input)\n}\n"]}

package/build/facades/session.d.ts

@@ -0,0 +1,21 @@
+import type { WebSocketStatus } from "../stores/connection";
+import type { CloudClientStatusSnapshot } from "../runtime/config";
+export declare const session: {
+    /** Current cloud live-session status (connection state + audio transport). */
+    status: () => CloudClientStatusSnapshot;
+    /** Subscribe to cloud session-status changes; returns an unsubscribe. */
+    onStatus: (cb: (status: CloudClientStatusSnapshot) => void) => (() => void);
+    /** Whether the live-session handshake has completed. */
+    isConnected: () => boolean;
+    /**
+     * Legacy Cloud-V1 websocket status. The socket's writer (the host
+     * WebSocketManager) was deleted in the Cloud V1 ripout, so this now always
+     * reports the store's initial DISCONNECTED; the host connection banners
+     * render `status()` (the cloud-v2 runtime) instead. Kept, with the backing
+     * connection store, for the engine-side legacy-surface removal (issue #3392).
+     */
+    legacyWebsocketStatus: () => WebSocketStatus;
+    /** Subscribe to legacy websocket status changes; fires only when it changes. Returns an unsubscribe. */
+    onLegacyWebsocketStatus: (cb: (status: WebSocketStatus) => void) => (() => void);
+};
+//# sourceMappingURL=session.d.ts.map

package/build/facades/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/facades/session.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,mBAAmB,CAAA;AAOhE,eAAO,MAAM,OAAO;IAClB,8EAA8E;kBAClE,yBAAyB;IACrC,yEAAyE;mBAC1D,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAWzE,wDAAwD;uBACvC,OAAO;IAExB;;;;;;OAMG;iCACwB,eAAe;IAC1C,wGAAwG;kCAC1E,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;CAS/E,CAAA"}

package/build/facades/session.js

@@ -0,0 +1,52 @@
+/**
+ * session facade — `engine.session`: the cloud-v2 live-session surface engine
+ * now owns (keystone #5). Exposes the connection status read-model (status +
+ * audio transport, projected from the engine-owned cloud-status store) and the
+ * liveness flag.
+ *
+ */
+import { cloudClientService } from "../services/CloudClientService";
+import { useCloudClientStatusStore } from "../stores/cloudClientStatus";
+import { useConnectionStore } from "../stores/connection";
+function project() {
+    const s = useCloudClientStatusStore.getState();
+    return { status: s.status, audioTransport: s.audioTransport };
+}
+export const session = {
+    /** Current cloud live-session status (connection state + audio transport). */
+    status: () => project(),
+    /** Subscribe to cloud session-status changes; returns an unsubscribe. */
+    onStatus: (cb) => {
+        // Dedupe: fire only when the projected {status, audioTransport} changes.
+        let last = JSON.stringify(project());
+        return useCloudClientStatusStore.subscribe(() => {
+            const snap = project();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    /** Whether the live-session handshake has completed. */
+    isConnected: () => cloudClientService.isConnected(),
+    /**
+     * Legacy Cloud-V1 websocket status. The socket's writer (the host
+     * WebSocketManager) was deleted in the Cloud V1 ripout, so this now always
+     * reports the store's initial DISCONNECTED; the host connection banners
+     * render `status()` (the cloud-v2 runtime) instead. Kept, with the backing
+     * connection store, for the engine-side legacy-surface removal (issue #3392).
+     */
+    legacyWebsocketStatus: () => useConnectionStore.getState().status,
+    /** Subscribe to legacy websocket status changes; fires only when it changes. Returns an unsubscribe. */
+    onLegacyWebsocketStatus: (cb) => {
+        let last = useConnectionStore.getState().status;
+        return useConnectionStore.subscribe((state) => {
+            if (state.status === last)
+                return;
+            last = state.status;
+            cb(state.status);
+        });
+    },
+};
+//# sourceMappingURL=session.js.map

package/build/facades/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/facades/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AACjE,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAA;AAIvD,SAAS,OAAO;IACd,MAAM,CAAC,GAAG,yBAAyB,CAAC,QAAQ,EAAE,CAAA;IAC9C,OAAO,EAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAC,CAAA;AAC7D,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,8EAA8E;IAC9E,MAAM,EAAE,GAA8B,EAAE,CAAC,OAAO,EAAE;IAClD,yEAAyE;IACzE,QAAQ,EAAE,CAAC,EAA+C,EAAgB,EAAE;QAC1E,yEAAyE;QACzE,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAA;QACpC,OAAO,yBAAyB,CAAC,SAAS,CAAC,GAAG,EAAE;YAC9C,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAM;YACxB,IAAI,GAAG,GAAG,CAAA;YACV,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,wDAAwD;IACxD,WAAW,EAAE,GAAY,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE;IAE5D;;;;;;OAMG;IACH,qBAAqB,EAAE,GAAoB,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,MAAM;IAClF,wGAAwG;IACxG,uBAAuB,EAAE,CAAC,EAAqC,EAAgB,EAAE;QAC/E,IAAI,IAAI,GAAG,kBAAkB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAA;QAC/C,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;gBAAE,OAAM;YACjC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAA;YACnB,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC;CAEF,CAAA","sourcesContent":["/**\n * session facade — `engine.session`: the cloud-v2 live-session surface engine\n * now owns (keystone #5). Exposes the connection status read-model (status +\n * audio transport, projected from the engine-owned cloud-status store) and the\n * liveness flag.\n *\n */\nimport {cloudClientService} from \"../services/CloudClientService\"\nimport {useCloudClientStatusStore} from \"../stores/cloudClientStatus\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport type {WebSocketStatus} from \"../stores/connection\"\nimport type {CloudClientStatusSnapshot} from \"../runtime/config\"\n\nfunction project(): CloudClientStatusSnapshot {\n  const s = useCloudClientStatusStore.getState()\n  return {status: s.status, audioTransport: s.audioTransport}\n}\n\nexport const session = {\n  /** Current cloud live-session status (connection state + audio transport). */\n  status: (): CloudClientStatusSnapshot => project(),\n  /** Subscribe to cloud session-status changes; returns an unsubscribe. */\n  onStatus: (cb: (status: CloudClientStatusSnapshot) => void): (() => void) => {\n    // Dedupe: fire only when the projected {status, audioTransport} changes.\n    let last = JSON.stringify(project())\n    return useCloudClientStatusStore.subscribe(() => {\n      const snap = project()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n  /** Whether the live-session handshake has completed. */\n  isConnected: (): boolean => cloudClientService.isConnected(),\n\n  /**\n   * Legacy Cloud-V1 websocket status. The socket's writer (the host\n   * WebSocketManager) was deleted in the Cloud V1 ripout, so this now always\n   * reports the store's initial DISCONNECTED; the host connection banners\n   * render `status()` (the cloud-v2 runtime) instead. Kept, with the backing\n   * connection store, for the engine-side legacy-surface removal (issue #3392).\n   */\n  legacyWebsocketStatus: (): WebSocketStatus => useConnectionStore.getState().status,\n  /** Subscribe to legacy websocket status changes; fires only when it changes. Returns an unsubscribe. */\n  onLegacyWebsocketStatus: (cb: (status: WebSocketStatus) => void): (() => void) => {\n    let last = useConnectionStore.getState().status\n    return useConnectionStore.subscribe((state) => {\n      if (state.status === last) return\n      last = state.status\n      cb(state.status)\n    })\n  },\n\n}\n"]}

package/build/facades/settings.d.ts

@@ -0,0 +1,37 @@
+export declare const settings: {
+    /** Read a setting by key (the current value, or its default; object/array values
+     * are shallow copies). */
+    get: <T = unknown>(key: string) => T | undefined;
+    /**
+     * Write a setting. `syncToServer` (default true) also pushes the change to the
+     * backend; pass false for device-local-only writes.
+     */
+    set: <T = unknown>(key: string, value: T, syncToServer?: boolean) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Subscribe to changes for one key; returns an unsubscribe. */
+    onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void) => (() => void);
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key: string) => import("../stores/settings").Setting;
+    /** All known setting keys. */
+    keys: () => string[];
+    /**
+     * Reset every setting to its default on THIS device only (no server sync) —
+     * the logout path. Server-side settings are untouched.
+     */
+    resetAllLocal: () => void;
+    /**
+     * Hydrate the settings store from device storage — the host-boot step (fire
+     * once at app start, before UI reads settings). Single-flighted internally.
+     */
+    loadAll: () => import("typesafe-ts").AsyncResult<void, Error>;
+    /**
+     * Every EXPLICITLY-SET setting (shallow copy; keys never written are absent —
+     * use get() for default-resolved reads). The data-export surface.
+     */
+    getAll: () => Record<string, unknown>;
+    /**
+     * Bulk device-local write without server sync — seeding the store from a
+     * backend settings payload.
+     */
+    setManyLocal: (values: Record<string, unknown>) => import("typesafe-ts").AsyncResult<void, Error>;
+};
+//# sourceMappingURL=settings.d.ts.map

package/build/facades/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/facades/settings.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,QAAQ;IACnB;8BAC0B;UACpB,CAAC,iBAAiB,MAAM,KAAG,CAAC,GAAG,SAAS;IAE9C;;;OAGG;UACG,CAAC,iBAAiB,MAAM,SAAS,CAAC;IAExC,gEAAgE;gBACpD,CAAC,iBAAiB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;IAEvF,+EAA+E;sBAC7D,MAAM;IACxB,8BAA8B;gBACpB,MAAM,EAAE;IAClB;;;OAGG;yBACgB,IAAI;IACvB;;;OAGG;;IAEH;;;OAGG;kBACS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnC;;;OAGG;2BACoB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAC/C,CAAA"}

package/build/facades/settings.js

@@ -0,0 +1,55 @@
+/**
+ * settings facade — `engine.settings`: the typed keyed user-settings surface over
+ * the engine-owned settings store. This is the (A) OEM contract; the raw store at
+ * `engine.stores.settings` is the Mentra-app escape hatch.
+ *
+ * Keys + their schema live in `SETTINGS` (theme, devMode, metric/twelveHourTime,
+ * notifications, onboarding flags, …); `descriptor(key)`/`keys()` expose them.
+ */
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+// Copy: object/array-valued settings must not hand callers a mutable reference
+// into the store (mutations would silently corrupt store state, bypassing set()).
+function copySettingValue(value) {
+    if (Array.isArray(value))
+        return [...value];
+    if (value && typeof value === "object")
+        return { ...value };
+    return value;
+}
+export const settings = {
+    /** Read a setting by key (the current value, or its default; object/array values
+     * are shallow copies). */
+    get: (key) => copySettingValue(useSettingsStore.getState().getSetting(key)),
+    /**
+     * Write a setting. `syncToServer` (default true) also pushes the change to the
+     * backend; pass false for device-local-only writes.
+     */
+    set: (key, value, syncToServer = true) => useSettingsStore.getState().setSetting(key, value, syncToServer),
+    /** Subscribe to changes for one key; returns an unsubscribe. */
+    onChanged: (key, cb) => useSettingsStore.subscribe((s) => s.getSetting(key), cb),
+    /** The schema descriptor for a key (type, default, options…), or undefined. */
+    descriptor: (key) => SETTINGS[key],
+    /** All known setting keys. */
+    keys: () => Object.keys(SETTINGS),
+    /**
+     * Reset every setting to its default on THIS device only (no server sync) —
+     * the logout path. Server-side settings are untouched.
+     */
+    resetAllLocal: () => useSettingsStore.getState().resetAllSettingsLocally(),
+    /**
+     * Hydrate the settings store from device storage — the host-boot step (fire
+     * once at app start, before UI reads settings). Single-flighted internally.
+     */
+    loadAll: () => useSettingsStore.getState().loadAllSettings(),
+    /**
+     * Every EXPLICITLY-SET setting (shallow copy; keys never written are absent —
+     * use get() for default-resolved reads). The data-export surface.
+     */
+    getAll: () => ({ ...useSettingsStore.getState().settings }),
+    /**
+     * Bulk device-local write without server sync — seeding the store from a
+     * backend settings payload.
+     */
+    setManyLocal: (values) => useSettingsStore.getState().setManyLocally(values),
+};
+//# sourceMappingURL=settings.js.map

package/build/facades/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/facades/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAE7D,+EAA+E;AAC/E,kFAAkF;AAClF,SAAS,gBAAgB,CAAI,KAAQ;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,KAAK,CAAM,CAAA;IAChD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAC,GAAI,KAAgB,EAAM,CAAA;IAC1E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;8BAC0B;IAC1B,GAAG,EAAE,CAAc,GAAW,EAAiB,EAAE,CAC/C,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,CAAkB,CAAC;IAChF;;;OAGG;IACH,GAAG,EAAE,CAAc,GAAW,EAAE,KAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,EAAE,CAC/D,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC;IAClE,gEAAgE;IAChE,SAAS,EAAE,CAAc,GAAW,EAAE,EAAkC,EAAgB,EAAE,CACxF,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAkB,EAAE,EAAE,CAAC;IAC3E,+EAA+E;IAC/E,UAAU,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC1C,8BAA8B;IAC9B,IAAI,EAAE,GAAa,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC3C;;;OAGG;IACH,aAAa,EAAE,GAAS,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,uBAAuB,EAAE;IAChF;;;OAGG;IACH,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,eAAe,EAAE;IAC5D;;;OAGG;IACH,MAAM,EAAE,GAA4B,EAAE,CAAC,CAAC,EAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAC,CAAC;IAClF;;;OAGG;IACH,YAAY,EAAE,CAAC,MAA+B,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC;CACtG,CAAA","sourcesContent":["/**\n * settings facade — `engine.settings`: the typed keyed user-settings surface over\n * the engine-owned settings store. This is the (A) OEM contract; the raw store at\n * `engine.stores.settings` is the Mentra-app escape hatch.\n *\n * Keys + their schema live in `SETTINGS` (theme, devMode, metric/twelveHourTime,\n * notifications, onboarding flags, …); `descriptor(key)`/`keys()` expose them.\n */\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\n\n// Copy: object/array-valued settings must not hand callers a mutable reference\n// into the store (mutations would silently corrupt store state, bypassing set()).\nfunction copySettingValue<T>(value: T): T {\n  if (Array.isArray(value)) return [...value] as T\n  if (value && typeof value === \"object\") return {...(value as object)} as T\n  return value\n}\n\nexport const settings = {\n  /** Read a setting by key (the current value, or its default; object/array values\n   * are shallow copies). */\n  get: <T = unknown>(key: string): T | undefined =>\n    copySettingValue(useSettingsStore.getState().getSetting(key) as T | undefined),\n  /**\n   * Write a setting. `syncToServer` (default true) also pushes the change to the\n   * backend; pass false for device-local-only writes.\n   */\n  set: <T = unknown>(key: string, value: T, syncToServer = true) =>\n    useSettingsStore.getState().setSetting(key, value, syncToServer),\n  /** Subscribe to changes for one key; returns an unsubscribe. */\n  onChanged: <T = unknown>(key: string, cb: (value: T | undefined) => void): (() => void) =>\n    useSettingsStore.subscribe((s) => s.getSetting(key) as T | undefined, cb),\n  /** The schema descriptor for a key (type, default, options…), or undefined. */\n  descriptor: (key: string) => SETTINGS[key],\n  /** All known setting keys. */\n  keys: (): string[] => Object.keys(SETTINGS),\n  /**\n   * Reset every setting to its default on THIS device only (no server sync) —\n   * the logout path. Server-side settings are untouched.\n   */\n  resetAllLocal: (): void => useSettingsStore.getState().resetAllSettingsLocally(),\n  /**\n   * Hydrate the settings store from device storage — the host-boot step (fire\n   * once at app start, before UI reads settings). Single-flighted internally.\n   */\n  loadAll: () => useSettingsStore.getState().loadAllSettings(),\n  /**\n   * Every EXPLICITLY-SET setting (shallow copy; keys never written are absent —\n   * use get() for default-resolved reads). The data-export surface.\n   */\n  getAll: (): Record<string, unknown> => ({...useSettingsStore.getState().settings}),\n  /**\n   * Bulk device-local write without server sync — seeding the store from a\n   * backend settings payload.\n   */\n  setManyLocal: (values: Record<string, unknown>) => useSettingsStore.getState().setManyLocally(values),\n}\n"]}

package/build/facades/speech.d.ts

@@ -0,0 +1,30 @@
+import sttModelManager from "../services/STTModelManager";
+import ttsModelManager from "../services/TTSModelManager";
+import offlineSpeechModelService from "../services/OfflineSpeechModelService";
+export declare const speech: {
+    /** Restart the glasses' on-device transcriber (e.g. after switching STT language). */
+    restartTranscriber: () => Promise<void>;
+    stt: {
+        currentLanguage: () => string;
+        languages: () => import("../internal").SttLanguageConfig[];
+        languageInfo: () => Promise<import("../internal").SttLanguageInfo[]>;
+        download: (code?: string | undefined, onProgress?: ((progress: import("../internal").SttDownloadProgress) => void) | undefined, onExtractionProgress?: ((progress: import("../internal").SttExtractionProgress) => void) | undefined) => Promise<void>;
+        activate: (code: string) => void;
+        cancelDownload: () => Promise<void>;
+        deleteModel: (code?: string | undefined) => Promise<void>;
+        /** Current auto-download status of the offline STT model. */
+        status: () => import("../internal").OfflineModelDownloadStatus | null;
+        /** Subscribe to auto-download status changes; returns an unsubscribe. */
+        onStatusChanged: (listener: (status: import("../internal").OfflineModelDownloadStatus | null) => void) => () => void;
+    };
+    tts: {
+        currentLanguage: () => string;
+        languages: () => import("../services/TTSModelManager").TTSLanguageConfig[];
+        languageInfo: () => Promise<import("../services/TTSModelManager").TTSLanguageInfo[]>;
+        download: (code?: string | undefined, onProgress?: ((progress: import("../services/TTSModelManager").TTSDownloadProgress) => void) | undefined, onExtractionProgress?: ((progress: import("../services/TTSModelManager").TTSExtractionProgress) => void) | undefined) => Promise<void>;
+        activate: (code: string) => void;
+        cancelDownload: () => Promise<void>;
+        deleteModel: (_code?: string | undefined) => Promise<void>;
+    };
+};
+//# sourceMappingURL=speech.d.ts.map

package/build/facades/speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.d.ts","sourceRoot":"","sources":["../../src/facades/speech.ts"],"names":[],"mappings":"AAOA,OAAO,eAAe,MAAM,6BAA6B,CAAA;AACzD,OAAO,eAAe,MAAM,6BAA6B,CAAA;AACzD,OAAO,yBAAyB,MAAM,uCAAuC,CAAA;AAE7E,eAAO,MAAM,MAAM;IACjB,sFAAsF;8BAC9D,OAAO,CAAC,IAAI,CAAC;;;;;;yBAMlB,MAAM;;;QAGvB,6DAA6D;;QAE7D,yEAAyE;;;;;;;;yBASxD,MAAM;;;;CAI1B,CAAA"}

package/build/facades/speech.js

@@ -0,0 +1,37 @@
+/**
+ * speech facade — `engine.speech.{stt,tts}`: on-device STT/TTS model management,
+ * wrapping the in-engine model managers. Thin passthrough (args forwarded with
+ * exact types via Parameters<>), so the facade never drifts from the managers.
+ * STT additionally exposes the auto-download status stream (the TTS path has none).
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import sttModelManager from "../services/STTModelManager";
+import ttsModelManager from "../services/TTSModelManager";
+import offlineSpeechModelService from "../services/OfflineSpeechModelService";
+export const speech = {
+    /** Restart the glasses' on-device transcriber (e.g. after switching STT language). */
+    restartTranscriber: () => BluetoothSdk.restartTranscriber(),
+    stt: {
+        currentLanguage: () => sttModelManager.getCurrentLanguage(),
+        languages: () => sttModelManager.getAvailableLanguages(),
+        languageInfo: () => sttModelManager.getAllLanguageInfo(),
+        download: (...args) => sttModelManager.downloadModel(...args),
+        activate: (code) => sttModelManager.setCurrentLanguage(code),
+        cancelDownload: () => sttModelManager.cancelDownload(),
+        deleteModel: (...args) => sttModelManager.deleteModel(...args),
+        /** Current auto-download status of the offline STT model. */
+        status: () => offlineSpeechModelService.getStatus(),
+        /** Subscribe to auto-download status changes; returns an unsubscribe. */
+        onStatusChanged: (...args) => offlineSpeechModelService.subscribe(...args),
+    },
+    tts: {
+        currentLanguage: () => ttsModelManager.getCurrentLanguage(),
+        languages: () => ttsModelManager.getAvailableLanguages(),
+        languageInfo: () => ttsModelManager.getAllLanguageInfo(),
+        download: (...args) => ttsModelManager.downloadModel(...args),
+        activate: (code) => ttsModelManager.setCurrentLanguage(code),
+        cancelDownload: () => ttsModelManager.cancelDownload(),
+        deleteModel: (...args) => ttsModelManager.deleteModel(...args),
+    },
+};
+//# sourceMappingURL=speech.js.map

package/build/facades/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../src/facades/speech.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AACzD,OAAO,eAAe,MAAM,6BAA6B,CAAA;AACzD,OAAO,eAAe,MAAM,6BAA6B,CAAA;AACzD,OAAO,yBAAyB,MAAM,uCAAuC,CAAA;AAE7E,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sFAAsF;IACtF,kBAAkB,EAAE,GAAkB,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE;IAC1E,GAAG,EAAE;QACH,eAAe,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE;QAC3D,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,qBAAqB,EAAE;QACxD,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE;QACxD,QAAQ,EAAE,CAAC,GAAG,IAAsD,EAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAC/G,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,IAAI,CAAC;QACpE,cAAc,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,cAAc,EAAE;QACtD,WAAW,EAAE,CAAC,GAAG,IAAoD,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QAC9G,6DAA6D;QAC7D,MAAM,EAAE,GAAG,EAAE,CAAC,yBAAyB,CAAC,SAAS,EAAE;QACnD,yEAAyE;QACzE,eAAe,EAAE,CAAC,GAAG,IAA4D,EAAE,EAAE,CACnF,yBAAyB,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;KAC/C;IACD,GAAG,EAAE;QACH,eAAe,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE;QAC3D,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,qBAAqB,EAAE;QACxD,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE;QACxD,QAAQ,EAAE,CAAC,GAAG,IAAsD,EAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAC/G,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,eAAe,CAAC,kBAAkB,CAAC,IAAI,CAAC;QACpE,cAAc,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,cAAc,EAAE;QACtD,WAAW,EAAE,CAAC,GAAG,IAAoD,EAAE,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;KAC/G;CACF,CAAA","sourcesContent":["/**\n * speech facade — `engine.speech.{stt,tts}`: on-device STT/TTS model management,\n * wrapping the in-engine model managers. Thin passthrough (args forwarded with\n * exact types via Parameters<>), so the facade never drifts from the managers.\n * STT additionally exposes the auto-download status stream (the TTS path has none).\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport sttModelManager from \"../services/STTModelManager\"\nimport ttsModelManager from \"../services/TTSModelManager\"\nimport offlineSpeechModelService from \"../services/OfflineSpeechModelService\"\n\nexport const speech = {\n  /** Restart the glasses' on-device transcriber (e.g. after switching STT language). */\n  restartTranscriber: (): Promise<void> => BluetoothSdk.restartTranscriber(),\n  stt: {\n    currentLanguage: () => sttModelManager.getCurrentLanguage(),\n    languages: () => sttModelManager.getAvailableLanguages(),\n    languageInfo: () => sttModelManager.getAllLanguageInfo(),\n    download: (...args: Parameters<typeof sttModelManager.downloadModel>) => sttModelManager.downloadModel(...args),\n    activate: (code: string) => sttModelManager.setCurrentLanguage(code),\n    cancelDownload: () => sttModelManager.cancelDownload(),\n    deleteModel: (...args: Parameters<typeof sttModelManager.deleteModel>) => sttModelManager.deleteModel(...args),\n    /** Current auto-download status of the offline STT model. */\n    status: () => offlineSpeechModelService.getStatus(),\n    /** Subscribe to auto-download status changes; returns an unsubscribe. */\n    onStatusChanged: (...args: Parameters<typeof offlineSpeechModelService.subscribe>) =>\n      offlineSpeechModelService.subscribe(...args),\n  },\n  tts: {\n    currentLanguage: () => ttsModelManager.getCurrentLanguage(),\n    languages: () => ttsModelManager.getAvailableLanguages(),\n    languageInfo: () => ttsModelManager.getAllLanguageInfo(),\n    download: (...args: Parameters<typeof ttsModelManager.downloadModel>) => ttsModelManager.downloadModel(...args),\n    activate: (code: string) => ttsModelManager.setCurrentLanguage(code),\n    cancelDownload: () => ttsModelManager.cancelDownload(),\n    deleteModel: (...args: Parameters<typeof ttsModelManager.deleteModel>) => ttsModelManager.deleteModel(...args),\n  },\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `@mentra/engine` — the OEM-facing main entry.
+ *
+ * The `engine` namespace (configure/start/stop + typed domain facades), the
+ * public contract/read-model types, and the pure helpers host UI legitimately
+ * renders with (decision functions, sort/order helpers, policy constants,
+ * capability tables, timers). Judgment rule: read models, commands, pure
+ * functions and types belong here; anything that mutates runtime state or
+ * exposes a raw store/service lives on `@mentra/engine/internal`
+ * (migration-era surface) or `@mentra/engine/devtools` (debug-only) instead.
+ * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
+ */
+export { engine } from "./engine";
+export type { ReportAttachmentInput, ReportContext, ReportDetails, ReportStatus, ReportTrigger, ReportSubmitResult, EngineSubmitReportInput, } from "./facades/reports";
+export type { IslandNotification, IslandNotificationKind } from "./facades/notifications";
+export type { WifiSearchResult } from "./facades/glassesWifi";
+export type { IdentitySnapshot } from "./services/PairingIdentity";
+export type { DisplayMirrorEvent } from "./facades/displayMirror";
+export type { IslandConfigureOptions, IslandAuth, IslandConfigValues, IslandAnalytics, IslandUiSeams, SubjectTokenType, } from "./runtime/bootstrap";
+export { SETTINGS, useSetting } from "./stores/settings";
+export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
+export { ISLAND_SETTINGS_KEYS } from "./runtime/config";
+export type { CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult, } from "./runtime/config";
+export { isGlassesConnected, isGlassesReady, isGlassesLinkLayerBusy, waitForGlassesReady, type GlassesConnectionStatus, type WaitForGlassesReadyOptions, } from "./services/GlassesReadiness";
+export { decideReconnect, decideConnectButtonAction, type ReconnectDecision, type ReconnectDecisionInput, type ConnectButtonAction, } from "./services/ConnectionCoordinator";
+export type { VersionInfo, MtkPatch, BesFirmware, VersionJson, OtaCheckResult, OtaCheckCurrentGlassesResult, OtaCheckCurrentGlassesOptions, } from "./services/OtaUpdateCheckService";
+export { MINIMUM_OTA_STATUS_BUILD, MAX_RETRIES, RETRY_INTERVAL_MS, PROGRESS_TIMEOUT_MS, DOWNLOAD_STUCK_TIMEOUT_MS, MTK_INSTALL_TIMEOUT_MS, GLOBAL_OTA_TIMEOUT_MS, POST_APK_OTA_START_DELAY_MS, PING_INTERVAL_MS, QUERY_REPLY_TIMEOUT_MS, OtaProgressMessages, } from "./services/otaInstallPolicy";
+export { deriveDisplayState } from "./services/otaDisplayState";
+export type { DisplayState } from "./services/otaDisplayState";
+export type { OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo, OtaSnapshot, OtaInstallSnapshot, } from "./facades/ota";
+export type { GalleryNotice, GalleryNoticeCode } from "./services/asg/galleryNotices";
+export { MediaLibraryPermissions } from "./utils/permissions/MediaLibraryPermissions";
+export { deriveGalleryDisplayName } from "./utils/permissions/galleryDisplayName";
+export type { PhotoInfo, CaptureFile, CaptureGroup, GalleryResponse, ServerStatus, HealthResponse, GalleryEvent } from "./types/asg";
+export type { PairFailureEvent, GlassesNotReadyEvent } from "@mentra/bluetooth-sdk/internal";
+export { WebSocketStatus } from "./stores/connection";
+export { DUMMY_APPLET, saveAppsOrder, getAppsOrder, sortAppsByPackageNamePriority, saveLastOpenTime, getLastOpenTime, sortAppsByLastOpenTime, useApps, useStart, useStop, useSetForeground, useClearForeground, useRefresh, useStopAll, useInstall, useUninstall, useActiveApps, useActiveBackgroundApps, useBackgroundApps, useActiveForegroundApp, useForegroundApp, useActiveBackgroundAppsCount, useLocalMiniApps, type StartOptions, type OrderMap, } from "./stores/apps";
+export { decideDevLaunchRoute, type DevLaunchResult, type DevManifest } from "./utils/devMiniappLaunch";
+export { HardwareCompatibility, type CompatibilityResult } from "./utils/hardware";
+export { BgTimer, throttle, debounce } from "./utils/timers";
+export { HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes, HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, } from "./types";
+export type { HardwareRequirement, CameraCapabilities, DisplayCapabilities, MicrophoneCapabilities, SpeakerCapabilities, IMUCapabilities, ButtonCapabilities, LightCapabilities, PowerCapabilities, Capabilities, AppletType, AppPermissionType, AppletPermission, AppletInterface, ClientApp, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,45 @@
+/**
+ * `@mentra/engine` — the OEM-facing main entry.
+ *
+ * The `engine` namespace (configure/start/stop + typed domain facades), the
+ * public contract/read-model types, and the pure helpers host UI legitimately
+ * renders with (decision functions, sort/order helpers, policy constants,
+ * capability tables, timers). Judgment rule: read models, commands, pure
+ * functions and types belong here; anything that mutates runtime state or
+ * exposes a raw store/service lives on `@mentra/engine/internal`
+ * (migration-era surface) or `@mentra/engine/devtools` (debug-only) instead.
+ * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
+ */
+// The namespaced OEM-facing engine API (the "(A) host API"). See ./engine.
+export { engine } from "./engine";
+// Settings contract: the typed key registry (schema descriptors — the same
+// surface engine.settings.descriptor()/keys() reads), the per-key React hook
+// (the hook layer, same precedent as the apps hooks below), and the pure
+// device-model key helpers. The raw useSettingsStore stays internal;
+// imperative access goes through engine.settings.
+export { SETTINGS, useSetting } from "./stores/settings";
+export { MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice } from "./stores/bluetoothSettingKeys";
+// Runtime-shared constants and contract DTOs.
+export { ISLAND_SETTINGS_KEYS } from "./runtime/config";
+// Pure readiness predicates over glasses connection state.
+export { isGlassesConnected, isGlassesReady, isGlassesLinkLayerBusy, waitForGlassesReady, } from "./services/GlassesReadiness";
+// Pure connect/reconnect decision helpers (host UI renders the outcome).
+export { decideReconnect, decideConnectButtonAction, } from "./services/ConnectionCoordinator";
+// OTA install policy (watchdog timings + failure copy) + display-state
+// derivation, consumed by the OTA screens and their tests.
+export { MINIMUM_OTA_STATUS_BUILD, MAX_RETRIES, RETRY_INTERVAL_MS, PROGRESS_TIMEOUT_MS, DOWNLOAD_STUCK_TIMEOUT_MS, MTK_INSTALL_TIMEOUT_MS, GLOBAL_OTA_TIMEOUT_MS, POST_APK_OTA_START_DELAY_MS, PING_INTERVAL_MS, QUERY_REPLY_TIMEOUT_MS, OtaProgressMessages, } from "./services/otaInstallPolicy";
+export { deriveDisplayState } from "./services/otaDisplayState";
+export { MediaLibraryPermissions } from "./utils/permissions/MediaLibraryPermissions";
+export { deriveGalleryDisplayName } from "./utils/permissions/galleryDisplayName";
+// Cloud connection status enum (read model; the connection store is internal).
+export { WebSocketStatus } from "./stores/connection";
+// App-list hook layer + pure list helpers (the raw useAppStatusStore and
+// installAppStoreHooks wiring are internal).
+export { DUMMY_APPLET, saveAppsOrder, getAppsOrder, sortAppsByPackageNamePriority, saveLastOpenTime, getLastOpenTime, sortAppsByLastOpenTime, useApps, useStart, useStop, useSetForeground, useClearForeground, useRefresh, useStopAll, useInstall, useUninstall, useActiveApps, useActiveBackgroundApps, useBackgroundApps, useActiveForegroundApp, useForegroundApp, useActiveBackgroundAppsCount, useLocalMiniApps, } from "./stores/apps";
+// Pure dev-miniapp launch-route decision (registration itself is internal).
+export { decideDevLaunchRoute } from "./utils/devMiniappLaunch";
+export { HardwareCompatibility } from "./utils/hardware";
+export { BgTimer, throttle, debounce } from "./utils/timers";
+// Types (copied from @mentra/types — keep in sync with cloud/packages/types/src)
+export { HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes, HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, vuzixZ100, mentraDisplay, } from "./types";
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AAuB/B,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,kDAAkD;AAClD,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAC,wBAAwB,EAAE,gCAAgC,EAAC,MAAM,+BAA+B,CAAA;AAExG,8CAA8C;AAC9C,OAAO,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAA;AAQrD,2DAA2D;AAC3D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAA;AACpC,yEAAyE;AACzE,OAAO,EACL,eAAe,EACf,yBAAyB,GAI1B,MAAM,kCAAkC,CAAA;AAazC,uEAAuE;AACvE,2DAA2D;AAC3D,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAA;AAe7D,OAAO,EAAC,uBAAuB,EAAC,MAAM,6CAA6C,CAAA;AACnF,OAAO,EAAC,wBAAwB,EAAC,MAAM,wCAAwC,CAAA;AAO/E,+EAA+E;AAC/E,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAA;AAEnD,yEAAyE;AACzE,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,OAAO,EACP,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AAEtB,4EAA4E;AAC5E,OAAO,EAAC,oBAAoB,EAAyC,MAAM,0BAA0B,CAAA;AACrG,OAAO,EAAC,qBAAqB,EAA2B,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAA;AAE1D,iFAAiF;AACjF,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAA","sourcesContent":["/**\n * `@mentra/engine` — the OEM-facing main entry.\n *\n * The `engine` namespace (configure/start/stop + typed domain facades), the\n * public contract/read-model types, and the pure helpers host UI legitimately\n * renders with (decision functions, sort/order helpers, policy constants,\n * capability tables, timers). Judgment rule: read models, commands, pure\n * functions and types belong here; anything that mutates runtime state or\n * exposes a raw store/service lives on `@mentra/engine/internal`\n * (migration-era surface) or `@mentra/engine/devtools` (debug-only) instead.\n * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n */\n\n// The namespaced OEM-facing engine API (the \"(A) host API\"). See ./engine.\nexport {engine} from \"./engine\"\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n  ReportSubmitResult,\n  EngineSubmitReportInput,\n} from \"./facades/reports\"\nexport type {IslandNotification, IslandNotificationKind} from \"./facades/notifications\"\nexport type {WifiSearchResult} from \"./facades/glassesWifi\"\nexport type {IdentitySnapshot} from \"./services/PairingIdentity\"\nexport type {DisplayMirrorEvent} from \"./facades/displayMirror\"\nexport type {\n  IslandConfigureOptions,\n  IslandAuth,\n  IslandConfigValues,\n  IslandAnalytics,\n  IslandUiSeams,\n  SubjectTokenType,\n} from \"./runtime/bootstrap\"\n\n// Settings contract: the typed key registry (schema descriptors — the same\n// surface engine.settings.descriptor()/keys() reads), the per-key React hook\n// (the hook layer, same precedent as the apps hooks below), and the pure\n// device-model key helpers. The raw useSettingsStore stays internal;\n// imperative access goes through engine.settings.\nexport {SETTINGS, useSetting} from \"./stores/settings\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\n\n// Runtime-shared constants and contract DTOs.\nexport {ISLAND_SETTINGS_KEYS} from \"./runtime/config\"\nexport type {\n  CloudClientStatusSnapshot,\n  MiniappAuthToken,\n  InteropAuditEvent,\n  TtsSynthesisResult,\n} from \"./runtime/config\"\n\n// Pure readiness predicates over glasses connection state.\nexport {\n  isGlassesConnected,\n  isGlassesReady,\n  isGlassesLinkLayerBusy,\n  waitForGlassesReady,\n  type GlassesConnectionStatus,\n  type WaitForGlassesReadyOptions,\n} from \"./services/GlassesReadiness\"\n// Pure connect/reconnect decision helpers (host UI renders the outcome).\nexport {\n  decideReconnect,\n  decideConnectButtonAction,\n  type ReconnectDecision,\n  type ReconnectDecisionInput,\n  type ConnectButtonAction,\n} from \"./services/ConnectionCoordinator\"\n\n// OTA read-model types for host OTA UI (progress screen, error mapping,\n// progress section) — the check/install machinery itself is internal.\nexport type {\n  VersionInfo,\n  MtkPatch,\n  BesFirmware,\n  VersionJson,\n  OtaCheckResult,\n  OtaCheckCurrentGlassesResult,\n  OtaCheckCurrentGlassesOptions,\n} from \"./services/OtaUpdateCheckService\"\n// OTA install policy (watchdog timings + failure copy) + display-state\n// derivation, consumed by the OTA screens and their tests.\nexport {\n  MINIMUM_OTA_STATUS_BUILD,\n  MAX_RETRIES,\n  RETRY_INTERVAL_MS,\n  PROGRESS_TIMEOUT_MS,\n  DOWNLOAD_STUCK_TIMEOUT_MS,\n  MTK_INSTALL_TIMEOUT_MS,\n  GLOBAL_OTA_TIMEOUT_MS,\n  POST_APK_OTA_START_DELAY_MS,\n  PING_INTERVAL_MS,\n  QUERY_REPLY_TIMEOUT_MS,\n  OtaProgressMessages,\n} from \"./services/otaInstallPolicy\"\nexport {deriveDisplayState} from \"./services/otaDisplayState\"\nexport type {DisplayState} from \"./services/otaDisplayState\"\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  OtaSnapshot,\n  OtaInstallSnapshot,\n} from \"./facades/ota\"\n\n// Gallery read models: engine.gallery.onNotice payload types, the media\n// permission helper + display-name derivation host gallery UI uses, and the\n// glasses-camera DTO types (re-exported through the host @/types/asg shim).\nexport type {GalleryNotice, GalleryNoticeCode} from \"./services/asg/galleryNotices\"\nexport {MediaLibraryPermissions} from \"./utils/permissions/MediaLibraryPermissions\"\nexport {deriveGalleryDisplayName} from \"./utils/permissions/galleryDisplayName\"\nexport type {PhotoInfo, CaptureFile, CaptureGroup, GalleryResponse, ServerStatus, HealthResponse, GalleryEvent} from \"./types/asg\"\n\n// Bluetooth SDK event types host UI subscribes to via engine facades (the\n// BluetoothSdk singleton passthrough itself is internal).\nexport type {PairFailureEvent, GlassesNotReadyEvent} from \"@mentra/bluetooth-sdk/internal\"\n\n// Cloud connection status enum (read model; the connection store is internal).\nexport {WebSocketStatus} from \"./stores/connection\"\n\n// App-list hook layer + pure list helpers (the raw useAppStatusStore and\n// installAppStoreHooks wiring are internal).\nexport {\n  DUMMY_APPLET,\n  saveAppsOrder,\n  getAppsOrder,\n  sortAppsByPackageNamePriority,\n  saveLastOpenTime,\n  getLastOpenTime,\n  sortAppsByLastOpenTime,\n  useApps,\n  useStart,\n  useStop,\n  useSetForeground,\n  useClearForeground,\n  useRefresh,\n  useStopAll,\n  useInstall,\n  useUninstall,\n  useActiveApps,\n  useActiveBackgroundApps,\n  useBackgroundApps,\n  useActiveForegroundApp,\n  useForegroundApp,\n  useActiveBackgroundAppsCount,\n  useLocalMiniApps,\n  type StartOptions,\n  type OrderMap,\n} from \"./stores/apps\"\n\n// Pure dev-miniapp launch-route decision (registration itself is internal).\nexport {decideDevLaunchRoute, type DevLaunchResult, type DevManifest} from \"./utils/devMiniappLaunch\"\nexport {HardwareCompatibility, type CompatibilityResult} from \"./utils/hardware\"\nexport {BgTimer, throttle, debounce} from \"./utils/timers\"\n\n// Types (copied from @mentra/types — keep in sync with cloud/packages/types/src)\nexport {\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  ControllerTypes,\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./types\"\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n  AppletType,\n  AppPermissionType,\n  AppletPermission,\n  AppletInterface,\n  ClientApp,\n} from \"./types\"\n"]}