@gravitylabsllc/porthole 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,123 @@
+# @gravitylabsllc/porthole
+
+The workstation half of [Porthole](https://porthole.gravitylabs.live): an MCP server
+and a live timeline for a running Android app.
+
+Porthole is a debug-only agent that lives inside your app and answers questions about
+it while it runs — what recomposed and why, which frames were dropped and where the
+time went, what is holding the main thread, what is in flight, what your state
+actually contains right now. This package is what connects to it: a browser timeline
+for a person watching their own app, and an MCP server for a coding assistant that
+can read the answers and go change the code that caused them.
+
+The agent itself is an Android library. It is not in this package, and nothing here
+returns data until it is running: add the Gradle plugin `live.gravitylabs.porthole`
+to your app module, install a debug build, and then come back here. Setup is in the
+[repository README](https://github.com/gravityrepos/porthole#setup).
+
+## The timeline
+
+```bash
+npx @gravitylabsllc/porthole ui
+```
+
+That forwards the device port with `adb`, serves the timeline, opens your browser and
+keeps running until you stop it. It needs Node 18 or newer and `adb` — from
+`ANDROID_HOME`, a `local.properties` above the working directory, or your PATH.
+
+## The MCP server
+
+`./gradlew portholeMcpConfig` writes this entry for you, merging rather than
+overwriting. To paste it into `.mcp.json` yourself:
+
+```json
+{
+  "mcpServers": {
+    "porthole": {
+      "command": "npx",
+      "args": ["-y", "@gravitylabsllc/porthole"],
+      "env": { "PORTHOLE_PORT": "8677" }
+    }
+  }
+}
+```
+
+The tools it registers:
+
+| tool | answers |
+| --- | --- |
+| `findings` | start here: what is wrong right now, ranked, each with the tool that shows its evidence |
+| `recompositions` | which composables recomposed, how often, and which state keys were written just before |
+| `semantics_tree` | the semantics tree with an id that stays stable across captures |
+| `nav_state` | back stack, arguments on each entry, and the deep link that got you here |
+| `state` | current values of your ViewModel state, named automatically |
+| `inflight` | open HTTP calls with the phase each is stuck in, running queries, WorkManager jobs |
+| `frames` | dropped frames, and which phase of the frame ate the time |
+| `blocking` | what held the main thread, with the stack it was stuck in |
+| `logs` | the app's own logcat output, stack traces intact, without touching adb |
+| `timeline` | the raw event stream, for ordering things relative to each other |
+| `what_was_happening` | the narrative for one instant: screen, in-flight work, main thread, state just written |
+| `system_context` | thermal state, CPU governor, busiest processes, memory pressure |
+| `capture_system_trace` | records a Perfetto trace, annotated with the app's own spans |
+| `ask_system_trace` | puts a fixed set of questions to a captured trace, to rule causes in or out |
+| `open_timeline` | opens the live timeline in the browser |
+| `porthole_status` | whether any of the above can currently reach the device |
+
+## The two binaries
+
+`porthole` is the CLI, for a person:
+
+```
+porthole ui                                       open the live timeline
+porthole capture --scenario <name> -- <command>   record a run to a trace
+porthole report <trace.json>                      what the run is worth looking at
+porthole compare <base> <trace>                   regressions against a baseline
+porthole mcp                                      the MCP server (stdio)
+```
+
+`porthole-mcp` is that last line as its own entry point, for MCP clients that want a
+bare command rather than a subcommand. The two are the same server.
+
+A bad `--port`/`--ui-port` value or an unrecognized option exits `2` rather than
+starting something that listens on the wrong thing and says nothing. Quoted
+from the built CLI itself:
+
+```
+$ porthole ui --port abc
+--port "abc" is not a number
+
+$ porthole ui --port 99999
+--port 99999 is out of range (must be 1024-65535)
+
+$ porthole ui --port 4.5
+--port 4.5 must be a whole number
+
+$ porthole ui --port
+--port needs a port number
+
+$ porthole ui --bogus-flag
+unknown option: --bogus-flag
+<usage follows>
+```
+
+## Environment
+
+| variable | default | what it sets |
+| --- | --- | --- |
+| `PORTHOLE_HOST` | `127.0.0.1` | host the forwarded device socket is reachable on |
+| `PORTHOLE_PORT` | `8677` | device port the porthole listens on |
+| `PORTHOLE_UI_PORT` | `8678` | port the timeline is served on |
+| `PORTHOLE_TRACE_PROCESSOR` | none | path to Perfetto's `trace_processor`, for system traces |
+| `PORTHOLE_TRACE_TIMEOUT_MS` | `60000` | how long `ask_system_trace` waits on `trace_processor` per question before giving up |
+
+The MCP server and the timeline are independent. Run either, or both at once — they
+each open their own connection to the device.
+
+## More
+
+- [porthole.gravitylabs.live](https://porthole.gravitylabs.live) — what it is, with pictures
+- [github.com/gravityrepos/porthole](https://github.com/gravityrepos/porthole) — the full documentation: setup, what the numbers mean, what gets captured and what does not, security
+
+## License
+
+Apache License 2.0. Copyright 2026 Gravity Labs.

package/dist/adb.js

@@ -1,19 +1,293 @@
 // Copyright 2026 Gravity Labs
 // SPDX-License-Identifier: Apache-2.0
-import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, readFileSync, statSync } from "node:fs";
 import path from "node:path";
-/** adb, in the order a developer would look for it. Mirrors the Gradle plugin. */
-export function findAdb() {
-    const binary = process.platform === "win32" ? "adb.exe" : "adb";
+/**
+ * How far up from the working directory to look for local.properties.
+ *
+ * The working directory is usually the build root, but an agent or a shell is
+ * just as often sitting in a module inside it. Five levels covers that without
+ * letting a build that has no local.properties at all walk to the top of the
+ * disk looking for one.
+ */
+const LOCAL_PROPERTIES_LEVELS = 5;
+/**
+ * A .properties file, read the way java.util.Properties reads it.
+ *
+ * local.properties is written by Android Studio, and on Windows what it writes
+ * is `sdk.dir=C\:\\Users\\james\\AppData\\Local\\Android\\Sdk`. Splitting on
+ * the first `=` and keeping the rest verbatim yields a path with an escaped
+ * colon and doubled separators that no filesystem call will accept, so the
+ * escapes have to come off. The rules honoured here are Java's, because Java's
+ * are what wrote the file and what the Gradle plugin reads it back with: `#`
+ * and `!` comment out a whole line and nothing else — a `#` partway through a
+ * value belongs to the value — `=`, `:` or whitespace ends the key, and a line
+ * ending in an odd number of backslashes continues onto the next.
+ */
+export function parseProperties(text) {
+    const properties = new Map();
+    const lines = text.split(/\r\n|\n|\r/);
+    for (let i = 0; i < lines.length; i++) {
+        let line = lines[i].replace(/^[ \t\f]+/, "");
+        if (line === "" || line.startsWith("#") || line.startsWith("!"))
+            continue;
+        while (trailingBackslashes(line) % 2 === 1 && i + 1 < lines.length) {
+            line = line.slice(0, -1) + lines[++i].replace(/^[ \t\f]+/, "");
+        }
+        // The key runs to the first separator that is not itself escaped.
+        let end = 0;
+        while (end < line.length) {
+            const character = line[end];
+            if (character === "\\") {
+                end += 2;
+                continue;
+            }
+            if ("=: \t\f".includes(character))
+                break;
+            end++;
+        }
+        let value = line.slice(end).replace(/^[ \t\f]*/, "");
+        if (value.startsWith("=") || value.startsWith(":")) {
+            value = value.slice(1).replace(/^[ \t\f]*/, "");
+        }
+        properties.set(unescape(line.slice(0, end)), unescape(value));
+    }
+    return properties;
+}
+function trailingBackslashes(line) {
+    let count = 0;
+    while (count < line.length && line[line.length - 1 - count] === "\\")
+        count++;
+    return count;
+}
+function unescape(raw) {
+    let out = "";
+    for (let i = 0; i < raw.length; i++) {
+        if (raw[i] !== "\\") {
+            out += raw[i];
+            continue;
+        }
+        const escaped = raw[++i];
+        if (escaped === undefined)
+            break;
+        if (escaped === "u" && /^[0-9a-fA-F]{4}$/.test(raw.slice(i + 1, i + 5))) {
+            out += String.fromCharCode(parseInt(raw.slice(i + 1, i + 5), 16));
+            i += 4;
+            continue;
+        }
+        // Java drops the backslash before anything it does not recognise, which is
+        // what turns `C\:\\Users` back into `C:\Users`.
+        out += { t: "\t", n: "\n", r: "\r", f: "\f" }[escaped] ?? escaped;
+    }
+    return out;
+}
+/**
+ * Where PORTHOLE_PROJECT_ROOT and PORTHOLE_SDK_DIR come from: `.mcp.json`,
+ * generated at Gradle configure time by `PortholeMcpConfigTask`. That task
+ * knows both values with certainty — the Gradle root project directory, and
+ * `sdk.dir`/`ANDROID_HOME` resolved the same way `PortholePlugin` resolves
+ * them for `adb` itself — because it is the build, not a process launched by
+ * whatever an MCP client decided to use as `cwd`.
+ */
+const PORTHOLE_PROJECT_ROOT = "PORTHOLE_PROJECT_ROOT";
+const PORTHOLE_SDK_DIR = "PORTHOLE_SDK_DIR";
+/**
+ * The project root anything here should treat as "the build", in order:
+ * `PORTHOLE_PROJECT_ROOT` if the generated config set it, otherwise
+ * `process.cwd()` on the stated assumption GRA-87 already made and this
+ * ticket exists to stop relying on — that an MCP client launches its stdio
+ * server from the workspace root. When a generated `.mcp.json` is what
+ * started this process, that assumption is no longer needed at all.
+ */
+export function resolveProjectRoot() {
+    const declared = process.env[PORTHOLE_PROJECT_ROOT];
+    if (declared && declared.trim()) {
+        return { directory: declared.trim(), source: "PORTHOLE_PROJECT_ROOT" };
+    }
+    return { directory: process.cwd(), source: "cwd" };
+}
+/**
+ * True for a Windows drive-relative path — a letter, a colon, and then
+ * anything other than a separator (`C:foo`, or bare `C:`): "foo, relative to
+ * whatever the current directory on drive C happens to be", a real Windows
+ * path concept distinct from both absolute and an ordinary relative path.
+ * This is the TypeScript analogue of `isWindowsDriveRelative` in
+ * PortholeTasks.kt (GRA-150), kept for the same reason: `path.join(directory,
+ * "C:foo")` does not anchor it under `directory` — Node happily concatenates
+ * the strings into `<directory>\C:foo`, a colon spliced into the middle of a
+ * path segment that Windows refuses to open. There is no reliable way to ask
+ * Node, any more than the JVM, what "the current directory on drive C" is for
+ * a directory other than this process's own, so — matching the Kotlin
+ * resolver's choice — this shape is deliberately left to resolve however
+ * `path.resolve` on its own (no `directory` argument) already resolves it,
+ * rather than inventing an anchor. Gated on `win32`: everywhere else a colon
+ * is an ordinary filename character, and `C:foo` there is exactly as
+ * relative as it looks.
+ */
+function isWindowsDriveRelative(value) {
+    return process.platform === "win32" && /^[A-Za-z]:($|[^\\/])/.test(value);
+}
+/**
+ * True for a path `java.io.File#isAbsolute()` — and so PortholeTasks.kt's
+ * `resolveSdkDir` — would call absolute. On Windows this deliberately
+ * disagrees with Node's own `path.isAbsolute`: a bare POSIX-style leading
+ * slash (`/opt/sdk`) is absolute to Node there (it roots the path at
+ * whatever the current drive is) but not to Java, which requires a drive
+ * letter or a UNC prefix. GRA-150's QA moved the Kotlin resolver to route
+ * that shape through the project-root join instead of the current-drive
+ * root; using Node's native check here would silently put TypeScript back on
+ * the old, rejected answer for this one shape. See PortholeTasks.kt's
+ * `resolveSdkDir` doc comment for the full story. Off Windows, Java's rule
+ * and Node's agree (both are simply "starts with /"), so this just defers to
+ * `path.isAbsolute`.
+ */
+function isJavaStyleAbsolute(value) {
+    if (process.platform !== "win32")
+        return path.isAbsolute(value);
+    return /^[A-Za-z]:[\\/]/.test(value) || /^[\\/]{2}/.test(value);
+}
+/**
+ * Anchors a `sdk.dir` value read out of local.properties against `directory`
+ * — [sdkDirFromLocalProperties]'s current directory in its walk, i.e. the
+ * directory the file was actually found in. This is deliberately NOT
+ * `resolveProjectRoot().directory`: the two differ whenever the walk climbs
+ * past the project root to find the file, and a relative path written inside
+ * that file means "relative to where the file lives", not "relative to
+ * wherever PORTHOLE_PROJECT_ROOT happens to point". This mirrors
+ * PortholeTasks.kt's `resolveSdkDir`, which anchors on `projectRoot` — its
+ * exact analogue, for the exact same reason (GRA-160 AC1).
+ *
+ * `path.join`, not `path.resolve`, does the anchoring for the ordinary case:
+ * `path.resolve` special-cases any argument it considers absolute — which,
+ * on Windows, includes the POSIX-style shape `isJavaStyleAbsolute`
+ * deliberately excludes — by discarding every argument before it and rooting
+ * at the current drive instead. That is exactly the answer this function
+ * exists to avoid. `path.join` treats every argument as a plain segment
+ * regardless of what it looks like, so it always anchors under `directory`;
+ * the outer `path.resolve` then only normalizes the result (drops a trailing
+ * separator, collapses a redundant `.`/`..`), which is also where the
+ * "GRA-160 AC4" trim below actually pays for itself — an unstripped
+ * whitespace character survives straight into this join as part of the path
+ * segment, and lands on a directory that does not exist.
+ */
+function resolveRelativeSdkDir(value, directory) {
+    if (isWindowsDriveRelative(value))
+        return path.resolve(value);
+    if (isJavaStyleAbsolute(value))
+        return path.resolve(value);
+    return path.resolve(path.join(directory, value));
+}
+/** `sdk.dir` from the nearest local.properties at or above `from`. */
+function sdkDirFromLocalProperties(from) {
+    let directory = path.resolve(from);
+    for (let level = 0; level <= LOCAL_PROPERTIES_LEVELS; level++) {
+        const file = path.join(directory, "local.properties");
+        try {
+            if (existsSync(file)) {
+                // A local.properties with no sdk.dir in it is not an answer, so the
+                // walk continues past it rather than stopping at the first file found.
+                const value = parseProperties(readFileSync(file, "utf8")).get("sdk.dir");
+                // GRA-160 AC4: value.trim() here is the only thing standing between
+                // a value parseProperties handed back un-trimmed and a filesystem
+                // check on a directory that does not exist. Plain ASCII whitespace
+                // around the value mostly never reaches this line at all —
+                // parseProperties' own `[ \t\f]` stripping already ate the leading
+                // run, and a value with nothing but trailing ASCII space is realistic
+                // (a hand-edited file, or a stray editor auto-format) but easy to
+                // write a fixture for and forget. A non-breaking space (U+00A0) is
+                // the sharper case: `[ \t\f]` does not include it, so it survives
+                // parseProperties untouched either way, and only JS's own
+                // Unicode-aware `trim()` — not a regex character class copied from
+                // Java's — removes it here. adb.test.ts covers both.
+                if (value && value.trim())
+                    return resolveRelativeSdkDir(value.trim(), directory);
+            }
+        }
+        catch {
+            // Unreadable is the same as absent: the environment is next, and a
+            // permissions problem on someone's parent directory is not adb's fault.
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            break; // The root of the filesystem is its own parent.
+        directory = parent;
+    }
+    return null;
+}
+function isDirectory(candidate) {
+    try {
+        return statSync(candidate).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The Android SDK, in the order a developer would look for it — and, ahead
+ * of all of them, the order this ticket adds: an explicit `PORTHOLE_SDK_DIR`
+ * from a generated `.mcp.json` wins outright and short-circuits before any
+ * filesystem access, deliberately. GRA-87's walk up from the project root for
+ * local.properties, and the ANDROID_HOME/ANDROID_SDK_ROOT fallback after it,
+ * both stay exactly as they were for a server that was not started from a
+ * generated config — see [sdkDirFromLocalProperties] and its tests.
+ *
+ * The walk-and-environment order below is deliberately the Gradle plugin's —
+ * `sdkDirectory` in PortholePlugin.kt — and the two agreeing is the whole
+ * point of it. sdk.dir is what Android Studio writes into local.properties,
+ * and on a stock install it is the only one of these that is set: neither
+ * environment variable exists, and platform-tools is not on PATH, least of
+ * all on Windows. Reading only the environment is why `system_context` used
+ * to tell the user to go fix something that `./gradlew portholeConnect`, on
+ * the same machine and the same SDK, had no trouble with.
+ *
+ * Once local.properties names a directory, that is the answer even if adb
+ * turns out not to be beneath it. The plugin stops there too, and one tool
+ * quietly falling through to a different SDK than the other is the exact
+ * split personality this replaced.
+ */
+export function resolveSdkDir() {
+    const declared = process.env[PORTHOLE_SDK_DIR];
+    if (declared && declared.trim()) {
+        return { directory: declared.trim(), source: "PORTHOLE_SDK_DIR" };
+    }
+    const fromProperties = sdkDirFromLocalProperties(resolveProjectRoot().directory);
+    if (fromProperties)
+        return { directory: fromProperties, source: "local.properties" };
     for (const variable of ["ANDROID_HOME", "ANDROID_SDK_ROOT"]) {
         const root = process.env[variable];
-        if (!root)
-            continue;
-        const candidate = path.join(root, "platform-tools", binary);
-        if (existsSync(candidate))
-            return candidate;
+        if (root && isDirectory(root))
+            return { directory: root, source: variable };
     }
+    return { directory: null, source: "PATH" };
+}
+/**
+ * adb, from the SDK if one can be found, and otherwise left to the PATH.
+ *
+ * GRA-160 AC3: falling through to a bare binary name is the right answer
+ * only when nothing named an SDK at all (`directory` is null, `source` is
+ * "PATH") — that is an honest "I don't know", and PATH is the reasonable
+ * last resort, unremarked. When `directory` IS known — Android Studio wrote
+ * it, or this ticket's fix just anchored a relative one against the right
+ * place — but platform-tools is not actually there, falling through to PATH
+ * the same silent way is a different thing: it runs *some* adb, possibly a
+ * different SDK's, without a word to whoever asked. The wave-4 integration
+ * QA measured exactly this. This writes that specific case to stderr rather
+ * than swallowing it — stdout is the MCP transport's JSON-RPC channel, so
+ * stderr is the only channel available here that cannot corrupt it. Fully
+ * surfacing it through `porthole_status`'s payload would need a change in
+ * index.ts, which this ticket's Owns excludes; see the ticket report.
+ */
+export function findAdb() {
+    const binary = process.platform === "win32" ? "adb.exe" : "adb";
+    const { directory } = resolveSdkDir();
+    if (!directory)
+        return binary;
+    const candidate = path.join(directory, "platform-tools", binary);
+    if (existsSync(candidate))
+        return candidate;
+    process.stderr.write(`[porthole] sdk.dir resolved to ${directory}, but ` +
+        `${path.join("platform-tools", binary)} was not found there; falling back to ${binary} on PATH.\n`);
     return binary;
 }
 export function runAdb(args, serial) {
@@ -38,21 +312,122 @@ export function runAdb(args, serial) {
     return { ok: true, output };
 }
 /**
- * Stop the app and start it again.
+ * How long `runAdbAsync` waits before presuming an adb child is wedged.
  *
- * Driven from this side rather than from inside the app: a process cannot
- * reliably restart itself, and asking it to try is how you end up with a
- * half-dead process that no longer answers the socket.
+ * 150s, not `capture_system_trace`'s own 120s maximum: a caller recording a
+ * near-maximum-length trace overrides this per-call to `seconds * 1000` plus
+ * a startup buffer (see `index.ts`), so this default only ever governs the
+ * short calls — the pull and the on-device cleanup — where anything near a
+ * minute already means adb itself, not the recording, is stuck.
  */
-export function restartApp(packageName, serial) {
-    const stopped = runAdb(["shell", "am", "force-stop", packageName], serial);
-    if (!stopped.ok)
-        return stopped;
-    const started = runAdb(["shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1"], serial);
+const DEFAULT_ADB_TIMEOUT_MS = Number(process.env.PORTHOLE_ADB_TIMEOUT_MS) || 150_000;
+/** "One per few seconds", per the ticket: not so chatty it drowns stderr, not so sparse a caller watching the log wonders if the server is still alive. */
+const DEFAULT_ADB_TICK_MS = 5_000;
+/** Writes one line to stderr — never stdout, which on this server is the MCP transport's own JSON-RPC channel. */
+function defaultAdbProgress(elapsedMs, args) {
+    process.stderr.write(`[porthole] adb ${args[0] ?? ""} still running after ${Math.round(elapsedMs / 1000)}s...\n`);
+}
+/**
+ * `runAdb`'s async twin: `spawn`, awaited, standing in for `spawnSync`.
+ *
+ * `capture_system_trace`'s three adb calls — the recording, the pull, and
+ * the on-device cleanup — used to run through `runAdb` above, which blocks
+ * Node's single thread for as long as the child takes. At the tool's own
+ * 120s maximum that froze the whole MCP server for over two minutes: nothing
+ * read the device socket, nothing answered another tool call, and the
+ * timeline WebSocket went silent. This is the way back, and it is
+ * deliberately the same shape GRA-82 already proved out for
+ * `trace_processor_shell` in `perfetto.ts`'s `runScript` — `spawn` instead
+ * of `spawnSync`, a `setTimeout` that kills the child and reports how long
+ * it waited, one shared helper rather than a second way to run a child
+ * process asynchronously.
+ *
+ * Progress is reported on stderr, not returned, because nothing here knows
+ * whether anyone is listening for it — it exists so a long recording does
+ * not look identically alive and wedged from the outside.
+ */
+export function runAdbAsync(args, options = {}) {
+    const { serial, binary = findAdb(), timeoutMs = DEFAULT_ADB_TIMEOUT_MS, onProgress = defaultAdbProgress, tickMs = DEFAULT_ADB_TICK_MS, env, } = options;
+    const prefix = serial ? ["-s", serial] : [];
+    const fullArgs = [...prefix, ...args];
+    return new Promise((resolvePromise) => {
+        const start = Date.now();
+        let settled = false;
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        // `env` is only passed through when given: `spawn(binary, fullArgs)`
+        // with no third argument at all is what every real, non-test call makes
+        // (production behaviour is unchanged either way, since Node's own
+        // default is already "inherit process.env").
+        const child = env ? spawn(binary, fullArgs, { env }) : spawn(binary, fullArgs);
+        const ticker = setInterval(() => {
+            if (!settled)
+                onProgress(Date.now() - start, fullArgs);
+        }, tickMs);
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill();
+        }, timeoutMs);
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearInterval(ticker);
+            clearTimeout(timer);
+            resolvePromise(result);
+        };
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        // The binary itself did not run (ENOENT, EACCES, ...) — same wording as
+        // the sync version above, so a caller cannot tell which path answered.
+        child.on("error", (error) => {
+            finish({
+                ok: false,
+                output: `Could not run adb (${error.message}). Set ANDROID_HOME, or put adb on your PATH.`,
+            });
+        });
+        child.on("close", (code) => {
+            if (timedOut) {
+                finish({
+                    ok: false,
+                    output: `adb did not finish within ${timeoutMs}ms running '${fullArgs.join(" ")}'; ` +
+                        "it may be wedged, so it was killed rather than left to hang.",
+                });
+                return;
+            }
+            const output = (stdout + stderr).trim();
+            if (code !== 0) {
+                finish({
+                    ok: false,
+                    output: output.includes("more than one") && !serial
+                        ? `${output}\nStart the UI with --serial <id>; 'adb devices' lists them.`
+                        : output || `adb exited ${code}`,
+                });
+                return;
+            }
+            finish({ ok: true, output });
+        });
+    });
+}
+/**
+ * The `am force-stop` / launcher-intent pair both `restartApp` and
+ * `restartAppAsync` send, and the one honest way to tell whether the second
+ * half actually launched anything.
+ *
+ * monkey reports success on stdout even when it launched nothing, so the
+ * absence of its "Events injected" line — not its exit code — is the signal
+ * that there was no launcher activity to hit.
+ */
+function finishRestart(packageName, started) {
     if (!started.ok)
         return started;
-    // monkey reports success on stdout even when it launched nothing, so the
-    // absence of its "Events injected" line is the honest failure signal.
     if (!started.output.includes("Events injected")) {
         return {
             ok: false,
@@ -61,4 +436,38 @@ export function restartApp(packageName, serial) {
     }
     return { ok: true, output: `restarted ${packageName}` };
 }
+/**
+ * Stop the app and start it again.
+ *
+ * Driven from this side rather than from inside the app: a process cannot
+ * reliably restart itself, and asking it to try is how you end up with a
+ * half-dead process that no longer answers the socket.
+ */
+export function restartApp(packageName, serial) {
+    const stopped = runAdb(["shell", "am", "force-stop", packageName], serial);
+    if (!stopped.ok)
+        return stopped;
+    const started = runAdb(["shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1"], serial);
+    return finishRestart(packageName, started);
+}
+/**
+ * `restartApp`'s async twin, spawned with `runAdbAsync` instead of
+ * `runAdb`'s blocking `spawnSync`.
+ *
+ * GRA-186: `capture_system_trace` restarts the app it is tracing partway
+ * through an already-running recording (see `index.ts`), so it cannot use
+ * the sync version without freezing the event loop for as long as the
+ * force-stop/relaunch pair takes — exactly the problem GRA-89 already fixed
+ * for the recording, pull and cleanup calls in the same tool. This shares
+ * `finishRestart`'s arg-building result and "Events injected" check with the
+ * sync version rather than re-deriving them, so the two can only drift by a
+ * change that touches both call sites.
+ */
+export async function restartAppAsync(packageName, options = {}) {
+    const stopped = await runAdbAsync(["shell", "am", "force-stop", packageName], options);
+    if (!stopped.ok)
+        return stopped;
+    const started = await runAdbAsync(["shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1"], options);
+    return finishRestart(packageName, started);
+}
 //# sourceMappingURL=adb.js.map

package/dist/adb.js.map

@@ -1 +1 @@
-{"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,sCAAsC;AACtC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAE1E,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACnE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,kEAAkE;QAClE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,GAAG,IAAI,CAAC,CAAC;gBACT,SAAS;YACX,CAAC;YACD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,MAAM;YACzC,GAAG,EAAE,CAAC;QACR,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI;QAAE,KAAK,EAAE,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpB,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM;QACjC,IAAI,OAAO,KAAK,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,2EAA2E;QAC3E,gDAAgD;QAChD,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AACtD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAS5C;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACpD,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,qBAAqB,CAAC,KAAa,EAAE,SAAiB;IAC7D,IAAI,sBAAsB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,mBAAmB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,sEAAsE;AACtE,SAAS,yBAAyB,CAAC,IAAY;IAC7C,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,uBAAuB,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,oEAAoE;gBACpE,uEAAuE;gBACvE,MAAM,KAAK,GAAG,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACzE,oEAAoE;gBACpE,kEAAkE;gBAClE,mEAAmE;gBACnE,2DAA2D;gBAC3D,mEAAmE;gBACnE,sEAAsE;gBACtE,kEAAkE;gBAClE,mEAAmE;gBACnE,kEAAkE;gBAClE,0DAA0D;gBAC1D,mEAAmE;gBACnE,qDAAqD;gBACrD,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,wEAAwE;QAC1E,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,gDAAgD;QACjF,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB;IACpC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAqBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,cAAc,GAAG,yBAAyB,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,CAAC;IACjF,IAAI,cAAc;QAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAErF,KAAK,MAAM,QAAQ,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAU,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CAAC;IACtC,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kCAAkC,SAAS,QAAQ;QACjD,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,yCAAyC,MAAM,aAAa,CACrG,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,MAAe;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAEhF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,sBAAsB,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK;gBAC/C,4CAA4C;SAC/C,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EACJ,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM;gBACzC,CAAC,CAAC,GAAG,MAAM,8DAA8D;gBACzE,CAAC,CAAC,MAAM,IAAI,cAAc,MAAM,CAAC,MAAM,EAAE;SAC9C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,OAAO,CAAC;AAEtF,2JAA2J;AAC3J,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC,kHAAkH;AAClH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,IAAc;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,wBAAwB,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAC5F,CAAC;AACJ,CAAC;AA0CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAc,EAAE,UAA8B,EAAE;IAC1E,MAAM,EACJ,MAAM,EACN,MAAM,GAAG,OAAO,EAAE,EAClB,SAAS,GAAG,sBAAsB,EAClC,UAAU,GAAG,kBAAkB,EAC/B,MAAM,GAAG,mBAAmB,EAC5B,GAAG,GACJ,GAAG,OAAO,CAAC;IACZ,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAEtC,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,qEAAqE;QACrE,wEAAwE;QACxE,kEAAkE;QAClE,6CAA6C;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,OAAO;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,CAAC,MAAiB,EAAE,EAAE;YACnC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,MAAM,CAAC,CAAC;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,cAAc,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,wEAAwE;QACxE,uEAAuE;QACvE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,sBAAsB,KAAK,CAAC,OAAO,+CAA+C;aAC3F,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EACJ,6BAA6B,SAAS,eAAe,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;wBAC5E,8DAA8D;iBACjE,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC;oBACL,EAAE,EAAE,KAAK;oBACT,MAAM,EACJ,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM;wBACzC,CAAC,CAAC,GAAG,MAAM,8DAA8D;wBACzE,CAAC,CAAC,MAAM,IAAI,cAAc,IAAI,EAAE;iBACrC,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,WAAmB,EAAE,OAAkB;IAC5D,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,kCAAkC,WAAW,GAAG;SAC3E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,WAAW,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAe;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAEhC,MAAM,OAAO,GAAG,MAAM,CACpB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,kCAAkC,EAAE,GAAG,CAAC,EACrF,MAAM,CACP,CAAC;IACF,OAAO,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,UAA8B,EAAE;IACzF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IACvF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAEhC,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,kCAAkC,EAAE,GAAG,CAAC,EACrF,OAAO,CACR,CAAC;IACF,OAAO,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}