@hienlh/ppm 0.23.11 → 0.23.12

package/src/services/android/emulator-discovery.ts

@@ -0,0 +1,160 @@
+/**
+ * Which emulators are running right now, and how to reach each one's gRPC endpoint.
+ *
+ * The emulator advertises itself in a per-process `.ini` under the *current user's* runtime
+ * directory. Plan §5 requires this to be read defensively: bounded in size, with PID liveness
+ * and process identity verified, and only a loopback endpoint accepted — a stale `.ini` from a
+ * crashed emulator otherwise names a port some unrelated process may now hold.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+
+/** A discovery .ini is a few hundred bytes; anything larger is not one, and we refuse to read it. */
+const MAX_DISCOVERY_BYTES = 64 * 1024;
+
+export interface RunningEmulator {
+  /** Absolute path of the discovery file this came from. */
+  file: string;
+  pid: number;
+  /**
+   * The AVD **id** (`avd.id`) — what `-avd` takes, what an AVD's `config.ini` calls `AvdId`, and
+   * what `listAvds()` reports as `name`. Deliberately not `avd.name`, which is the display name.
+   */
+  avdName: string;
+  avdDir: string | null;
+  emulatorVersion: string | null;
+  grpcPort: number;
+  /** Bearer token for the gRPC channel. Never leaves the backend. */
+  grpcToken: string | null;
+  /** Directory of JSON Web Key Sets, when the emulator offers JWT auth. */
+  grpcJwks: string | null;
+  adbPort: number | null;
+  adbSerial: string | null;
+  /** The emulator's own argv, used to verify this pid is still the process the file describes. */
+  cmdline: string | null;
+}
+
+/** Where the emulator writes discovery files, current user only. */
+export function discoveryDirs(): string[] {
+  const dirs: string[] = [];
+  const runtime = process.env.XDG_RUNTIME_DIR;
+  if (runtime) dirs.push(join(runtime, "avd", "running"));
+  dirs.push(join(homedir(), ".android", "avd", "running"));
+  if (platform() === "win32") {
+    const local = process.env.LOCALAPPDATA;
+    if (local) dirs.push(join(local, "Temp", "avd", "running"));
+  } else {
+    const tmp = process.env.TMPDIR ?? "/tmp";
+    dirs.push(join(tmp, `android-${process.env.USER ?? ""}`, "avd", "running"));
+  }
+  return dirs;
+}
+
+function parseIni(text: string): Record<string, string> {
+  const out: Record<string, string> = {};
+  for (const line of text.split("\n")) {
+    const t = line.trim();
+    if (!t || t.startsWith("#") || t.startsWith("[")) continue;
+    const eq = t.indexOf("=");
+    if (eq <= 0) continue;
+    out[t.slice(0, eq).trim()] = t.slice(eq + 1).trim();
+  }
+  return out;
+}
+
+/** Is this pid alive? Signal 0 tests existence without delivering anything. */
+function pidAlive(pid: number): boolean {
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+/**
+ * Does the live process still look like the emulator the discovery file describes?
+ *
+ * PIDs are reused. Without this, a stale `.ini` whose pid now belongs to something else would
+ * be treated as a running emulator — and a later "stop" would signal an innocent process.
+ */
+export function verifyProcessIdentity(pid: number, avdName: string | undefined): boolean {
+  const avd = avdName;
+  if (!avd) return false;
+  if (platform() !== "linux") {
+    // Only /proc gives a cheap, dependency-free argv. Elsewhere the pid check plus a live gRPC
+    // handshake is what establishes identity, so accept a live pid here and let the connect
+    // prove it.
+    return pidAlive(pid);
+  }
+  try {
+    const argv = readFileSync(`/proc/${pid}/cmdline`, "utf8").split("\0").filter(Boolean);
+    return argv.some((a) => a === avd) || argv.some((a) => a.includes("qemu-system"));
+  } catch {
+    return false;
+  }
+}
+
+function parsePort(v: string | undefined): number | null {
+  const n = Number(v);
+  return Number.isInteger(n) && n > 0 && n <= 65535 ? n : null;
+}
+
+/** Every emulator this user is running that advertises a usable loopback gRPC endpoint. */
+export function findRunningEmulators(): RunningEmulator[] {
+  const found: RunningEmulator[] = [];
+  const seenPids = new Set<number>();
+
+  for (const dir of discoveryDirs()) {
+    let entries: string[];
+    try { entries = readdirSync(dir); } catch { continue; }
+
+    for (const name of entries) {
+      const m = /^pid_(\d+)\.ini$/.exec(name);
+      if (!m) continue;
+      const pid = Number(m[1]);
+      if (seenPids.has(pid)) continue;
+
+      const file = join(dir, name);
+      let fields: Record<string, string>;
+      try {
+        if (statSync(file).size > MAX_DISCOVERY_BYTES) continue;
+        fields = parseIni(readFileSync(file, "utf8"));
+      } catch {
+        continue;   // racing with emulator shutdown is normal
+      }
+
+      const grpcPort = parsePort(fields["grpc.port"]);
+      if (!grpcPort) continue;                       // no control channel, nothing we can drive
+      if (!pidAlive(pid)) continue;                  // stale file from a crashed emulator
+      // pid was reused by something else
+      if (!verifyProcessIdentity(pid, fields["avd.id"] ?? fields["avd.name"])) continue;
+
+      seenPids.add(pid);
+      const adbPort = parsePort(fields["port.adb"]);
+      const serialPort = parsePort(fields["port.serial"]);
+      found.push({
+        file,
+        pid,
+        // `avd.id`, **never** `avd.name`. The discovery file carries both, and for any AVD made
+        // in Android Studio they differ: the id is `Pixel_9` while `avd.name` is `Pixel 9`, the
+        // same string with the underscores turned back into spaces. Read the display name here
+        // and a running emulator stops matching its own AVD row — the device list then shows the
+        // AVD as stopped *and* a second `external:` row beside it with no geometry, and Start is
+        // offered for a device that is already up. Every AVD used while this was built had a
+        // one-word name, where the two fields agree, which is why it was never seen.
+        avdName: fields["avd.id"] ?? fields["avd.name"] ?? "(unknown)",
+        avdDir: fields["avd.dir"] ?? null,
+        emulatorVersion: fields["emulator.version"] ?? null,
+        grpcPort,
+        grpcToken: fields["grpc.token"] ?? null,
+        grpcJwks: fields["grpc.jwks"] ?? null,
+        adbPort,
+        // adb names an emulator by its *console* port, not its adb port.
+        adbSerial: serialPort ? `emulator-${serialPort}` : null,
+        cmdline: fields["cmdline"] ?? null,
+      });
+    }
+  }
+  return found;
+}
+
+export function findRunningEmulatorByAvd(avdName: string): RunningEmulator | null {
+  return findRunningEmulators().find((e) => e.avdName === avdName) ?? null;
+}

package/src/services/android/emulator-launcher.ts

@@ -0,0 +1,290 @@
+/**
+ * Starting and stopping emulators PPM owns.
+ *
+ * Four things here are load-bearing and each one is in the plan for a reason:
+ *
+ *  - **One start per AVD at a time.** A refresh, a double-tap on Start, or two browser tabs must
+ *    not spawn two emulators against one AVD — that corrupts the userdata image. A per-AVD mutex
+ *    plus start idempotency (an in-flight start is *returned*, not duplicated) is what prevents it.
+ *  - **Never `-grpc <port>`.** `emulator -help` says `-grpc-use-jwt ... (default, disable with
+ *    -grpc flag)`, so pinning a port silently drops the control channel to unauthenticated.
+ *    The port is discovered from the emulator's own advertisement instead.
+ *  - **`ANDROID_AVD_HOME` goes in the child's env only.** Setting it on this process would hide
+ *    every AVD outside it from our own listing — it replaces the default rather than adding to it.
+ *  - **A lock file is reported, never removed.** An AVD Android Studio is running stays untouched.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { connectToEmulator, getEmulatorStatus, requestShutdown } from "./android-grpc.ts";
+import { findRunningEmulatorByAvd, findRunningEmulators, type RunningEmulator } from "./emulator-discovery.ts";
+import { claimOwnership, listDevices, releaseOwnership } from "./device-registry.ts";
+import { createOperation, failOperation, finishOperation, updateOperation, type Operation } from "./android-operations.ts";
+import { avdHomeEnv } from "./sdk-discovery.ts";
+
+/** How long to wait for the guest to report boot complete before calling it failed. */
+const DEFAULT_BOOT_DEADLINE_MS = 5 * 60_000;
+/** How often to ask. Cheap: a getStatus is sub-millisecond once the channel is up. */
+const BOOT_POLL_MS = 1_000;
+/** Emulator stderr/stdout kept for diagnostics. Bounded: a boot loop can log without end. */
+const LOG_RING_LINES = 200;
+
+export interface StartOptions {
+  avdName: string;
+  avdHome: string;
+  emulatorPath: string;
+  /** Extra flags the caller has already validated. Passed as argv, never through a shell. */
+  extraArgs?: string[];
+  bootDeadlineMs?: number;
+  /** Run without a visible window. `qt-hide-window` still creates one (and needs a display). */
+  windowMode?: "no-window" | "qt-hide-window" | "window";
+  gpuMode?: string;
+  /**
+   * Quick boot resumes the saved snapshot and saves one on exit; cold boot ignores any snapshot
+   * and boots the guest from scratch.
+   *
+   * Neither touches user data — that is what **wipe** is for, and conflating the two is how a
+   * "boot fresh" button ends up deleting somebody's app state. A cold boot is minutes; a quick
+   * boot is seconds, which is why it is the default.
+   */
+  bootMode?: "quick" | "cold";
+  /**
+   * How many emulators this host may run at once, starts still booting included. Counted here
+   * because only here is the count in the same synchronous step as the reservation below: a
+   * caller that counts, awaits, then starts lets two requests for two different AVDs both see
+   * the same free slot.
+   */
+  maxConcurrent?: number;
+}
+
+/** A start refused because the host is already at `maxConcurrent`. */
+export class EmulatorLimitError extends Error {
+  constructor(readonly busy: number, readonly limit: number) {
+    super(`already running or starting ${busy} emulator(s); the limit for this host is ${limit}`);
+  }
+}
+
+export interface StartedDevice {
+  avdName: string;
+  pid: number;
+  grpcPort: number;
+  adbSerial: string | null;
+  generation: number;
+}
+
+interface InFlight {
+  operation: Operation<StartedDevice>;
+  promise: Promise<StartedDevice>;
+}
+
+/** One entry per AVD name while a start is running — this *is* the mutex. */
+const starting = new Map<string, InFlight>();
+/** Bounded log of what each emulator printed, for the error surface. */
+const logs = new Map<string, string[]>();
+
+export function emulatorLog(avdName: string): string[] {
+  return logs.get(avdName) ?? [];
+}
+
+function appendLog(avdName: string, chunk: string): void {
+  const ring = logs.get(avdName) ?? [];
+  for (const line of chunk.split("\n")) {
+    if (!line.trim()) continue;
+    ring.push(line);
+    if (ring.length > LOG_RING_LINES) ring.shift();
+  }
+  logs.set(avdName, ring);
+}
+
+/** The env the *child* gets. Shared with the SDK tools, which need the same treatment. */
+const childEnv = avdHomeEnv;
+
+/** Exported for tests: the flag set is a decision, and `-grpc`'s absence is load-bearing. */
+export function buildArgs(opts: StartOptions): string[] {
+  const args = ["-avd", opts.avdName];
+  switch (opts.windowMode ?? "no-window") {
+    case "no-window": args.push("-no-window"); break;
+    case "qt-hide-window": args.push("-qt-hide-window"); break;
+    case "window": break;
+  }
+  args.push("-no-boot-anim");
+  // `-no-snapshot-load` only refuses to *resume* one; the guest's disk is untouched either way.
+  if ((opts.bootMode ?? "quick") === "cold") args.push("-no-snapshot-load");
+  if (opts.gpuMode) args.push("-gpu", opts.gpuMode);
+  // Deliberately absent: `-grpc <port>`. See the file header.
+  for (const extra of opts.extraArgs ?? []) args.push(extra);
+  return args;
+}
+
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+/** Poll discovery until this AVD advertises a gRPC endpoint, or the deadline passes. */
+async function waitForAdvertisement(avdName: string, deadline: number): Promise<RunningEmulator> {
+  while (Date.now() < deadline) {
+    const found = findRunningEmulatorByAvd(avdName);
+    if (found) return found;
+    await sleep(250);
+  }
+  throw new Error(`emulator for ${avdName} never advertised a gRPC endpoint`);
+}
+
+/** Poll the guest until it reports boot complete. */
+async function waitForBoot(
+  emulator: RunningEmulator,
+  deadline: number,
+  onProgress: (detail: string) => void,
+): Promise<void> {
+  const channel = connectToEmulator(emulator);
+  const startedAt = Date.now();
+  try {
+    while (Date.now() < deadline) {
+      try {
+        const status = await getEmulatorStatus(channel);
+        if (status.booted) return;
+        onProgress(`booting (${Math.round((Date.now() - startedAt) / 1000)}s)`);
+      } catch {
+        onProgress(`waiting for control channel (${Math.round((Date.now() - startedAt) / 1000)}s)`);
+      }
+      await sleep(BOOT_POLL_MS);
+    }
+    throw new Error("guest did not report boot complete before the deadline");
+  } finally {
+    channel.close();
+  }
+}
+
+/**
+ * Start an emulator, or return the start already running for this AVD.
+ *
+ * Returns immediately with an operation the caller polls; a cold boot is minutes and no HTTP
+ * request should be held that long.
+ */
+export function startEmulator(opts: StartOptions): Operation<StartedDevice> {
+  const inFlight = starting.get(opts.avdName);
+  if (inFlight) return inFlight.operation;   // idempotent: same operation, no second process
+
+  const already = findRunningEmulatorByAvd(opts.avdName);
+  if (already) {
+    const op = createOperation<StartedDevice>("android.start", "already running");
+    finishOperation(op.id, {
+      avdName: opts.avdName,
+      pid: already.pid,
+      grpcPort: already.grpcPort,
+      adbSerial: already.adbSerial,
+      generation: 0,
+    });
+    return op;
+  }
+
+  if (opts.maxConcurrent !== undefined) {
+    // A start in flight counts as much as a running emulator: it is minutes to boot, and until
+    // it advertises itself discovery cannot see it.
+    const busy = new Set([...findRunningEmulators().map((e) => e.avdName), ...starting.keys()]);
+    if (busy.size >= opts.maxConcurrent) throw new EmulatorLimitError(busy.size, opts.maxConcurrent);
+  }
+
+  const operation = createOperation<StartedDevice>("android.start", "spawning emulator");
+  const promise = run(opts, operation).finally(() => starting.delete(opts.avdName));
+  starting.set(opts.avdName, { operation, promise });
+  // The operation carries the outcome; an unobserved rejection here must not crash the server.
+  promise.catch(() => {});
+  return operation;
+}
+
+async function run(opts: StartOptions, operation: Operation<StartedDevice>): Promise<StartedDevice> {
+  const deadline = Date.now() + (opts.bootDeadlineMs ?? DEFAULT_BOOT_DEADLINE_MS);
+  updateOperation(operation.id, { state: "running", detail: "spawning emulator" });
+  logs.delete(opts.avdName);
+
+  if (!existsSync(opts.emulatorPath)) {
+    const message = `emulator binary not found at ${opts.emulatorPath}`;
+    failOperation(operation.id, message);
+    throw new Error(message);
+  }
+
+  // argv, never a shell string: an AVD name or SDK path with a space or a quote in it would
+  // otherwise be re-split by the shell.
+  const child = spawn(opts.emulatorPath, buildArgs(opts), {
+    env: childEnv(opts.avdHome),
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: false,
+  });
+
+  child.stdout?.on("data", (d: Buffer) => appendLog(opts.avdName, d.toString()));
+  child.stderr?.on("data", (d: Buffer) => appendLog(opts.avdName, d.toString()));
+
+  let spawnError: Error | null = null;
+  child.on("error", (e) => { spawnError = e; });
+
+  try {
+    updateOperation(operation.id, { detail: "waiting for the emulator to advertise itself" });
+    const emulator = await waitForAdvertisement(opts.avdName, deadline);
+
+    updateOperation(operation.id, { detail: "booting" });
+    await waitForBoot(emulator, deadline, (detail) => updateOperation(operation.id, { detail }));
+
+    const generation = claimOwnership(opts.avdName, emulator.pid);
+    const started: StartedDevice = {
+      avdName: opts.avdName,
+      pid: emulator.pid,
+      grpcPort: emulator.grpcPort,
+      adbSerial: emulator.adbSerial,
+      generation,
+    };
+    finishOperation(operation.id, started);
+    return started;
+  } catch (e) {
+    const tail = emulatorLog(opts.avdName).slice(-6).join("\n");
+    const base = spawnError ? `${(spawnError as Error).message}` : (e as Error).message;
+    const message = tail ? `${base}\n${tail}` : base;
+    failOperation(operation.id, message);
+    throw new Error(message);
+  }
+}
+
+export type StopOutcome = "stopped" | "not-running" | "not-owned";
+
+/**
+ * Stop an emulator PPM started.
+ *
+ * Graceful only: `setVmState SHUTDOWN` over gRPC, which measured at 1-3 seconds. Nothing here
+ * signals a pid, and certainly not by process *name* — on this very host `pgrep qemu-system`
+ * matches Docker Desktop.
+ */
+export async function stopEmulator(
+  avdName: string,
+  opts: { avdHome: string; requireOwnership?: boolean },
+): Promise<StopOutcome> {
+  const emulator = findRunningEmulatorByAvd(avdName);
+  if (!emulator) {
+    releaseOwnership(avdName);
+    return "not-running";
+  }
+  if (opts.requireOwnership !== false) {
+    const entry = listDevices(opts.avdHome).find((d) => d.name === avdName);
+    if (entry?.runtime && !entry.runtime.ownedByPpm) return "not-owned";
+  }
+
+  const channel = connectToEmulator(emulator);
+  try {
+    await requestShutdown(channel);
+  } finally {
+    channel.close();
+  }
+
+  // Wait for the process to actually go, so the caller can report truthfully.
+  const deadline = Date.now() + 30_000;
+  while (Date.now() < deadline) {
+    try { process.kill(emulator.pid, 0); } catch { break; }
+    await sleep(250);
+  }
+  releaseOwnership(avdName);
+  return "stopped";
+}
+
+/** Test seam. */
+export function _resetLauncher(): void {
+  starting.clear();
+  logs.clear();
+}

package/src/services/android/proto/emulator-controller-descriptor.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/gen-android-proto.ts — do not edit.
+//
+// Source:   emulator_controller.proto (Apache 2.0, The Android Open Source Project)
+// Taken from: $ANDROID_SDK_ROOT/emulator/lib/emulator_controller.proto
+// Emulator: 36.5.10.0 (build 15081367)
+// SHA-256:  e872af01d8ff0a46d2d19c644709e4d524be609e9cff69f75b06ab0bb67653dd
+//
+// Embedded rather than loaded from disk: a compiled binary cannot read the .proto file.
+export const EMULATOR_CONTROLLER_PROTO_SHA256 = "e872af01d8ff0a46d2d19c644709e4d524be609e9cff69f75b06ab0bb67653dd";
+export const emulatorControllerDescriptor = {"options":{"java_multiple_files":true,"java_package":"com.android.emulator.control","objc_class_prefix":"AEC"},"nested":{"android":{"nested":{"emulation":{"nested":{"control":{"nested":{"EmulatorController":{"methods":{"streamSensor":{"requestType":"SensorValue","responseType":"SensorValue","responseStream":true},"getSensor":{"requestType":"SensorValue","responseType":"SensorValue"},"setSensor":{"requestType":"SensorValue","responseType":"google.protobuf.Empty"},"setPhysicalModel":{"requestType":"PhysicalModelValue","responseType":"google.protobuf.Empty"},"getPhysicalModel":{"requestType":"PhysicalModelValue","responseType":"PhysicalModelValue"},"streamPhysicalModel":{"requestType":"PhysicalModelValue","responseType":"PhysicalModelValue","responseStream":true},"setClipboard":{"requestType":"ClipData","responseType":"google.protobuf.Empty"},"getClipboard":{"requestType":"google.protobuf.Empty","responseType":"ClipData"},"streamClipboard":{"requestType":"google.protobuf.Empty","responseType":"ClipData","responseStream":true},"setBattery":{"requestType":"BatteryState","responseType":"google.protobuf.Empty"},"getBattery":{"requestType":"google.protobuf.Empty","responseType":"BatteryState"},"setGps":{"requestType":"GpsState","responseType":"google.protobuf.Empty"},"getGps":{"requestType":"google.protobuf.Empty","responseType":"GpsState"},"sendFingerprint":{"requestType":"Fingerprint","responseType":"google.protobuf.Empty"},"sendKey":{"requestType":"KeyboardEvent","responseType":"google.protobuf.Empty"},"sendTouch":{"requestType":"TouchEvent","responseType":"google.protobuf.Empty"},"sendMouse":{"requestType":"MouseEvent","responseType":"google.protobuf.Empty"},"injectWheel":{"requestType":"WheelEvent","requestStream":true,"responseType":"google.protobuf.Empty"},"streamInputEvent":{"requestType":"InputEvent","requestStream":true,"responseType":"google.protobuf.Empty"},"sendPhone":{"requestType":"PhoneCall","responseType":"PhoneResponse"},"sendSms":{"requestType":"SmsMessage","responseType":"PhoneResponse"},"setPhoneNumber":{"requestType":"PhoneNumber","responseType":"PhoneResponse"},"getStatus":{"requestType":"google.protobuf.Empty","responseType":"EmulatorStatus"},"getScreenshot":{"requestType":"ImageFormat","responseType":"Image"},"streamScreenshot":{"requestType":"ImageFormat","responseType":"Image","responseStream":true},"streamAudio":{"requestType":"AudioFormat","responseType":"AudioPacket","responseStream":true},"injectAudio":{"requestType":"AudioPacket","requestStream":true,"responseType":"google.protobuf.Empty"},"getMicrophoneState":{"requestType":"google.protobuf.Empty","responseType":"MicrophoneState"},"setMicrophoneState":{"requestType":"MicrophoneState","responseType":"google.protobuf.Empty"},"getLogcat":{"requestType":"LogMessage","responseType":"LogMessage","options":{"deprecated":true},"parsedOptions":[{"deprecated":true}]},"streamLogcat":{"requestType":"LogMessage","responseType":"LogMessage","responseStream":true},"setVmState":{"requestType":"VmRunState","responseType":"google.protobuf.Empty"},"getVmState":{"requestType":"google.protobuf.Empty","responseType":"VmRunState"},"setDisplayConfigurations":{"requestType":"DisplayConfigurations","responseType":"DisplayConfigurations"},"getDisplayConfigurations":{"requestType":"google.protobuf.Empty","responseType":"DisplayConfigurations"},"streamNotification":{"requestType":"google.protobuf.Empty","responseType":"Notification","responseStream":true},"rotateVirtualSceneCamera":{"requestType":"RotationRadian","responseType":"google.protobuf.Empty"},"setVirtualSceneCameraVelocity":{"requestType":"Velocity","responseType":"google.protobuf.Empty"},"setPosture":{"requestType":"Posture","responseType":"google.protobuf.Empty"},"getBrightness":{"requestType":"BrightnessValue","responseType":"BrightnessValue"},"setBrightness":{"requestType":"BrightnessValue","responseType":"google.protobuf.Empty"},"getDisplayMode":{"requestType":"google.protobuf.Empty","responseType":"DisplayMode"},"setDisplayMode":{"requestType":"DisplayMode","responseType":"google.protobuf.Empty"},"setXrOptions":{"requestType":"XrOptions","responseType":"google.protobuf.Empty"},"getXrOptions":{"requestType":"google.protobuf.Empty","responseType":"XrOptions"}}},"VmRunState":{"fields":{"state":{"type":"RunState","id":1}},"nested":{"RunState":{"values":{"UNKNOWN":0,"RUNNING":1,"RESTORE_VM":2,"PAUSED":3,"SAVE_VM":4,"SHUTDOWN":5,"TERMINATE":7,"RESET":9,"INTERNAL_ERROR":10,"RESTART":11,"START":12,"STOP":13}}}},"ParameterValue":{"fields":{"data":{"rule":"repeated","type":"float","id":1,"options":{"packed":true}}}},"PhysicalModelValue":{"fields":{"target":{"type":"PhysicalType","id":1},"status":{"type":"State","id":2},"value":{"type":"ParameterValue","id":3}},"nested":{"State":{"values":{"OK":0,"NO_SERVICE":-3,"DISABLED":-2,"UNKNOWN":-1}},"PhysicalType":{"values":{"POSITION":0,"ROTATION":1,"MAGNETIC_FIELD":2,"TEMPERATURE":3,"PROXIMITY":4,"LIGHT":5,"PRESSURE":6,"HUMIDITY":7,"VELOCITY":8,"AMBIENT_MOTION":9,"HINGE_ANGLE0":10,"HINGE_ANGLE1":11,"HINGE_ANGLE2":12,"ROLLABLE0":13,"ROLLABLE1":14,"ROLLABLE2":15,"POSTURE":16,"HEART_RATE":17,"RGBC_LIGHT":18,"WRIST_TILT":19}}}},"SensorValue":{"fields":{"target":{"type":"SensorType","id":1},"status":{"type":"State","id":2},"value":{"type":"ParameterValue","id":3}},"nested":{"State":{"values":{"OK":0,"NO_SERVICE":-3,"DISABLED":-2,"UNKNOWN":-1}},"SensorType":{"values":{"ACCELERATION":0,"GYROSCOPE":1,"MAGNETIC_FIELD":2,"ORIENTATION":3,"TEMPERATURE":4,"PROXIMITY":5,"LIGHT":6,"PRESSURE":7,"HUMIDITY":8,"MAGNETIC_FIELD_UNCALIBRATED":9,"GYROSCOPE_UNCALIBRATED":10,"HEART_RATE":14,"RGBC_LIGHT":15,"ACCELERATION_UNCALIBRATED":17,"HEADING":18}}}},"BrightnessValue":{"fields":{"target":{"type":"LightType","id":1},"value":{"type":"uint32","id":2}},"nested":{"LightType":{"values":{"LCD":0,"KEYBOARD":1,"BUTTON":2}}}},"DisplayModeValue":{"values":{"PHONE":0,"FOLDABLE":1,"TABLET":2,"DESKTOP":3}},"DisplayMode":{"fields":{"value":{"type":"DisplayModeValue","id":1}}},"XrOptions":{"fields":{"environment":{"type":"Environment","id":1},"passthroughCoefficient":{"type":"float","id":2}},"nested":{"Environment":{"values":{"LIVING_ROOM_DAY":0,"LIVING_ROOM_NIGHT":1}}}},"LogMessage":{"fields":{"contents":{"type":"string","id":1},"start":{"type":"int64","id":2,"options":{"deprecated":true}},"next":{"type":"int64","id":3,"options":{"deprecated":true}},"sort":{"type":"LogType","id":4},"entries":{"rule":"repeated","type":"LogcatEntry","id":5}},"nested":{"LogType":{"values":{"Text":0,"Parsed":1}}}},"LogcatEntry":{"fields":{"timestamp":{"type":"uint64","id":1},"pid":{"type":"uint32","id":2},"tid":{"type":"uint32","id":3},"level":{"type":"LogLevel","id":4},"tag":{"type":"string","id":5},"msg":{"type":"string","id":6}},"nested":{"LogLevel":{"values":{"UNKNOWN":0,"DEFAULT":1,"VERBOSE":2,"DEBUG":3,"INFO":4,"WARN":5,"ERR":6,"FATAL":7,"SILENT":8}}}},"VmConfiguration":{"fields":{"hypervisorType":{"type":"VmHypervisorType","id":1},"numberOfCpuCores":{"type":"int32","id":2},"ramSizeBytes":{"type":"int64","id":3}},"nested":{"VmHypervisorType":{"valuesOptions":{"HAXM":{"deprecated":true}},"values":{"UNKNOWN":0,"NONE":1,"KVM":2,"HAXM":3,"HVF":4,"WHPX":5,"AEHD":6}}}},"ClipData":{"fields":{"text":{"type":"string","id":1}}},"Touch":{"fields":{"x":{"type":"int32","id":1},"y":{"type":"int32","id":2},"identifier":{"type":"int32","id":3},"pressure":{"type":"int32","id":4},"touchMajor":{"type":"int32","id":5},"touchMinor":{"type":"int32","id":6},"expiration":{"type":"EventExpiration","id":7},"orientation":{"type":"int32","id":8}},"nested":{"EventExpiration":{"values":{"EVENT_EXPIRATION_UNSPECIFIED":0,"NEVER_EXPIRE":1}}}},"Pen":{"fields":{"location":{"type":"Touch","id":1},"buttonPressed":{"type":"bool","id":2},"rubberPointer":{"type":"bool","id":3}}},"TouchEvent":{"fields":{"touches":{"rule":"repeated","type":"Touch","id":1},"display":{"type":"int32","id":2}}},"TouchpadEvent":{"fields":{"touches":{"rule":"repeated","type":"Touch","id":1},"touchpad":{"type":"int32","id":2}}},"PenEvent":{"fields":{"events":{"rule":"repeated","type":"Pen","id":1},"display":{"type":"int32","id":2}}},"MouseEvent":{"fields":{"x":{"type":"int32","id":1},"y":{"type":"int32","id":2},"buttons":{"type":"int32","id":3},"display":{"type":"int32","id":4}}},"WheelEvent":{"fields":{"dx":{"type":"int32","id":1},"dy":{"type":"int32","id":2},"display":{"type":"int32","id":3}}},"KeyboardEvent":{"fields":{"codeType":{"type":"KeyCodeType","id":1},"eventType":{"type":"KeyEventType","id":2},"keyCode":{"type":"int32","id":3},"key":{"type":"string","id":4},"text":{"type":"string","id":5}},"nested":{"KeyCodeType":{"values":{"Usb":0,"Evdev":1,"XKB":2,"Win":3,"Mac":4}},"KeyEventType":{"values":{"keydown":0,"keyup":1,"keypress":2}}}},"XrCommand":{"fields":{"action":{"type":"Action","id":1}},"nested":{"Action":{"values":{"RECENTER":0}}}},"InputEvent":{"oneofs":{"type":{"oneof":["keyEvent","touchEvent","mouseEvent","androidEvent","penEvent","wheelEvent","xrHandEvent","xrEyeEvent","xrCommand","xrHeadRotationEvent","xrHeadMovementEvent","xrHeadAngularVelocityEvent","xrHeadVelocityEvent","touchpadEvent"]}},"fields":{"keyEvent":{"type":"KeyboardEvent","id":1},"touchEvent":{"type":"TouchEvent","id":2},"mouseEvent":{"type":"MouseEvent","id":3},"androidEvent":{"type":"AndroidEvent","id":4},"penEvent":{"type":"PenEvent","id":5},"wheelEvent":{"type":"WheelEvent","id":6},"xrHandEvent":{"type":"MouseEvent","id":7},"xrEyeEvent":{"type":"MouseEvent","id":8},"xrCommand":{"type":"XrCommand","id":9},"xrHeadRotationEvent":{"type":"RotationRadian","id":10},"xrHeadMovementEvent":{"type":"Translation","id":11},"xrHeadAngularVelocityEvent":{"type":"AngularVelocity","id":12},"xrHeadVelocityEvent":{"type":"Velocity","id":13},"touchpadEvent":{"type":"TouchpadEvent","id":14}}},"AndroidEvent":{"fields":{"type":{"type":"int32","id":1},"code":{"type":"int32","id":2},"value":{"type":"int32","id":3},"display":{"type":"int32","id":4}}},"Fingerprint":{"fields":{"isTouching":{"type":"bool","id":1},"touchId":{"type":"int32","id":2}}},"GpsState":{"fields":{"passiveUpdate":{"type":"bool","id":1},"latitude":{"type":"double","id":2},"longitude":{"type":"double","id":3},"speed":{"type":"double","id":4},"bearing":{"type":"double","id":5},"altitude":{"type":"double","id":6},"satellites":{"type":"int32","id":7}}},"BatteryState":{"fields":{"hasBattery":{"type":"bool","id":1},"isPresent":{"type":"bool","id":2},"charger":{"type":"BatteryCharger","id":3},"chargeLevel":{"type":"int32","id":4},"health":{"type":"BatteryHealth","id":5},"status":{"type":"BatteryStatus","id":6}},"nested":{"BatteryStatus":{"values":{"UNKNOWN":0,"CHARGING":1,"DISCHARGING":2,"NOT_CHARGING":3,"FULL":4}},"BatteryCharger":{"values":{"NONE":0,"AC":1,"USB":2,"WIRELESS":3}},"BatteryHealth":{"values":{"GOOD":0,"FAILED":1,"DEAD":2,"OVERVOLTAGE":3,"OVERHEATED":4}}}},"ImageTransport":{"fields":{"channel":{"type":"TransportChannel","id":1},"handle":{"type":"string","id":2}},"nested":{"TransportChannel":{"values":{"TRANSPORT_CHANNEL_UNSPECIFIED":0,"MMAP":1}}}},"FoldedDisplay":{"fields":{"width":{"type":"uint32","id":1},"height":{"type":"uint32","id":2},"xOffset":{"type":"uint32","id":3},"yOffset":{"type":"uint32","id":4}}},"ImageFormat":{"fields":{"format":{"type":"ImgFormat","id":1},"rotation":{"type":"Rotation","id":2},"width":{"type":"uint32","id":3},"height":{"type":"uint32","id":4},"display":{"type":"uint32","id":5},"transport":{"type":"ImageTransport","id":6},"foldedDisplay":{"type":"FoldedDisplay","id":7},"displayMode":{"type":"DisplayModeValue","id":8}},"nested":{"ImgFormat":{"values":{"PNG":0,"RGBA8888":1,"RGB888":2}}}},"Image":{"fields":{"format":{"type":"ImageFormat","id":1},"width":{"type":"uint32","id":2,"options":{"deprecated":true}},"height":{"type":"uint32","id":3,"options":{"deprecated":true}},"image":{"type":"bytes","id":4},"seq":{"type":"uint32","id":5},"timestampUs":{"type":"uint64","id":6}}},"Rotation":{"fields":{"rotation":{"type":"SkinRotation","id":1},"xAxis":{"type":"double","id":2},"yAxis":{"type":"double","id":3},"zAxis":{"type":"double","id":4}},"nested":{"SkinRotation":{"values":{"PORTRAIT":0,"LANDSCAPE":1,"REVERSE_PORTRAIT":2,"REVERSE_LANDSCAPE":3}}}},"PhoneCall":{"fields":{"operation":{"type":"Operation","id":1},"number":{"type":"string","id":2}},"nested":{"Operation":{"values":{"InitCall":0,"AcceptCall":1,"RejectCallExplicit":2,"RejectCallBusy":3,"DisconnectCall":4,"PlaceCallOnHold":5,"TakeCallOffHold":6}}}},"PhoneResponse":{"fields":{"response":{"type":"Response","id":1}},"nested":{"Response":{"values":{"OK":0,"BadOperation":1,"BadNumber":2,"InvalidAction":3,"ActionFailed":4,"RadioOff":5}}}},"Entry":{"fields":{"key":{"type":"string","id":1},"value":{"type":"string","id":2}}},"EntryList":{"fields":{"entry":{"rule":"repeated","type":"Entry","id":1}}},"EmulatorStatus":{"fields":{"version":{"type":"string","id":1},"uptime":{"type":"uint64","id":2},"booted":{"type":"bool","id":3},"vmConfig":{"type":"VmConfiguration","id":4},"hardwareConfig":{"type":"EntryList","id":5},"heartbeat":{"type":"uint64","id":6},"guestConfig":{"keyType":"string","type":"string","id":7}}},"AudioFormat":{"fields":{"samplingRate":{"type":"uint64","id":1},"channels":{"type":"Channels","id":2},"format":{"type":"SampleFormat","id":3},"mode":{"type":"DeliveryMode","id":4}},"nested":{"SampleFormat":{"values":{"AUD_FMT_U8":0,"AUD_FMT_S16":1}},"Channels":{"values":{"Mono":0,"Stereo":1}},"DeliveryMode":{"values":{"MODE_UNSPECIFIED":0,"MODE_REAL_TIME":1}}}},"AudioPacket":{"fields":{"format":{"type":"AudioFormat","id":1},"timestamp":{"type":"uint64","id":2},"audio":{"type":"bytes","id":3}}},"MicrophoneState":{"fields":{"realAudioEnabled":{"type":"bool","id":1}}},"SmsMessage":{"fields":{"srcAddress":{"type":"string","id":1},"text":{"type":"string","id":2}}},"DisplayConfiguration":{"fields":{"width":{"type":"uint32","id":1},"height":{"type":"uint32","id":2},"dpi":{"type":"uint32","id":3},"flags":{"type":"uint32","id":4},"display":{"type":"uint32","id":5}},"nested":{"DisplayFlags":{"values":{"DISPLAYFLAGS_UNSPECIFIED":0,"VIRTUAL_DISPLAY_FLAG_PUBLIC":1,"VIRTUAL_DISPLAY_FLAG_PRESENTATION":2,"VIRTUAL_DISPLAY_FLAG_SECURE":4,"VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY":8,"VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR":16}}}},"DisplayConfigurations":{"fields":{"displays":{"rule":"repeated","type":"DisplayConfiguration","id":1},"userConfigurable":{"type":"uint32","id":2},"maxDisplays":{"type":"uint32","id":3}}},"Notification":{"oneofs":{"type":{"oneof":["cameraNotification","displayConfigurationsChangedNotification","posture","booted","brightness","textViewFocus","xrOptions","microphoneState"]}},"fields":{"cameraNotification":{"type":"CameraNotification","id":2},"displayConfigurationsChangedNotification":{"type":"DisplayConfigurationsChangedNotification","id":3},"posture":{"type":"Posture","id":4},"booted":{"type":"BootCompletedNotification","id":5},"brightness":{"type":"BrightnessValue","id":6},"textViewFocus":{"type":"TextViewFocus","id":7},"xrOptions":{"type":"XrOptions","id":8},"microphoneState":{"type":"MicrophoneState","id":9}}},"BootCompletedNotification":{"fields":{"time":{"type":"int32","id":1}}},"CameraNotification":{"fields":{"active":{"type":"bool","id":1},"display":{"type":"int32","id":2}}},"TextViewFocus":{"fields":{"textViewHasFocus":{"type":"bool","id":1},"display":{"type":"int32","id":2}}},"DisplayConfigurationsChangedNotification":{"fields":{"displayConfigurations":{"type":"DisplayConfigurations","id":1}}},"RotationRadian":{"fields":{"x":{"type":"float","id":1},"y":{"type":"float","id":2},"z":{"type":"float","id":3}}},"Translation":{"fields":{"deltaX":{"type":"float","id":1},"deltaY":{"type":"float","id":2},"deltaZ":{"type":"float","id":3}}},"AngularVelocity":{"fields":{"omegaX":{"type":"float","id":1},"omegaY":{"type":"float","id":2},"omegaZ":{"type":"float","id":3}}},"Velocity":{"fields":{"x":{"type":"float","id":1},"y":{"type":"float","id":2},"z":{"type":"float","id":3}}},"Posture":{"fields":{"value":{"type":"PostureValue","id":3}},"nested":{"PostureValue":{"values":{"POSTURE_UNKNOWN":0,"POSTURE_CLOSED":1,"POSTURE_HALF_OPENED":2,"POSTURE_OPENED":3,"POSTURE_FLIPPED":4,"POSTURE_TENT":5,"POSTURE_MAX":6}}}},"PhoneNumber":{"fields":{"number":{"type":"string","id":1}}}}}}}}},"google":{"nested":{"protobuf":{"nested":{"Empty":{"fields":{}}}}}}}} as const;