@myerscarpenter/quest-dev 1.4.1 → 2.0.0

package/build/utils/test-properties.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Meta Scriptable Testing API (content://com.oculus.rc) utilities.
+ *
+ * Shared between stay-awake and cast commands for managing test mode
+ * properties (guardian, autosleep, dialogs, proximity).
+ */
+export interface TestProperties {
+    disable_guardian: boolean;
+    disable_dialogs: boolean;
+    disable_autosleep: boolean;
+    set_proximity_close: boolean;
+}
+/**
+ * Build ADB args for SET_PROPERTY call.
+ */
+export declare function buildSetPropertyArgs(pin: string, enabled: boolean): string[];
+/**
+ * Parse GET_PROPERTY Bundle output into structured data.
+ * Input: "Bundle[{disable_guardian=true, set_proximity_close=true, ...}]"
+ */
+export declare function parseTestProperties(output: string): TestProperties;
+/**
+ * Call SET_PROPERTY to enable or disable test mode.
+ */
+export declare function setTestProperties(pin: string, enabled: boolean): Promise<void>;
+/**
+ * Call GET_PROPERTY and return parsed test properties.
+ */
+export declare function getTestProperties(): Promise<TestProperties>;
+/**
+ * Format test properties for display.
+ */
+export declare function formatTestProperties(props: TestProperties): string;
+//# sourceMappingURL=test-properties.d.ts.map

package/build/utils/test-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-properties.d.ts","sourceRoot":"","sources":["../../src/utils/test-properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAW5E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAoBlE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAOjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQlE"}

package/build/utils/test-properties.js

@@ -0,0 +1,73 @@
+/**
+ * Meta Scriptable Testing API (content://com.oculus.rc) utilities.
+ *
+ * Shared between stay-awake and cast commands for managing test mode
+ * properties (guardian, autosleep, dialogs, proximity).
+ */
+import { execCommand, execCommandFull } from "./exec.js";
+import { adbArgs } from "./adb.js";
+/**
+ * Build ADB args for SET_PROPERTY call.
+ */
+export function buildSetPropertyArgs(pin, enabled) {
+    return [
+        "shell", "content", "call",
+        "--uri", "content://com.oculus.rc",
+        "--method", "SET_PROPERTY",
+        "--extra", `disable_guardian:b:${enabled}`,
+        "--extra", `disable_dialogs:b:${enabled}`,
+        "--extra", `disable_autosleep:b:${enabled}`,
+        "--extra", `set_proximity_close:b:${enabled}`,
+        "--extra", `PIN:s:${pin}`,
+    ];
+}
+/**
+ * Parse GET_PROPERTY Bundle output into structured data.
+ * Input: "Bundle[{disable_guardian=true, set_proximity_close=true, ...}]"
+ */
+export function parseTestProperties(output) {
+    const defaults = {
+        disable_guardian: false,
+        disable_dialogs: false,
+        disable_autosleep: false,
+        set_proximity_close: false,
+    };
+    const match = output.match(/Bundle\[\{(.+)\}\]/);
+    if (!match)
+        return defaults;
+    const pairs = match[1].split(",").map((s) => s.trim());
+    for (const pair of pairs) {
+        const [key, value] = pair.split("=");
+        if (key && value && key in defaults) {
+            defaults[key] = value === "true";
+        }
+    }
+    return defaults;
+}
+/**
+ * Call SET_PROPERTY to enable or disable test mode.
+ */
+export async function setTestProperties(pin, enabled) {
+    const args = adbArgs(...buildSetPropertyArgs(pin, enabled));
+    await execCommand("adb", args);
+}
+/**
+ * Call GET_PROPERTY and return parsed test properties.
+ */
+export async function getTestProperties() {
+    const result = await execCommandFull("adb", adbArgs("shell", "content", "call", "--uri", "content://com.oculus.rc", "--method", "GET_PROPERTY"));
+    return parseTestProperties(result.stdout);
+}
+/**
+ * Format test properties for display.
+ */
+export function formatTestProperties(props) {
+    const lines = [
+        `  Guardian disabled:  ${props.disable_guardian}`,
+        `  Dialogs disabled:  ${props.disable_dialogs}`,
+        `  Autosleep disabled: ${props.disable_autosleep}`,
+        `  Proximity close:   ${props.set_proximity_close}`,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=test-properties.js.map

package/build/utils/test-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-properties.js","sourceRoot":"","sources":["../../src/utils/test-properties.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AASnC;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,OAAgB;IAChE,OAAO;QACL,OAAO,EAAE,SAAS,EAAE,MAAM;QAC1B,OAAO,EAAE,yBAAyB;QAClC,UAAU,EAAE,cAAc;QAC1B,SAAS,EAAE,sBAAsB,OAAO,EAAE;QAC1C,SAAS,EAAE,qBAAqB,OAAO,EAAE;QACzC,SAAS,EAAE,uBAAuB,OAAO,EAAE;QAC3C,SAAS,EAAE,yBAAyB,OAAO,EAAE;QAC7C,SAAS,EAAE,SAAS,GAAG,EAAE;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,QAAQ,GAAmB;QAC/B,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,KAAK;QACxB,mBAAmB,EAAE,KAAK;KAC3B,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAE5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;YACpC,QAAQ,CAAC,GAA2B,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,OAAgB;IAEhB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,CACjD,OAAO,EAAE,SAAS,EAAE,MAAM,EAC1B,OAAO,EAAE,yBAAyB,EAClC,UAAU,EAAE,cAAc,CAC3B,CAAC,CAAC;IACH,OAAO,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,MAAM,KAAK,GAAG;QACZ,yBAAyB,KAAK,CAAC,gBAAgB,EAAE;QACjD,wBAAwB,KAAK,CAAC,eAAe,EAAE;QAC/C,yBAAyB,KAAK,CAAC,iBAAiB,EAAE;QAClD,wBAAwB,KAAK,CAAC,mBAAmB,EAAE;KACpD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myerscarpenter/quest-dev",
-  "version": "1.4.1",
+  "version": "2.0.0",
   "description": "CLI tools for Meta Quest development — stay awake, screenshots, URL opening, logcat, and battery via ADB",
   "type": "module",
   "bin": {
@@ -9,13 +9,13 @@
   "main": "./build/index.js",
   "scripts": {
     "clean": "rm -rf build",
-    "build": "pnpm run clean && tsc && chmod +x build/index.js",
+    "build": "pnpm -r run build && pnpm run clean && tsc && mkdir -p build/public && cp src/public/index.html src/public/style.css build/public/ && npx esbuild src/public/dashboard.js --bundle --format=iife --outfile=build/public/dashboard.js && chmod +x build/index.js",
     "start": "pnpm run build && node build/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage",
-    "install:global": "pnpm run build && pnpm pack && pnpm install -g $PWD/myerscarpenter-quest-dev-$(node -p \"require('./package.json').version\").tgz && rm myerscarpenter-quest-dev-$(node -p \"require('./package.json').version\").tgz",
+    "install:global": "pnpm -r run build && pnpm run build && pnpm link --global",
     "version:patch": "pnpm version patch",
     "version:minor": "pnpm version minor",
     "version:major": "pnpm version major"
@@ -31,14 +31,19 @@
     "xr",
     "screenshot"
   ],
-  "author": "",
+  "author": "Myers Carpenter <myers@maski.org>",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/myers/quest-dev"
   },
   "dependencies": {
-    "exiftool-vendored": "^35.1.0",
+    "@myerscarpenter/cast2-protocol": "workspace:*",
+    "@fastify/static": "^9.0.0",
+    "adbkit-apkreader": "^3.2.0",
+    "fastify": "^5.8.2",
+    "htm": "^3.1.1",
+    "preact": "^10.29.0",
     "which": "^4.0.0",
     "yargs": "^18.0.0"
   },
@@ -48,6 +53,7 @@
     "@types/yargs": "^17.0.33",
     "@vitest/ui": "^4.0.3",
     "c8": "^10.1.3",
+    "esbuild": "^0.27.4",
     "typescript": "^5.9.2",
     "vitest": "^4.0.3"
   },

package/packages/cast2-protocol/README.md

@@ -0,0 +1,86 @@
+# @myerscarpenter/cast2-protocol
+
+Pure TypeScript implementation of the Meta Quest **Cast 2.0** binary protocol — XRSP framing, MGIK sub-headers, MUD message builders/parsers, pose math, and resolution presets.
+
+Zero runtime dependencies. Works in Node.js ≥ 18.
+
+## Install
+
+```bash
+npm install @myerscarpenter/cast2-protocol
+```
+
+## Quick Start
+
+```typescript
+import {
+  packXrsp,
+  packMgikSub,
+  buildInit,
+  buildPose,
+  buildConfig,
+  createPoseState,
+  updatePose,
+  CAST_PORT,
+  RESOLUTIONS,
+} from "@myerscarpenter/cast2-protocol";
+
+// Build an INIT command
+const subMagic = 0xdeadbeef; // learned from Quest's first message
+const payload = buildInit(subMagic, /* seq */ 0);
+const frame = packXrsp(/* seq */ 0, payload);
+
+// Pose management
+let pose = createPoseState();
+pose = updatePose(pose, { dYaw: 0.5, dForward: 1.0 });
+const posePayload = buildPose(subMagic, 1, pose);
+```
+
+## API Overview
+
+### XRSP (framing layer)
+- `packXrsp(seq, payload, flags?, topic?)` — pack an XRSP frame
+- `parseXrspHeader(data)` — parse 8-byte XRSP header
+- `xrspPayloadSize(header)` — compute payload size from header
+
+### MGIK (sub-header)
+- `packMgikSub(subMagic, msgSeq)` — pack 24-byte MGIK sub-header
+- `parseMgikSub(data)` — parse MGIK sub-header
+- `detectSubMagic(payload)` — detect sub_magic from Quest's initial message
+- `isMgikMagic(payload)` — check for "MGIK" magic bytes
+
+### MUD (message builders)
+- `buildInit`, `buildConfig`, `buildKeepalive`, `buildShortAck`
+- `buildPose`, `buildDisplayConfig`, `buildDisconnect`
+- `buildSetProperty`, `buildVirtualMouse`
+- `buildInputForwardingState`, `buildStartInputForwarding`, `buildActivateLayer`
+- `buildMud` — arbitrary MUD message
+- `parseLayerConfiguration` — parse LayerConfiguration responses
+- `packMudString` / `parseMudString` — length-prefixed string encoding
+
+### Pose Math
+- `createPoseState()` — identity pose at origin
+- `eulerToQuat(yaw, pitch)` — euler angles to quaternion
+- `updatePose(state, delta)` — apply incremental movement
+- `setPoseOffset(state, offset)` — set absolute offset
+- `screenToYawPitch(x, y, ...)` — screen coordinates to yaw/pitch
+
+### Resolutions
+- `RESOLUTIONS` — preset map (`720p`, `1080p`, `native`)
+- `resolveResolution(name?, width?, height?)` — resolve to width/height
+
+### Constants
+All protocol constants are exported: `CAST_PORT`, `QUEST_CAST_PORT`, `XRSP_HEADER_SIZE`, `MGIK_MAGIC`, command IDs (`CMD_POSE`, `CMD_INIT`, etc.), eye selectors (`EYE_LEFT`, `EYE_RIGHT`, `EYE_STEREO`), layer types, and more.
+
+### Types
+- `XrspHeader`, `MgikSubHeader`, `LayerInfo`
+- `PoseState`, `PoseDelta`, `PoseOffset`
+- `Resolution`
+
+## Documentation
+
+Full protocol documentation is available at [myers.github.io/quest-dev](https://myers.github.io/quest-dev/).
+
+## License
+
+MIT

package/packages/cast2-protocol/docs/_config.yml

@@ -0,0 +1,4 @@
+theme: jekyll-theme-minimal
+title: Cast 2.0 Protocol
+description: Protocol documentation for Meta Quest Cast 2.0 video streaming
+baseurl: /quest-dev

package/packages/cast2-protocol/docs/feature-flags.md

@@ -0,0 +1,102 @@
+---
+title: MQDH Feature Flags
+layout: default
+---
+
+# MQDH Feature Flags (Gatekeepers)
+
+Known feature flags used by Meta Quest Developer Hub for Cast 2.0 configuration.
+
+## Magic Island / Casting
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_xplat_magic_island_feature_wireless_casting_2` | Wireless casting support |
+| `mqdh_xplat_magic_island_feature_input_forwarding_2` | Input forwarding (mouse/keyboard/cursor) |
+| `mqdh_xplat_magic_island_feature_gaze_click` | Gaze-based click via VirtualCamera pose |
+| `mqdh_xplat_magic_island_text_forwarding` | Text input forwarding |
+| `mqdh_xplat_magic_island_mic_audio` | Microphone audio |
+| `mqdh_xplat_magic_island_force_reapply_fov` | Force reapply FOV |
+| `mqdh_xplat_magic_island_system_monitor` | System monitor overlay |
+| `mqdh_xplat_magic_island_panel_streaming` | Panel app streaming |
+| `mqdh_xplat_magic_island_feature_casting_tour` | Casting onboarding tour |
+| `xplat_magic_island_image_stabilization` | Image stabilization |
+
+## Metacam / Screen Capture
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_metacam_screen_capture_v63` | Screen capture (OS v63+) |
+| `mqdh_metacam_video_capture` | Video capture |
+
+## Input Forwarding (legacy)
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_input_forwarding_feature` | Legacy input forwarding feature flag |
+
+## Link
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_link_terminate_via_qlh` | Terminate Link via Quest Link Hub |
+| `mqdh_link_dogfood_hub` | Link dogfood hub |
+
+## Device Management
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_auto_disable_proximity_sensor` | Auto-disable prox sensor |
+| `mqdh_disable_proximity_sensor_with_duration` | Timed prox sensor disable |
+| `mqdh_collect_hmd_logs` | Collect headset logs |
+| `mqdh_redesign_device_manager` | Redesigned device manager UI |
+| `mqdh_quick_ble_connect_v2` | Quick BLE connect v2 |
+| `mqdh_ble_security_fixes` | BLE security fixes |
+| `mqdh_ignore_ble_already_connected` | Ignore BLE already connected state |
+| `mqdh_release_channel` | Release channel support |
+| `mqdh_release_channel_selector` | Release channel selector UI |
+| `mqdh_system_apk` | System APK management |
+| `mqdh_device_setup_ab_test` | Device setup A/B test |
+
+## App / UI
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_redesign_home` | Redesigned home screen |
+| `mqdh_redesign_settings` | Redesigned settings |
+| `mqdh_logcat_redesign` | Redesigned logcat viewer |
+| `mqdh_development_view` | Development view |
+| `mqdh_enable_link_card` | Link card UI |
+| `mqdh_enable_expanded_link_card` | Expanded link card UI |
+| `mqdh_file_mananger_sync` | File manager sync (typo in original) |
+| `mqdh_live_build_test_status` | Live build test status |
+| `mqdh_in_app_sentiment_survey` | In-app sentiment survey |
+| `mqdh_ai_companion` | AI companion feature |
+| `mqdh_xr_projects_flythrough` | XR projects flythrough |
+| `mqdh_enable_3p_network_impairment_tool` | Network impairment tool |
+| `mqdh_audience_attestation_selection` | Audience attestation |
+
+## Auto-Update
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_force_update_enabled_v2` | Force update enabled |
+| `mqdh_force_update_internal_user` | Internal user update |
+| `mqdh_force_update_safe_listed_user` | Safe-listed user |
+| `mqdh_autoupdate_modal_workflow_public_v3` | Auto-update modal v3 |
+| `mqdh_automated_adb_path_fixing_v2` | Automated ADB path fix |
+
+## Dogfooding
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_dogfooding_hub` | Dogfooding hub |
+| `mqdh_dogfooding_hub_bluetooth` | Dogfooding via BT |
+| `mqdh_dogfooding_skip_nux` | Skip NUX for dogfood |
+
+## Telemetry
+
+| Flag | Description |
+|------|-------------|
+| `mqdh_unified_telemetry_consent_ui` | Telemetry consent UI |
+| `mqdh_unified_telemetry_internal_only_test` | Internal telemetry test |

package/packages/cast2-protocol/docs/index.md

@@ -0,0 +1,24 @@
+---
+title: Cast 2.0 Protocol Documentation
+layout: default
+---
+
+# Cast 2.0 Protocol Documentation
+
+Cast 2.0 is the binary protocol used by Meta Quest headsets for wireless video casting. It layers MGIK message framing inside XRSP transport frames, carrying H.264 video, pose data, input forwarding, and control commands over TCP.
+
+This documentation covers the protocol wire format, message types, and known capabilities.
+
+## Reference
+
+- [Cast 2.0 Protocol Reference](protocol.md) — Wire format, handshake sequence, message types
+- [MQDH Feature Flags](feature-flags.md) — Feature flag reference for Meta Quest Developer Hub
+- [Unsupported Capabilities](open-investigations.md) — Audio, panel streaming, WiFi casting, and other known but unimplemented features
+
+## Package
+
+The TypeScript implementation is available as [`@myerscarpenter/cast2-protocol`](https://www.npmjs.com/package/@myerscarpenter/cast2-protocol) on npm.
+
+```bash
+npm install @myerscarpenter/cast2-protocol
+```

package/packages/cast2-protocol/docs/open-investigations.md

@@ -0,0 +1,149 @@
+---
+title: Unsupported Capabilities
+layout: default
+---
+
+# Unsupported Capabilities
+
+Cast 2.0 supports more than video and pose. These are protocol capabilities that are known to exist but are **not yet implemented** in this package or in quest-dev.
+
+---
+
+## Audio Streaming
+
+The protocol carries audio alongside video. The Quest initializes its audio capture pipeline on every casting session but produces no output until the host explicitly enables it.
+
+**Protocol support:**
+- 48 kHz, stereo, 16-bit PCM (uncompressed)
+- Two independent sources: app/system audio and microphone, mixed before transmission
+- Host sends `SetAudioState(1)` (MUD type 503) to enable app audio
+- Host sends `SetMicAudioState(1)` (MUD type 505) to enable microphone
+- Mic requires the `magic_casting:support_mic_audio` server feature flag
+- AudioSegment wire format: `i32(type=102) + i32(layerId) + i64(timestamp_us) + PCM payload`
+- Read buffer is 7680 bytes (1920 samples per read)
+- Default bitrate 160kbps, latency target 50ms
+
+**Open questions:**
+- What's the actual PCM frame size per packet?
+- Is there a handshake or does audio just start flowing after `SetAudioState(1)`?
+- Can app audio and mic be enabled independently?
+- What latency is achievable over TCP?
+
+---
+
+## Panel Streaming
+
+Panel streaming is a separate mode from eye buffer casting. Instead of streaming the VR compositor output, it streams individual 2D panel apps as separate layers, each with its own VirtualDisplay and input device.
+
+**Protocol support:**
+- Activated via broadcast intent: `com.oculus.magicislandcastingservice.ENABLE_PANEL_STREAMING`
+- Deactivated via: `com.oculus.magicislandcastingservice.DISABLE_PANEL_STREAMING`
+- Creates per-panel VirtualDevice (VirtualDisplay + VirtualMouse + VirtualKeyboard)
+- Each 2D app gets a VOLUMETRIC_WINDOW(3) LayerConfig with name `{token}.{packageName}`
+- CursorEvent input routes through VirtualDevice API, bypassing the normal InputFrameOverride path
+- Requires the `panel_streaming` feature flag
+
+**Open questions:**
+- Does enabling panel streaming during an active cast session work?
+- What LayerConfig messages appear on the wire?
+- Does the video stream change (resolution, format, multiple streams)?
+- Does CursorEvent produce actual clicks in panel apps?
+- Is ActivateLayer (301) needed to select which panel to stream?
+- Can panel streaming and eye buffer casting coexist?
+
+---
+
+## WiFi Casting (No ADB Tunnel)
+
+All current implementations use ADB USB tunneling (`adb reverse tcp:4445 tcp:4445`). The protocol also supports casting over WiFi.
+
+**Open questions:**
+- Does WiFi casting use the same protocol or add TLS?
+- Is there a discovery/pairing phase before the TCP connection?
+- Same port (4445) or different?
+- Does MQDH use mDNS or another service discovery mechanism?
+
+---
+
+## Congestion Control
+
+The protocol includes a congestion control system with configurable parameters. Not yet tested.
+
+**Known properties (configurable via SetProperty):**
+- `congestionControlWindow`: 1.0s
+- `congestionControlDecreaseThreshold`: 2.0
+- `congestionControlIncreaseThreshold`: 1.2
+- `congestionControlMultiplicativeDecrease`: 0.85
+- `congestionControlAdditiveIncrease`: 250,000 bits/sec
+- `captureEncoderBitrate`: 40,000,000 bits/sec (40Mbps default)
+
+**Open questions:**
+- How does the Quest signal congestion to the host?
+- Does adjusting these properties via SetProperty change stream quality?
+- Is the encoder bitrate dynamically reduced under load?
+
+---
+
+## FOV Adjustment
+
+Two commands carry FOV-related fields.
+
+**Protocol support:**
+- `SetDeviceEyeFovConfig(inward, outward, up, down)` — 4 i32 params
+- `UpdateCastingConfig` includes a `fovAdjustment` float field
+- All zeros = use device defaults
+
+**Open questions:**
+- What visible effect does changing FOV have on the stream?
+- Are the units degrees or radians?
+- Does FOV adjustment change resolution or just crop?
+
+---
+
+## Image Stabilization
+
+`UpdateCastingConfig` has an `imageStabilizationMode` field (defaults to 0). Related to the `image_stabilization` feature flag.
+
+**Open questions:**
+- What values are valid?
+- What does stabilization mean in a VR casting context?
+- Does enabling it affect latency?
+
+---
+
+## Lifecycle Commands
+
+Three empty-payload MUD messages exist for development tooling:
+
+| MUD Type | Command | Description |
+|----------|---------|-------------|
+| 500 | ReloadApp | Reload the casting service runtime |
+| 502 | ToggleInspector | Toggle performance overlay |
+| 504 | OpenDebugger | Open debugger port |
+
+Not used by any known host implementation.
+
+---
+
+## Dialog System
+
+MUD types for a dialog system exist but are not used during normal casting:
+
+| MUD Type | Command |
+|----------|---------|
+| 400 | ShowDialog |
+| 401 | DialogButtonPress |
+| 402 | SystemDialogResult |
+
+Likely triggered by error conditions or permission prompts during casting.
+
+---
+
+## Tracking Mode Control
+
+`setTrackingMode(int32 mode)` accepts mode values 0-255. Effects on the tracking system are unknown.
+
+**Open questions:**
+- What do different mode values do?
+- Is there a mode that disables head tracking?
+- Does this interact with the pose injection pipeline?