@glassly/engine 0.3.2-dev.566 → 0.3.2-dev.574

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.3.2",
-  "releaseIdentity": "0.3.2-dev.566",
-  "releaseSetId": "glassly-0.3.2-dev.566",
-  "sourceCommit": "86bb1ba25f42f9efe2aaf740792f5cf787b98f35",
+  "releaseIdentity": "0.3.2-dev.574",
+  "releaseSetId": "glassly-0.3.2-dev.574",
+  "sourceCommit": "959420ded485d85438cc44e085ba61388cbdd72a",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -7,7 +7,7 @@
  * 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 remains private to the Glassly host.
- * See cloud-v2/docs/issues/020-glasses-status-boundary/integration-review.md §D.
+ * See cloud/docs/issues/020-glasses-status-boundary/integration-review.md §D.
  */
 
 // The namespaced OEM-facing engine API (the "(A) host API"). See ./engine.

package/src/runtime/bootstrap.ts

@@ -29,9 +29,9 @@ export interface IslandAuth {
 }
 
 export interface IslandConfigValues {
-  /** cloud-v2 core service base URL (defaults resolved by the cloud client). */
+  /** cloud core service base URL (defaults resolved by the cloud client). */
   coreUrl?: string
-  /** cloud-v2 runtime service base URL. */
+  /** cloud runtime service base URL. */
   runtimeUrl?: string
   /** OEM identifier (Glassly is OEM #0); reserved for OEM auth/telemetry. */
   oemId?: string

package/src/services/CloudAudioSubscriptionSync.ts

@@ -5,12 +5,12 @@
  *
  * Failure mode this protects:
  * 1. Local captions subscribes to transcription.
- * 2. The first Cloud V2 `PUT /api/audio/subscriptions` throws while the socket
+ * 2. The first Cloud `PUT /api/audio/subscriptions` throws while the socket
  *    is reconnecting or Core is briefly unreachable.
  * 3. A reconnect/resync recomputes the same desired subscription set.
  *
  * If we mark the set as "last applied" before the PUT succeeds, step 3 is
- * incorrectly deduped and captions can wait forever even though Cloud V2 later
+ * incorrectly deduped and captions can wait forever even though Cloud later
  * reconnects. So `begin()` only blocks exact duplicates while a write is in
  * flight; only `succeeded()` promotes that key to the applied state.
  */

package/src/services/CloudClientService.ts

@@ -35,7 +35,7 @@ import {storage as mmkvStorage} from "../utils/storage"
 import {useCloudClientStatusStore} from "../stores/cloudClientStatus"
 import {islandNotifications} from "./NotificationsEmitter"
 import {BgTimer} from "../utils/timers"
-import {logCloudV2TranscriptMetric} from "./CloudTranscriptE2EMetrics"
+import {logCloudTranscriptMetric} from "./CloudTranscriptE2EMetrics"
 import {isLocalUserId, LocalMiniappUserIdentity} from "./LocalMiniappUserIdentity"
 import {migrateLocalMiniappData, type LocalMiniappDataMigrationBackend} from "./LocalMiniappDataMigration"
 import {nativeHttpResponseBody} from "./NativeHttpResponse"
@@ -580,7 +580,7 @@ function construct(): void {
   })
   transcriptUnsubscribe = c.runtime.onTranscript((data) => {
     if (c !== client) return
-    logCloudV2TranscriptMetric(data)
+    logCloudTranscriptMetric(data)
     emitTranscript(data)
   })
   translationUnsubscribe = c.runtime.onTranslation((data) => {
@@ -857,7 +857,7 @@ export const cloudClientService = {
     stopDisableCloudWatcher()
   },
 
-  /** Device-side managed photo (cloud-v2): presign now, deliver bytes, await ready. */
+  /** Device-side managed photo: presign now, deliver bytes, await ready. */
   startManagedPhoto(opts: Record<string, unknown> = {}) {
     if (!client) throw new Error("cloud client not connected")
     return client.runtime.startManagedPhoto(opts)
@@ -867,7 +867,7 @@ export const cloudClientService = {
     return client.runtime.awaitManagedPhotoReady(requestId)
   },
 
-  /** Managed stream (cloud-v2): provision ingest+playback on the runtime. */
+  /** Managed stream: provision ingest+playback on the runtime. */
   startManagedStream(opts: Record<string, unknown> = {}) {
     if (!client) throw new Error("cloud client not connected")
     return client.runtime.startManagedStream(opts)

package/src/services/CloudTranscriptE2EMetrics.ts

@@ -2,7 +2,7 @@ import type {TranscriptionData} from "@glassly/cloud-protocol"
 
 import {buildE2EMetric, logE2EMetricPayload} from "../utils/e2eMetrics"
 
-export function buildCloudV2TranscriptMetric(data: TranscriptionData): Record<string, unknown> {
+export function buildCloudTranscriptMetric(data: TranscriptionData): Record<string, unknown> {
   return buildE2EMetric("cloud_v2_transcript", {
     text: data.text,
     state: data.isFinal ? "final" : "interim",
@@ -22,6 +22,6 @@ export function buildCloudV2TranscriptMetric(data: TranscriptionData): Record<st
   })
 }
 
-export function logCloudV2TranscriptMetric(data: TranscriptionData): void {
-  logE2EMetricPayload(buildCloudV2TranscriptMetric(data), "cloud_v2_transcript")
+export function logCloudTranscriptMetric(data: TranscriptionData): void {
+  logE2EMetricPayload(buildCloudTranscriptMetric(data), "cloud_v2_transcript")
 }

package/src/services/LocalMiniappRuntime.ts

@@ -286,7 +286,7 @@ const MINIAPP_AUTH_REFRESH_MIN_DELAY_MS = 5_000
 // (e.g. the cloud client had not finished its first-boot Core token exchange
 // when the miniapp connected). Exponential from base, capped, so a transient
 // not-yet-connected client self-heals within seconds instead of needing a full
-// manual Cloud V2 reconnect.
+// manual Cloud reconnect.
 const MINIAPP_AUTH_RETRY_BASE_MS = 1_000
 const MINIAPP_AUTH_RETRY_MAX_MS = 15_000
 const FOREGROUND_LIVENESS_PROBE_TIMEOUT_MS = 2_500
@@ -1826,7 +1826,7 @@ class LocalMiniappRuntime {
       // right after app start. CONNECT_ACK already went out without auth; keep
       // trying to mint (and re-drive on cloud-connect) so the app authenticates
       // to its backend on its own, instead of staying dead until a full manual
-      // Cloud V2 reconnect re-runs the whole handshake.
+      // Cloud reconnect re-runs the whole handshake.
       this.deliverInitialMiniappAuth(packageName, authPromise, 0)
     }
     this.sendCloudStatusToMiniapp(packageName)
@@ -1988,7 +1988,7 @@ class LocalMiniappRuntime {
    * When the cloud client (re)connects, immediately re-attempt the initial mint
    * for any handshook app still missing its token, instead of waiting out the
    * backoff. This is what turns "scan a dev app before the cloud is ready" from
-   * "dead until you manually reconnect Cloud V2" into "authenticates on its own
+   * "dead until you manually reconnect Cloud" into "authenticates on its own
    * the instant the connection comes up".
    */
   private redriveMiniappAuthDelivery(): void {

package/src/services/PhonePhotoCoordinator.ts

@@ -5,7 +5,7 @@
  *   miniapp → SDK → LocalMiniappRuntime → photo runtime hook
  *          → coordinator.takePhoto(packageName, opts)
  *            ├── (precheck) glasses connected + hasCamera
- *            ├── cloudClientService.startManagedPhoto → {requestId, uploadUrl, readUrl}  (cloud-v2 runtime presign)
+ *            ├── cloudClientService.startManagedPhoto → {requestId, uploadUrl, readUrl}  (cloud runtime presign)
  *            ├── BluetoothSdk.requestPhoto(requestId, size, uploadUrl, compress, sound)
  *            └── race:
  *                  - cloudClientService.awaitManagedPhotoReady(requestId) resolves on photo.ready push
@@ -179,8 +179,8 @@ export class PhonePhotoCoordinator {
     // high-capacity tier and let the glasses ignore the public size when mode=text.
     const captureSize = opts.size ?? "medium"
 
-    // 1) Presign via the cloud-v2 managed-photo service. Local miniapps use
-    //    ONLY the cloud-v2 path: the runtime presigns upload+read URLs and the
+    // 1) Presign via the cloud managed-photo service. Local miniapps use
+    //    ONLY the cloud path: the runtime presigns upload+read URLs and the
     //    phone (as the device controller) delivers the bytes; the legacy
     //    backend_url mint is gone from this flow.
     let requestId: string
@@ -419,7 +419,7 @@ export class PhonePhotoCoordinator {
     // Abort the in-flight long-poll first so we don't double-resolve.
     entry.abort.abort()
     entry.reject(new PhotoError(errorCode || "GLASSES_ERROR", errorMessage || "Glasses error", "capture", "ble"))
-    // cloud-v2 pending photo requests TTL out on their own; nothing to free.
+    // cloud pending photo requests TTL out on their own; nothing to free.
   }
 
   private toPhotoError(err: unknown, fallbackCode: string, stage?: PhotoStage, transport?: PhotoTransport): PhotoError {

package/src/services/PhoneStreamCoordinator.ts

@@ -4,7 +4,7 @@
  * Architecture:
  *   miniapp → SDK → LocalMiniappRuntime → coordinator
  *           coordinator → BluetoothSdk (BLE → glasses publisher)
- *           coordinator ↔ cloudStreamApi (managed only, cloud-v2 runtime provisioning)
+ *           coordinator ↔ cloudStreamApi (managed only, cloud runtime provisioning)
  *           coordinator ↔ StreamLifecycleController (keep-alive heartbeat)
  *           coordinator → status listeners → routed back to miniapp(s)
  *

package/src/services/SupportProfileSync.ts

@@ -26,7 +26,7 @@ let lastFailure: {code: string; stage: string} | null = null
 let lastConnectionState: string | null = null
 
 /**
- * Keep Cloud V2's canonical support snapshot current without creating an event
+ * Keep Cloud's canonical support snapshot current without creating an event
  * stream from noisy store updates. Only the explicitly selected fields below
  * leave the phone; Wi-Fi, Bluetooth addresses, location and diagnostics do not.
  */
@@ -110,7 +110,7 @@ async function sendCurrentSnapshot(force: boolean, generation = syncGeneration):
     consecutiveSendFailures += 1
     retryDelayMs = retryDelayForSendFailure(consecutiveSendFailures)
     console.warn(
-      `supportProfile: Cloud V2 update failed (retry in ${Math.round(retryDelayMs / 1_000)}s):`,
+      `supportProfile: Cloud update failed (retry in ${Math.round(retryDelayMs / 1_000)}s):`,
       error instanceof Error ? error.message : error,
     )
   } finally {

package/src/services/cloudStreamApi.ts

@@ -1,5 +1,5 @@
 /**
- * Managed-stream provisioning over the cloud-v2 runtime (cloud-client REST):
+ * Managed-stream provisioning over the cloud runtime (cloud-client REST):
  *
  *   POST   /api/camera/stream      -> provision (Cloudflare live input)
  *   GET    /api/camera/stream/:id  -> provider's ingest status
@@ -61,7 +61,7 @@ export class StreamApiError extends Error {
   }
 }
 
-/** The cloud-v2 runtime's ManagedStream wire shape (open records, see protocol). */
+/** The cloud runtime's ManagedStream wire shape (open records, see protocol). */
 interface ManagedStreamWire {
   streamId: string
   ingest: {
@@ -79,7 +79,7 @@ interface ManagedStreamWire {
 }
 
 /**
- * Provision a managed stream on the cloud-v2 runtime. Returns ready-to-publish
+ * Provision a managed stream on the cloud runtime. Returns ready-to-publish
  * ingest URLs (credentials embedded) plus the playback URLs.
  */
 export async function provisionManagedStream(

package/src/services/soniox/SonioxRealtimeClient.ts

@@ -10,8 +10,8 @@
  * machinery) or `@soniox/web` (MediaStream capture): the wire protocol is one
  * JSON config message, then binary PCM frames up / JSON token results down.
  * Protocol shape mirrors the vendored SDK's buildConfigMessage /
- * parseResultMessage (cloud-v2 runtime's provider is the reference
- * implementation: cloud-v2/packages/runtime/src/services/audio/providers/soniox.ts).
+ * parseResultMessage (cloud runtime's provider is the reference
+ * implementation: cloud/packages/runtime/src/services/audio/providers/soniox.ts).
  */
 
 import {BgTimer} from "../../utils/timers"

package/src/services/soniox/SonioxTokenAssembler.ts

@@ -2,7 +2,7 @@
  * SonioxTokenAssembler
  *
  * Pure port of the cloud Soniox provider's utterance assembly
- * (cloud-v2/packages/runtime/src/services/audio/providers/soniox.ts). Soniox
+ * (cloud/packages/runtime/src/services/audio/providers/soniox.ts). Soniox
  * emits a rolling token window that is re-finalized/compacted across results;
  * this class turns that stream into stable interim/final utterances:
  *

package/src/stores/cloudClientStatus.ts

@@ -1,6 +1,6 @@
 /**
  * Cloud-client runtime status store — moved into engine so engine owns the
- * cloud-v2 runtime status (connection status + audio transport). Re-exported
+ * cloud runtime status (connection status + audio transport). Re-exported
  * through the host's `@/stores/cloudClientStatus` shim so the app keeps its
  * imports, and surfaced as `engine.stores.cloudClientStatus`.
  */

package/src/stores/settings.ts

@@ -262,7 +262,7 @@ export const SETTINGS: Record<string, Setting> = {
     saveOnServer: false,
     persist: true,
   },
-  // Cloud V2 endpoint OVERRIDES. Empty = no override; cloudClient's resolveUrl
+  // Cloud endpoint OVERRIDES. Empty = no override; cloudClient's resolveUrl
   // owns the full precedence (override -> env -> Metro-derived dev default).
   // The value may be an explicit URL or the METRO_AUTO sentinel ("my dev
   // laptop", resolved live from Metro so it survives network changes). Never
@@ -284,7 +284,7 @@ export const SETTINGS: Record<string, Setting> = {
     persist: true,
     resetOnBuildEnvChange: true,
   },
-  // Bookmarked Cloud V2 endpoint pairs. Each entry is {label, coreUrl,
+  // Bookmarked Cloud endpoint pairs. Each entry is {label, coreUrl,
   // runtimeUrl} — core + runtime are saved together because they are always
   // applied as a matched set (presets fill both; Save & Test verifies both).
   saved_cloud_url_pairs: {
@@ -411,7 +411,7 @@ export const SETTINGS: Record<string, Setting> = {
     persist: true,
   },
   location_tier: {key: "location_tier", defaultValue: () => "", writable: true, saveOnServer: true, persist: true},
-  // Volatile bearer synced to Bluetooth for glasses-side Cloud V2 calls. The
+  // Volatile bearer synced to Bluetooth for glasses-side Cloud calls. The
   // key name is kept for BLE compatibility, but the value must never be loaded
   // from or saved to the legacy Cloud V1 settings store.
   core_token: {key: "core_token", defaultValue: () => "", writable: true, saveOnServer: false, persist: false},

package/src/utils/cloudClient/cloudSecureStore.ts

@@ -1,8 +1,8 @@
 /**
  * MMKV-backed KeyValueStore for @glassly/cloud-client — moved into engine so
- * engine owns the cloud-v2 credential storage (the v2 refresh token, so a
+ * engine owns the cloud credential storage (the v2 refresh token, so a
  * relaunch does not force a new login). A dedicated MMKV instance keeps
- * cloud-v2 credentials out of the app's general store. Re-exported through the
+ * cloud credentials out of the app's general store. Re-exported through the
  * host's `@/utils/cloudClient/MmkvSecureStore` shim.
  *
  * NOTE: MMKV is not hardware-backed. Before production handling of the