codeloop-mcp-server 0.1.74 → 0.1.76

package/dist/runners/cli_auth.js

@@ -0,0 +1,127 @@
+/**
+ * cli_auth — detect EXPIRED / MISSING provider-CLI logins and push the agent to
+ * re-authenticate so the rest of verification (backend emulators, remote logs,
+ * and the full visual journey) can proceed.
+ *
+ * When a developer's `firebase` / `gcloud` / `heroku` / … session has expired,
+ * an auto-detected backend (e.g. the Firebase Emulator Suite) can't start and
+ * remote-log pulls fail. That is NOT a code bug — it's a one-step auth fix. The
+ * right behaviour is to STOP guessing and tell the agent to run the exact login
+ * command in an interactive terminal so the USER can complete the browser
+ * sign-in, then re-run codeloop_verify and the visual journey.
+ */
+/**
+ * Provider table. login_command is the canonical interactive re-auth command.
+ * Signatures are intentionally provider-specific so we name the right CLI.
+ */
+const PROVIDERS = [
+    {
+        cli: "firebase",
+        label: "Firebase",
+        login_command: "firebase login --reauth",
+        signatures: [
+            /firebase login --reauth/i,
+            /credentials are no longer valid/i,
+            /Failed to (?:list|retrieve) log entries.*Google Cloud/i,
+            /run `firebase login`/i,
+            /Authentication Error.*firebase/i,
+        ],
+    },
+    {
+        cli: "gcloud",
+        label: "Google Cloud (gcloud)",
+        login_command: "gcloud auth login",
+        signatures: [
+            /gcloud auth (?:login|application-default login)/i,
+            /Your current active account.*does not have any valid credentials/i,
+            /Reauthentication failed|invalid_grant/i,
+        ],
+    },
+    {
+        cli: "heroku",
+        label: "Heroku",
+        login_command: "heroku login",
+        signatures: [/heroku login/i, /not logged in.*heroku/i, /Invalid credentials.*heroku/i],
+    },
+    {
+        cli: "vercel",
+        label: "Vercel",
+        login_command: "vercel login",
+        signatures: [/vercel login/i, /not authenticated.*vercel/i, /Please log in.*vercel/i],
+    },
+    {
+        cli: "fly",
+        label: "Fly.io",
+        login_command: "fly auth login",
+        signatures: [/fly(?:ctl)? auth login/i, /not logged in.*fly/i],
+    },
+    {
+        cli: "aws",
+        label: "AWS",
+        login_command: "aws sso login   # (or: aws configure)",
+        signatures: [/aws sso login/i, /The SSO session.*has expired/i, /ExpiredToken|InvalidClientTokenId/i],
+    },
+    {
+        cli: "gh",
+        label: "GitHub CLI",
+        login_command: "gh auth login",
+        signatures: [/gh auth login/i, /authentication required.*gh/i],
+    },
+    {
+        cli: "az",
+        label: "Azure",
+        login_command: "az login",
+        signatures: [/\baz login\b/i, /az account.*not.*logged in/i, /AADSTS\d+/i],
+    },
+    {
+        cli: "supabase",
+        label: "Supabase",
+        login_command: "supabase login",
+        signatures: [/supabase login/i, /Access token not provided.*supabase/i],
+    },
+];
+/**
+ * PURE: scan CLI/log output for expired-auth signatures and return the set of
+ * providers that need re-authentication (deduped, in table order).
+ */
+export function detectExpiredCliAuth(text) {
+    if (!text)
+        return [];
+    const out = [];
+    for (const p of PROVIDERS) {
+        if (p.signatures.some((re) => re.test(text))) {
+            out.push({ cli: p.cli, label: p.label, login_command: p.login_command });
+        }
+    }
+    return out;
+}
+/** Look up a provider's interactive login command by CLI name. */
+export function loginCommandFor(cli) {
+    const p = PROVIDERS.find((x) => x.cli === cli.toLowerCase());
+    return p ? p.login_command : null;
+}
+/**
+ * Build a HARD directive that pushes the agent to run the re-auth command(s) in
+ * an INTERACTIVE terminal so the user can complete sign-in, then re-run so the
+ * full verification (incl. visual journey) proceeds. `context` tunes the
+ * trailing instruction.
+ */
+export function buildCliAuthDirective(issues, context) {
+    if (issues.length === 0)
+        return "";
+    const lines = [];
+    lines.push("[CodeLoop AUTH] A provider CLI login has EXPIRED — this is a one-step auth fix, NOT a code bug. " +
+        (context === "backend"
+            ? "Because of it, the backend (e.g. the Firebase Emulator Suite) could not start, so backend + interactive visual verification were blocked."
+            : "Because of it, production/3rd-party logs could not be pulled."));
+    lines.push("");
+    lines.push("ACTION — run the matching command in an INTERACTIVE terminal so the USER can complete the browser sign-in:");
+    for (const i of issues) {
+        lines.push(`    ${i.login_command}        # re-authenticate ${i.label}`);
+    }
+    lines.push("");
+    lines.push("Do NOT skip silently and do NOT 'fix' source code for this. After the user finishes signing in, re-run codeloop_verify; " +
+        "then call codeloop_run_journey (fix mode) so CodeLoop launches the app and runs the full visual verification.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=cli_auth.js.map

package/dist/runners/cli_auth.js.map

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

package/dist/runners/device_probe.d.ts

@@ -22,6 +22,47 @@ export interface MobileTargets {
  */
 export declare function detectMobileTargets(cwd: string): MobileTargets;
 export declare function probeBootedDevices(): Promise<BootedDevices>;
+export interface BootResult {
+    /** A device for this platform is now available to drive. */
+    booted: boolean;
+    /** It was already booted — no boot action was taken. */
+    already: boolean;
+    platform: "android" | "ios";
+    /** The AVD id / simulator udid|name that was (or is) booted. */
+    device?: string;
+    /** The command used to boot (for logs/diagnostics). */
+    command?: string;
+    /** Why booting did not happen / failed. */
+    reason?: string;
+}
+/**
+ * Parse `flutter emulators` output into available emulator ids per platform.
+ * Lines look like: `Pixel_7_API_34 • Pixel 7 API 34 • Google • android`.
+ */
+export declare function parseFlutterEmulators(output: string): Array<{
+    id: string;
+    platform: "android" | "ios";
+}>;
+/** Parse `emulator -list-avds` (one AVD name per line). */
+export declare function parseAvdList(output: string): string[];
+/**
+ * Parse `xcrun simctl list devices available` for the first bootable iPhone
+ * UDID (and its name). Returns null when none are available.
+ */
+export declare function parseFirstAvailableIosDevice(output: string): {
+    udid: string;
+    name: string;
+} | null;
+/**
+ * Boot an Android emulator or iOS simulator for the deep-E2E executor.
+ * Idempotent (reuses an already-booted device). Never throws.
+ */
+export declare function bootDevice(opts: {
+    platform: "android" | "ios";
+    avd?: string;
+    iosDevice?: string;
+    timeoutMs?: number;
+}): Promise<BootResult>;
 /**
  * Build a HARD directive that pushes the agent to OPEN the missing
  * simulator(s) before real interactive testing can proceed. Lists exact,

package/dist/runners/device_probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device_probe.d.ts","sourceRoot":"","sources":["../../src/runners/device_probe.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,2BAA2B;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,GAAG,EAAE,OAAO,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAW9D;AAYD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CASjE;AAmDD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAAC;CAC7C,GAAG,MAAM,CAoDT"}
+{"version":3,"file":"device_probe.d.ts","sourceRoot":"","sources":["../../src/runners/device_probe.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,2BAA2B;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,GAAG,EAAE,OAAO,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAW9D;AAYD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CASjE;AAgED,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAA;CAAE,CAAC,CAcpD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQvC;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,UAAU,CAAC,CAItB;AAwGD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAAC;CAC7C,GAAG,MAAM,CAoDT"}

package/dist/runners/device_probe.js

@@ -18,7 +18,7 @@
 import { existsSync, readdirSync } from "fs";
 import { join } from "path";
 import { platform } from "os";
-import { runCommand } from "./base.js";
+import { runCommand, checkToolAvailable } from "./base.js";
 const PROBE_TIMEOUT_MS = 15_000;
 /**
  * Inspect a project directory for android/ and ios/ subfolders (Flutter,
@@ -89,6 +89,167 @@ async function probeIos() {
         .filter(Boolean);
     return { names, available: true };
 }
+// ── Device BOOT (deep-E2E only) ─────────────────────────────────────
+//
+// `probeBootedDevices` only DETECTS. The deep-E2E executor (codeloop_run_journey)
+// needs a booted device to drive, so it may BOOT one — but only because the
+// caller explicitly asked for an interactive run (booting is implied consent).
+// Plain `codeloop_verify` must NEVER call these. Booting is heavyweight and
+// takes over the desktop, so we: reuse an already-booted device, honor the
+// configured AVD / simulator, auto-pick the first available otherwise, and
+// degrade with a clear reason when the tooling is absent.
+const BOOT_TIMEOUT_MS = 180_000; // cold emulator/simulator boot can take 1-3 min
+const BOOT_CMD_TIMEOUT_MS = 30_000;
+/**
+ * Parse `flutter emulators` output into available emulator ids per platform.
+ * Lines look like: `Pixel_7_API_34 • Pixel 7 API 34 • Google • android`.
+ */
+export function parseFlutterEmulators(output) {
+    const out = [];
+    for (const raw of output.split("\n")) {
+        const line = raw.trim();
+        // id • display • manufacturer • platform
+        const parts = line.split("•").map((p) => p.trim());
+        if (parts.length < 4)
+            continue;
+        const id = parts[0];
+        const plat = parts[parts.length - 1].toLowerCase();
+        if (!id || /available emulators|^\d+\s/i.test(id))
+            continue;
+        if (plat === "android")
+            out.push({ id, platform: "android" });
+        else if (plat === "ios")
+            out.push({ id, platform: "ios" });
+    }
+    return out;
+}
+/** Parse `emulator -list-avds` (one AVD name per line). */
+export function parseAvdList(output) {
+    return output
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0 && !/^INFO\b|^WARNING\b|^PANIC\b/i.test(l));
+}
+/**
+ * Parse `xcrun simctl list devices available` for the first bootable iPhone
+ * UDID (and its name). Returns null when none are available.
+ */
+export function parseFirstAvailableIosDevice(output) {
+    // Lines: "    iPhone 15 (UDID) (Shutdown)" — we want a Shutdown iPhone.
+    for (const raw of output.split("\n")) {
+        const line = raw.trim();
+        const m = line.match(/^(iPhone[^()]*?)\s*\(([0-9A-Fa-f-]{36})\)\s*\((Shutdown|Booted)\)/);
+        if (m)
+            return { udid: m[2], name: m[1].trim() };
+    }
+    return null;
+}
+/**
+ * Boot an Android emulator or iOS simulator for the deep-E2E executor.
+ * Idempotent (reuses an already-booted device). Never throws.
+ */
+export async function bootDevice(opts) {
+    const timeoutMs = opts.timeoutMs ?? BOOT_TIMEOUT_MS;
+    if (opts.platform === "android")
+        return bootAndroid(opts.avd, timeoutMs);
+    return bootIos(opts.iosDevice, timeoutMs);
+}
+async function bootAndroid(avd, timeoutMs) {
+    const r = { booted: false, already: false, platform: "android" };
+    const pre = await probeBootedDevices();
+    if (pre.android.length > 0) {
+        return { ...r, booted: true, already: true, device: pre.android[0] };
+    }
+    if (!pre.adb_available) {
+        return { ...r, reason: "adb not on PATH — install Android platform-tools / Android Studio to boot an emulator." };
+    }
+    // Resolve which AVD to launch + the launch command.
+    const hasFlutter = await checkToolAvailable("flutter");
+    let launchCmd = null;
+    if (hasFlutter) {
+        const list = await runCommand("flutter", ["emulators"], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+        const androids = parseFlutterEmulators(list.stdout + list.stderr).filter((e) => e.platform === "android");
+        const chosen = avd && androids.some((e) => e.id === avd) ? avd : androids[0]?.id;
+        if (chosen)
+            launchCmd = { cmd: "flutter", args: ["emulators", "--launch", chosen], chosen };
+    }
+    if (!launchCmd && (await checkToolAvailable("emulator"))) {
+        const list = await runCommand("emulator", ["-list-avds"], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+        const avds = parseAvdList(list.stdout);
+        const chosen = avd && avds.includes(avd) ? avd : avds[0];
+        if (chosen)
+            launchCmd = { cmd: "emulator", args: ["-avd", chosen], chosen };
+    }
+    if (!launchCmd) {
+        return {
+            ...r,
+            reason: avd
+                ? `No Android AVD named "${avd}" found (checked flutter emulators / emulator -list-avds). Create it in Android Studio.`
+                : "No Android AVDs found. Create one in Android Studio (Device Manager) first.",
+        };
+    }
+    // Launch async (don't wait for the emulator process to exit) then poll readiness.
+    void runCommand(launchCmd.cmd, launchCmd.args, process.cwd(), undefined, undefined, timeoutMs);
+    const ready = await waitForAndroidReady(timeoutMs);
+    return {
+        ...r,
+        booted: ready,
+        device: ready ? (await probeBootedDevices()).android[0] ?? launchCmd.chosen : launchCmd.chosen,
+        command: `${launchCmd.cmd} ${launchCmd.args.join(" ")}`,
+        reason: ready ? undefined : `Emulator "${launchCmd.chosen}" did not finish booting within ${Math.round(timeoutMs / 1000)}s.`,
+    };
+}
+async function waitForAndroidReady(timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const booted = await probeBootedDevices();
+        if (booted.android.length > 0) {
+            // Device is attached; confirm the OS finished booting.
+            const prop = await runCommand("adb", ["shell", "getprop", "sys.boot_completed"], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+            if (prop.stdout.trim() === "1")
+                return true;
+        }
+        await new Promise((res) => setTimeout(res, 3000));
+    }
+    return false;
+}
+async function bootIos(iosDevice, timeoutMs) {
+    const r = { booted: false, already: false, platform: "ios" };
+    if (platform() !== "darwin") {
+        return { ...r, reason: "iOS simulators require macOS." };
+    }
+    const pre = await probeBootedDevices();
+    if (pre.ios.length > 0) {
+        return { ...r, booted: true, already: true, device: pre.ios[0] };
+    }
+    if (!pre.xcrun_available) {
+        return { ...r, reason: "xcrun not on PATH — install Xcode + command line tools." };
+    }
+    // Resolve target simulator: configured name, else first available iPhone.
+    let target = iosDevice;
+    if (!target) {
+        const list = await runCommand("xcrun", ["simctl", "list", "devices", "available"], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+        const dev = parseFirstAvailableIosDevice(list.stdout);
+        if (!dev)
+            return { ...r, reason: "No available iOS simulators. Add a runtime/device in Xcode > Settings > Platforms." };
+        target = dev.udid;
+    }
+    const boot = await runCommand("xcrun", ["simctl", "boot", target], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+    // "Unable to boot device in current state: Booted" is success-equivalent.
+    const alreadyBooted = /current state: Booted/i.test(boot.stderr);
+    // Open the Simulator UI so the app is visible for screenshots/video.
+    void runCommand("open", ["-a", "Simulator"], process.cwd(), undefined, undefined, BOOT_CMD_TIMEOUT_MS);
+    // bootstatus blocks until the device is fully booted (or returns immediately if booted).
+    const status = await runCommand("xcrun", ["simctl", "bootstatus", target, "-b"], process.cwd(), undefined, undefined, timeoutMs);
+    const ready = status.exit_code === 0 || alreadyBooted;
+    return {
+        ...r,
+        booted: ready,
+        device: target,
+        command: `xcrun simctl boot ${target}`,
+        reason: ready ? undefined : `Simulator "${target}" did not finish booting within ${Math.round(timeoutMs / 1000)}s.`,
+    };
+}
 /**
  * Build a HARD directive that pushes the agent to OPEN the missing
  * simulator(s) before real interactive testing can proceed. Lists exact,

package/dist/runners/device_probe.js.map

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

package/dist/runners/interaction_engine.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Interaction engine — the reusable core that DRIVES a single UI step against
+ * a running app, across all four target types (browser / desktop / Android /
+ * iOS). It dispatches the journey-relevant action set to the same low-level
+ * primitives the `codeloop_interact` MCP tool uses (browser_interaction.ts +
+ * window_manager.ts), so the new server-side orchestrator (codeloop_run_journey)
+ * can drive a planned journey end-to-end WITHOUT a per-step MCP round-trip.
+ *
+ * Scope: this engine intentionally covers the subset of actions a planned
+ * journey needs (navigate, click, type, submit, fill, read-back/assert, scroll,
+ * wait, simple mobile taps/keys). The full, exhaustive action surface (UIA
+ * automation, Maestro flows, biometric, network shaping, drag, etc.) remains in
+ * the `codeloop_interact` tool. When the engine hits an action or a missing
+ * field it can't satisfy, it returns `{ success: false, unsupported: true }`
+ * with a directive so the orchestrator can fall back to the agent instead of
+ * failing the whole run.
+ */
+export type JourneyTarget = "browser" | "desktop" | "android_emulator" | "ios_simulator";
+export interface InteractionStep {
+    action: string;
+    selector?: string;
+    text?: string;
+    url?: string;
+    x?: number;
+    y?: number;
+    x2?: number;
+    y2?: number;
+    key?: string;
+    keys?: string;
+    direction?: "up" | "down" | "left" | "right";
+    amount?: number;
+    duration_ms?: number;
+    /** [get_text] assert the read-back text contains this substring (ci). */
+    expect_contains?: string;
+    /** Semantic label for CRUD/intent classification (logged by the caller). */
+    intent?: string;
+}
+export interface InteractionContext {
+    target: JourneyTarget;
+    /** App name for desktop front-bring (optional). */
+    app_name?: string;
+}
+export interface InteractionResult {
+    action: string;
+    success: boolean;
+    detail: string;
+    /** Text read back by a get_text action. */
+    extractedText?: string | null;
+    assertion?: {
+        expected: string;
+        matched: boolean;
+        actual_excerpt: string;
+    };
+    /** True when the engine can't satisfy this step (caller should fall back). */
+    unsupported?: boolean;
+}
+/** Drive a single journey step. Never throws; returns a structured result. */
+export declare function executeInteraction(step: InteractionStep, ctx: InteractionContext): Promise<InteractionResult>;
+//# sourceMappingURL=interaction_engine.d.ts.map

package/dist/runners/interaction_engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction_engine.d.ts","sourceRoot":"","sources":["../../src/runners/interaction_engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0BD,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}