@zenalexa/unicli 0.219.0 → 0.220.0

package/dist/adapters/grok/web.js

@@ -0,0 +1,553 @@
+/**
+ * @owner   src/adapters/grok/web.ts
+ * @does    Register agent-facing Grok web commands implemented with site-specific safety checks.
+ * @needs   Logged-in grok.com browser session, Grok chat DOM, optional local image output directory.
+ * @feeds   surface coverage ledger and Grok read/history/detail/send/new/status/image workflows.
+ * @breaks  Grok DOM drift or weak UUID validation can miss or target the wrong conversation.
+ */
+import { createHash } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { cli, Strategy } from "../../registry.js";
+import { boolArg, js, str } from "../_shared/browser-tools.js";
+const GROK_HOME = "https://grok.com/";
+const GROK_SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const VISIBLE_JS = `const isVisible = (node) => {
+  if (!(node instanceof Element)) return false;
+  const style = window.getComputedStyle(node);
+  if (style.visibility === 'hidden' || style.display === 'none') return false;
+  const rect = node.getBoundingClientRect();
+  return rect.width > 0 && rect.height > 0;
+};`;
+export function normalizeGrokBoolean(value, fallback = false) {
+    if (typeof value === "boolean")
+        return value;
+    if (value === undefined || value === null || value === "")
+        return fallback;
+    return /^(true|1|yes|on)$/i.test(str(value).trim());
+}
+export function parseGrokSessionId(value) {
+    const raw = str(value).trim();
+    if (!raw)
+        throw new Error("Grok session ID cannot be empty.");
+    let candidate = raw;
+    if (/^[a-z][a-z0-9+.-]*:\/\//i.test(raw)) {
+        let parsed;
+        try {
+            parsed = new URL(raw);
+        }
+        catch {
+            throw new Error(`Invalid Grok URL: ${raw}.`);
+        }
+        const host = parsed.hostname.toLowerCase();
+        const match = parsed.pathname.match(/^\/c\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\/?$/i);
+        if (parsed.protocol !== "https:" ||
+            (host !== "grok.com" && !host.endsWith(".grok.com")) ||
+            !match) {
+            throw new Error(`Invalid Grok conversation URL: ${raw}. Expected https://grok.com/c/<uuid>.`);
+        }
+        candidate = match[1];
+    }
+    if (!GROK_SESSION_ID_RE.test(candidate)) {
+        throw new Error(`Invalid Grok session ID: ${raw}. Expected a UUID or https://grok.com/c/<uuid>.`);
+    }
+    return candidate.toLowerCase();
+}
+export function grokHtmlToMarkdown(value) {
+    return str(value)
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/(p|div|li|h[1-6]|pre)>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&amp;/g, "&")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+export function mapGrokBubbles(bubbles, wantMarkdown) {
+    return bubbles
+        .map((bubble) => {
+        const role = str(bubble.role) === "Assistant" ? "Assistant" : "User";
+        const text = wantMarkdown && role === "Assistant" && str(bubble.html).trim()
+            ? grokHtmlToMarkdown(bubble.html) || str(bubble.text)
+            : str(bubble.text);
+        return { Role: role, Text: text.trim() };
+    })
+        .filter((row) => row.Text);
+}
+export function mapGrokSessions(sessions) {
+    return sessions
+        .map((session, index) => {
+        const id = str(session.id).toLowerCase();
+        return {
+            Index: index + 1,
+            Title: str(session.title, "(untitled)").trim() || "(untitled)",
+            Url: `${GROK_HOME}c/${id}`,
+        };
+    })
+        .filter((row) => /\/c\/[0-9a-f-]{36}$/i.test(str(row.Url)));
+}
+export function pickLatestGrokImages(bubbleImageSets, baselineCount) {
+    const freshSets = bubbleImageSets.slice(Math.max(0, baselineCount));
+    for (let i = freshSets.length - 1; i >= 0; i -= 1) {
+        if (freshSets[i]?.length)
+            return freshSets[i];
+    }
+    return [];
+}
+function outputDir(value) {
+    return str(value).replace(/^~(?=$|\/)/, homedir());
+}
+function grokBoundedInt(value, fallback, max, label) {
+    const raw = value ?? fallback;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error(`Grok ${label} must be a positive integer.`);
+    }
+    if (n > max) {
+        throw new Error(`Grok ${label} must be <= ${max}.`);
+    }
+    return n;
+}
+function imageExt(mime) {
+    const value = str(mime).toLowerCase();
+    if (value.includes("png"))
+        return "png";
+    if (value.includes("webp"))
+        return "webp";
+    if (value.includes("gif"))
+        return "gif";
+    return "jpg";
+}
+function imageFileName(url, mime) {
+    const hash = createHash("sha1").update(url).digest("hex").slice(0, 12);
+    return `grok-${Date.now()}-${hash}.${imageExt(mime)}`;
+}
+function imageSignature(images) {
+    return images
+        .map((image) => image.src)
+        .sort()
+        .join("|");
+}
+async function currentUrl(page) {
+    const value = await page.evaluate("window.location.href").catch(() => "");
+    return typeof value === "string" ? value : "";
+}
+async function ensureOnGrok(page) {
+    const url = await currentUrl(page);
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        if (host === "grok.com" || host.endsWith(".grok.com"))
+            return;
+    }
+    catch {
+        await page.goto(GROK_HOME, { waitUntil: "load", settleMs: 2500 });
+        await page.wait(2);
+        return;
+    }
+    await page.goto(GROK_HOME, { waitUntil: "load", settleMs: 2500 });
+    await page.wait(2);
+}
+async function isLoggedIn(page) {
+    const result = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const composer = document.querySelector('.ProseMirror[contenteditable="true"]');
+    if (composer && isVisible(composer)) {
+      const signInCta = Array.from(document.querySelectorAll('button, a'))
+        .some((node) => isVisible(node) && /^(sign in|log in)$/i.test((node.textContent || '').trim()));
+      return !signInCta;
+    }
+    return false;
+  })()`);
+    return Boolean(result);
+}
+async function getCurrentSessionId(page) {
+    const url = await currentUrl(page);
+    const match = url.match(/\/c\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i);
+    return match ? match[1].toLowerCase() : "";
+}
+async function getModelLabel(page) {
+    const result = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const trigger = Array.from(document.querySelectorAll('button[aria-label="Model select"]'))
+      .find((node) => isVisible(node));
+    return trigger ? (trigger.innerText || trigger.textContent || '').trim().split('\\n')[0].trim() : '';
+  })()`);
+    return typeof result === "string" ? result : "";
+}
+async function getMessageBubbles(page) {
+    const result = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const findResponseId = (node) => {
+      let parent = node.parentElement;
+      while (parent && parent !== document.body) {
+        const id = parent.getAttribute('id') || '';
+        if (id.startsWith('response-')) return id.slice('response-'.length);
+        parent = parent.parentElement;
+      }
+      return '';
+    };
+    const bubbles = Array.from(document.querySelectorAll('[data-testid="user-message"], [data-testid="assistant-message"]'))
+      .filter((node) => node instanceof HTMLElement && isVisible(node));
+    return bubbles.map((node, index) => {
+      const isAssistant = node.getAttribute('data-testid') === 'assistant-message';
+      const responseId = findResponseId(node) || ('pos-' + index);
+      const html = node.innerHTML || '';
+      const text = (node.innerText || node.textContent || '').replace(/\\s+/g, ' ').trim();
+      return {
+        id: responseId + (isAssistant ? '-assistant' : '-user'),
+        role: isAssistant ? 'Assistant' : 'User',
+        text,
+        html,
+      };
+    });
+  })()`);
+    return Array.isArray(result)
+        ? result.filter((bubble) => str(bubble.id) && (str(bubble.text) || str(bubble.html)))
+        : [];
+}
+async function getHistoryFromSidebar(page, limit) {
+    const result = await page.evaluate(`(() => {
+    ${VISIBLE_JS}
+    const re = /^\\/c\\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+    const entries = [];
+    const seen = new Set();
+    const anchors = Array.from(document.querySelectorAll('a[href^="/c/"]'));
+    for (const a of anchors) {
+      if (!(a instanceof HTMLElement) || !isVisible(a)) continue;
+      const href = a.getAttribute('href') || '';
+      const match = href.match(re);
+      if (!match) continue;
+      const id = match[1].toLowerCase();
+      const title = (a.innerText || a.textContent || '').trim();
+      if (!seen.has(id)) {
+        seen.add(id);
+        entries.push({ id, title });
+      } else if (title) {
+        const existing = entries.find((entry) => entry.id === id);
+        if (existing && !existing.title) existing.title = title;
+      }
+    }
+    return entries;
+  })()`);
+    const sessions = Array.isArray(result)
+        ? result
+        : [];
+    const rows = mapGrokSessions(sessions).slice(0, limit);
+    if (!rows.length)
+        throw new Error("No Grok conversations found in the sidebar.");
+    return rows;
+}
+async function startNewChat(page) {
+    await page.goto(GROK_HOME, { waitUntil: "load", settleMs: 2500 });
+    await page.wait(2);
+}
+async function sendGrokMessage(page, prompt) {
+    const result = (await page.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const composerSelector = '.ProseMirror[contenteditable="true"]';
+    let composer = null;
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+      const candidate = document.querySelector(composerSelector);
+      if (candidate instanceof HTMLElement) {
+        composer = candidate;
+        break;
+      }
+      await waitFor(500);
+    }
+    if (!(composer instanceof HTMLElement)) {
+      return { ok: false, reason: 'Grok composer (.ProseMirror) was not found on grok.com.' };
+    }
+    const editor = composer.editor;
+    if (!editor?.commands?.focus || !editor?.commands?.insertContent) {
+      return { ok: false, reason: 'Grok composer editor API was unavailable.' };
+    }
+    if (typeof editor.commands.clearContent === 'function') editor.commands.clearContent();
+    editor.commands.focus();
+    editor.commands.insertContent(${js(prompt)});
+    const isClickableSubmit = (node) => {
+      if (!(node instanceof HTMLButtonElement)) return false;
+      if (node.disabled) return false;
+      const style = window.getComputedStyle(node);
+      if (style.visibility === 'hidden' || style.display === 'none') return false;
+      const rect = node.getBoundingClientRect();
+      return rect.width > 0 && rect.height > 0;
+    };
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+      const submit = Array.from(document.querySelectorAll('button[aria-label="Submit"]')).find(isClickableSubmit);
+      if (submit instanceof HTMLButtonElement) {
+        submit.click();
+        return { ok: true };
+      }
+      await waitFor(500);
+    }
+    return { ok: false, reason: 'Grok submit button did not reach a clickable state.' };
+  })()`));
+    if (!result?.ok)
+        throw new Error(result?.reason || "Failed to send Grok prompt.");
+}
+async function getBubbleImageSets(page) {
+    const result = await page.evaluate(`(() => {
+    const bubbles = document.querySelectorAll('div.message-bubble, [data-testid="message-bubble"], [data-testid="assistant-message"]');
+    const dedupe = (images) => {
+      const seen = new Set();
+      const out = [];
+      for (const image of images) {
+        if (!image.src || seen.has(image.src)) continue;
+        seen.add(image.src);
+        out.push(image);
+      }
+      return out;
+    };
+    return Array.from(bubbles).map((bubble) => dedupe(Array.from(bubble.querySelectorAll('img'))
+      .map((img) => ({
+        src: img.currentSrc || img.src || '',
+        w: img.naturalWidth || img.width || 0,
+        h: img.naturalHeight || img.height || 0,
+      }))
+      .filter((image) => image.src && /^https?:/.test(image.src))
+      .filter((image) => (image.w === 0 || image.w >= 128) && (image.h === 0 || image.h >= 128))));
+  })()`);
+    if (!Array.isArray(result))
+        return [];
+    return result.map((set) => Array.isArray(set)
+        ? set
+            .map((image) => ({
+            src: str(image.src),
+            w: Number(image.w) || 0,
+            h: Number(image.h) || 0,
+        }))
+            .filter((image) => image.src)
+        : []);
+}
+async function fetchImageAsset(page, url) {
+    const result = (await page.evaluate(`(async () => {
+    const response = await fetch(${js(url)}, { credentials: 'include', referrer: 'https://grok.com/' });
+    if (!response.ok) return { ok: false, status: response.status };
+    const blob = await response.blob();
+    const bytes = new Uint8Array(await blob.arrayBuffer());
+    let binary = '';
+    const chunk = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunk) {
+      binary += String.fromCharCode.apply(null, bytes.subarray(i, i + chunk));
+    }
+    return { ok: true, mime: blob.type || 'image/jpeg', base64: btoa(binary) };
+  })()`));
+    if (!result?.ok || !result.base64) {
+        throw new Error(`Failed to download Grok image ${url}: status=${result?.status ?? "?"}.`);
+    }
+    return { mime: str(result.mime), base64: result.base64 };
+}
+cli({
+    site: "grok",
+    name: "read",
+    description: "Read messages in the current Grok conversation",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "markdown", type: "bool", default: false }],
+    columns: ["Role", "Text"],
+    func: async (page, kwargs) => {
+        const p = page;
+        await ensureOnGrok(p);
+        await p.wait(2);
+        const rows = mapGrokBubbles(await getMessageBubbles(p), normalizeGrokBoolean(kwargs.markdown));
+        if (!rows.length)
+            throw new Error("No visible Grok messages in the current conversation.");
+        return rows;
+    },
+});
+cli({
+    site: "grok",
+    name: "history",
+    description: "List recent Grok conversations from the sidebar",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [{ name: "limit", type: "int", default: 20 }],
+    columns: ["Index", "Title", "Url"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const limit = grokBoundedInt(kwargs.limit, 20, 100, "history limit");
+        await ensureOnGrok(p);
+        await p.wait(2);
+        if (!(await isLoggedIn(p)))
+            throw new Error("Grok login is required.");
+        return getHistoryFromSidebar(p, limit);
+    },
+});
+cli({
+    site: "grok",
+    name: "detail",
+    description: "Open a Grok conversation by ID and read its messages",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: "id", type: "str", required: true, positional: true },
+        { name: "markdown", type: "bool", default: false },
+    ],
+    columns: ["Role", "Text"],
+    func: async (page, kwargs) => {
+        const p = page;
+        const sessionId = parseGrokSessionId(kwargs.id);
+        await p.goto(`${GROK_HOME}c/${sessionId}`, {
+            waitUntil: "load",
+            settleMs: 2500,
+        });
+        const startedAt = Date.now();
+        while (Date.now() - startedAt < 20_000) {
+            const rows = mapGrokBubbles(await getMessageBubbles(p), normalizeGrokBoolean(kwargs.markdown));
+            if (rows.length)
+                return rows;
+            await p.wait(1);
+        }
+        throw new Error(`No visible Grok messages found for conversation ${sessionId}.`);
+    },
+});
+cli({
+    site: "grok",
+    name: "send",
+    description: "Send a prompt to Grok without waiting for the reply",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: "prompt", type: "str", required: true, positional: true },
+        { name: "new", type: "bool", default: false },
+    ],
+    columns: ["Status", "Prompt"],
+    func: async (page, kwargs) => {
+        const prompt = str(kwargs.prompt).trim();
+        if (!prompt)
+            throw new Error("Grok prompt cannot be empty.");
+        const p = page;
+        await ensureOnGrok(p);
+        if (boolArg(kwargs.new))
+            await startNewChat(p);
+        await sendGrokMessage(p, prompt);
+        return [{ Status: "sent", Prompt: prompt }];
+    },
+});
+cli({
+    site: "grok",
+    name: "new",
+    description: "Start a new conversation in Grok",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    columns: ["Status"],
+    func: async (page) => {
+        await startNewChat(page);
+        return [{ Status: "New chat started" }];
+    },
+});
+cli({
+    site: "grok",
+    name: "status",
+    description: "Check Grok page availability, login state, current session and model",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    columns: ["Status", "Login", "Model", "SessionId", "Url"],
+    func: async (page) => {
+        const p = page;
+        await ensureOnGrok(p);
+        await p.wait(2);
+        const [loggedIn, sessionId, model, url] = await Promise.all([
+            isLoggedIn(p),
+            getCurrentSessionId(p),
+            getModelLabel(p),
+            currentUrl(p),
+        ]);
+        return [
+            {
+                Status: "Connected",
+                Login: loggedIn ? "Yes" : "No",
+                Model: model || null,
+                SessionId: sessionId || null,
+                Url: url,
+            },
+        ];
+    },
+});
+cli({
+    site: "grok",
+    name: "image",
+    description: "Generate images with Grok and return or save image assets",
+    domain: "grok.com",
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: "prompt", type: "str", required: true, positional: true },
+        { name: "timeout", type: "int", default: 240 },
+        { name: "new", type: "bool", default: false },
+        { name: "count", type: "int", default: 1 },
+        { name: "out", type: "str", default: "" },
+    ],
+    columns: ["url", "width", "height", "path"],
+    func: async (page, kwargs) => {
+        const prompt = str(kwargs.prompt).trim();
+        if (!prompt)
+            throw new Error("Grok image prompt cannot be empty.");
+        const p = page;
+        const timeout = grokBoundedInt(kwargs.timeout, 240, 600, "image timeout");
+        const minCount = grokBoundedInt(kwargs.count, 1, 100, "image count");
+        await ensureOnGrok(p);
+        if (normalizeGrokBoolean(kwargs.new))
+            await startNewChat(p);
+        const baselineCount = (await getBubbleImageSets(p)).length;
+        await sendGrokMessage(p, prompt);
+        const startedAt = Date.now();
+        let lastSignature = "";
+        let stableCount = 0;
+        let lastImages = [];
+        while (Date.now() - startedAt < timeout * 1000) {
+            await p.wait(3);
+            const images = pickLatestGrokImages(await getBubbleImageSets(p), baselineCount);
+            if (images.length >= minCount) {
+                const signature = imageSignature(images);
+                if (signature === lastSignature) {
+                    stableCount += 1;
+                    if (stableCount >= 2) {
+                        lastImages = images;
+                        break;
+                    }
+                }
+                else {
+                    stableCount = 0;
+                    lastSignature = signature;
+                    lastImages = images;
+                }
+            }
+        }
+        if (!lastImages.length)
+            throw new Error("No generated Grok images observed before timeout.");
+        const dir = str(kwargs.out).trim() ? outputDir(kwargs.out) : "";
+        if (dir)
+            mkdirSync(dir, { recursive: true });
+        const rows = [];
+        for (const image of lastImages) {
+            let filePath = "";
+            if (dir) {
+                const asset = await fetchImageAsset(p, image.src);
+                filePath = join(dir, imageFileName(image.src, asset.mime));
+                writeFileSync(filePath, Buffer.from(asset.base64, "base64"));
+            }
+            rows.push({
+                url: image.src,
+                width: image.w,
+                height: image.h,
+                path: filePath,
+            });
+        }
+        return rows;
+    },
+});
+//# sourceMappingURL=web.js.map

package/dist/adapters/grok/web.js.map

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

package/dist/adapters/hackernews/read.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @owner   src/adapters/hackernews/read.ts
+ * @does    Register agent-facing Hacker News story reader with threaded comments.
+ * @needs   Public Firebase item API, bounded tree traversal, HTML-to-text conversion.
+ * @feeds   surface coverage ledger, HN story reading workflow, comment thread inspection.
+ * @breaks  HN item shape drift, weak traversal bounds, or HTML entity loss degrades story reads.
+ */
+interface HnItem {
+    id?: unknown;
+    type?: unknown;
+    by?: unknown;
+    title?: unknown;
+    text?: unknown;
+    url?: unknown;
+    score?: unknown;
+    kids?: unknown;
+    deleted?: unknown;
+    dead?: unknown;
+}
+export declare function requireHnItemId(value: unknown): string;
+export declare function requirePositiveInt(value: unknown, fallback: number, label: string): number;
+export declare function requireMinInt(value: unknown, fallback: number, min: number, label: string): number;
+export declare function hnHtmlToText(html: unknown): string;
+export declare function buildHnReadRows(story: HnItem | null, fetchItem: (id: number) => Promise<HnItem | null>, options: {
+    limit: number;
+    maxDepth: number;
+    maxReplies: number;
+    maxLength: number;
+}): Promise<Array<Record<string, unknown>>>;
+export {};
+//# sourceMappingURL=read.d.ts.map

package/dist/adapters/hackernews/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/adapters/hackernews/read.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,MAAM;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,MAAM,CAOR;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAiBlD;AAuBD,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACjD,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAgFzC"}