@botbotgo/kit-builtin 0.0.92

package/dist/src/http/fetchText.js

@@ -0,0 +1,153 @@
+import { getExtensionContext } from "../../index.js";
+import { DEFAULT_TIMEOUT_MS, DEFAULT_MAX_HTTP_BYTES, DEFAULT_HTTP_USER_AGENT, DEFAULT_BLOCKED_CIDRS, } from "./defaults.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { validateUrl } from "../platform/securityCompat.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+function getFetchTextConfig() {
+    const defaults = {
+        timeoutMs: DEFAULT_TIMEOUT_MS,
+        maxBytes: DEFAULT_MAX_HTTP_BYTES,
+        userAgent: DEFAULT_HTTP_USER_AGENT,
+        blockedCidrs: DEFAULT_BLOCKED_CIDRS,
+        allowedHosts: [],
+        blockedHosts: [],
+    };
+    const cfg = overrideWithConfig(defaults, getExtensionContext().config);
+    return {
+        timeoutMs: cfg.timeoutMs ?? defaults.timeoutMs,
+        maxBytes: cfg.maxBytes ?? defaults.maxBytes,
+        userAgent: cfg.userAgent ?? defaults.userAgent,
+        blockedCidrs: Array.isArray(cfg.blockedCidrs) ? cfg.blockedCidrs : defaults.blockedCidrs,
+        allowedHosts: Array.isArray(cfg.allowedHosts) ? cfg.allowedHosts : defaults.allowedHosts,
+        blockedHosts: Array.isArray(cfg.blockedHosts) ? cfg.blockedHosts : defaults.blockedHosts,
+    };
+}
+function parseInput(args) {
+    const url = (args.url ?? args.uri)?.trim();
+    if (!url)
+        throw createTaggedError("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+    return {
+        url,
+        method: args.method ?? "GET",
+        headers: { ...(args.headers ?? {}) },
+        body: args.body ?? undefined,
+        timeoutMs: args.timeoutMs,
+        maxBytes: args.maxBytes,
+    };
+}
+async function fetchTextResponse(args) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs);
+    try {
+        return await fetch(args.url, {
+            method: args.method,
+            headers: args.headers,
+            body: args.body,
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            throw createTaggedError("HTTP_TIMEOUT", `Request to ${args.url} timed out after ${args.timeoutMs}ms`, {
+                url: args.url,
+                timeoutMs: args.timeoutMs,
+            });
+        }
+        throw createTaggedError("UPSTREAM_ERROR", `Fetch failed for ${args.url}: ${err instanceof Error ? err.message : String(err)}`, {
+            url: args.url,
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function readResponseWithLimit(response, maxBytes, url) {
+    if (!response.body)
+        return response.text();
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    const chunks = [];
+    let totalBytes = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            totalBytes += value.byteLength;
+            if (totalBytes > maxBytes) {
+                reader.cancel();
+                throw createTaggedError("HTTP_TOO_LARGE", `Response body exceeded limit of ${maxBytes} bytes while reading from ${url}`, {
+                    url,
+                    bytesRead: totalBytes,
+                    limit: maxBytes,
+                });
+            }
+            chunks.push(decoder.decode(value, { stream: true }));
+        }
+        chunks.push(decoder.decode());
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return chunks.join("");
+}
+function enforceContentLengthLimit(response, maxBytes, url) {
+    const contentLength = response.headers.get("content-length");
+    if (!contentLength)
+        return;
+    if (parseInt(contentLength, 10) <= maxBytes)
+        return;
+    throw createTaggedError("HTTP_TOO_LARGE", `Response Content-Length ${contentLength} exceeds limit of ${maxBytes} bytes`, {
+        url,
+        contentLength: parseInt(contentLength, 10),
+        limit: maxBytes,
+    });
+}
+/**
+ * Fetch text body from HTTP endpoint with SSRF/safety checks and size limits.
+ * @tool
+ * @effect none
+ */
+export async function fetchText(args) {
+    const cfg = getFetchTextConfig();
+    const input = parseInput(args);
+    const timeoutMs = input.timeoutMs ?? cfg.timeoutMs;
+    const maxBytes = input.maxBytes ?? cfg.maxBytes;
+    await validateUrl(input.url, {
+        allowedHosts: cfg.allowedHosts,
+        blockedHosts: cfg.blockedHosts,
+        blockedCidrs: cfg.blockedCidrs,
+    });
+    if (!input.headers["User-Agent"] && !input.headers["user-agent"])
+        input.headers["User-Agent"] = cfg.userAgent;
+    const response = await fetchTextResponse({
+        url: input.url,
+        method: input.method,
+        headers: input.headers,
+        body: input.body,
+        timeoutMs,
+    });
+    enforceContentLengthLimit(response, maxBytes, input.url);
+    const text = await readResponseWithLimit(response, maxBytes, input.url);
+    const bytes = Buffer.byteLength(text, "utf-8");
+    const responseHeaders = {};
+    response.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+    });
+    return {
+        result: {
+            url: input.url,
+            status: response.status,
+            headers: responseHeaders,
+            text,
+            bytes,
+        },
+        evidence: [{
+                type: "url",
+                ref: input.url,
+                summary: `${input.method} ${input.url} → ${response.status} (${bytes} bytes)`,
+                createdAt: new Date().toISOString(),
+            }],
+    };
+}
+//# sourceMappingURL=fetchText.js.map

package/dist/src/http/fetchText.js.map

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

package/dist/src/http/head.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Send an HTTP HEAD request to check URL status and headers without downloading the body.
+ * @tool
+ * @effect none
+ */
+export declare function head(args: {
+    url?: string;
+    /** Alias for url (accepted when agents send "uri" instead of "url"). */
+    uri?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+}): Promise<{
+    result: {
+        url: string;
+        status: number;
+        headers: Record<string, string>;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=head.d.ts.map

package/dist/src/http/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../../src/http/head.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;GAgFA"}

package/dist/src/http/head.js

@@ -0,0 +1,80 @@
+import { getExtensionContext } from "../../index.js";
+import { DEFAULT_TIMEOUT_MS, DEFAULT_HTTP_USER_AGENT, DEFAULT_BLOCKED_CIDRS, } from "./defaults.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { validateUrl } from "../platform/securityCompat.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+/**
+ * Send an HTTP HEAD request to check URL status and headers without downloading the body.
+ * @tool
+ * @effect none
+ */
+export async function head(args) {
+    // Step 1: Defaults, then override with extension config; validate url input.
+    const defaults = {
+        timeoutMs: DEFAULT_TIMEOUT_MS,
+        userAgent: DEFAULT_HTTP_USER_AGENT,
+        blockedCidrs: DEFAULT_BLOCKED_CIDRS,
+        allowedHosts: [],
+        blockedHosts: [],
+    };
+    const ctx = getExtensionContext();
+    const cfg = overrideWithConfig(defaults, ctx.config);
+    const url = (args.url ?? args.uri)?.trim();
+    if (!url) {
+        throw createTaggedError("HTTP_INVALID", "url is required (pass 'url' or 'uri')", {});
+    }
+    const headers = args.headers ?? {};
+    const timeoutMs = args.timeoutMs ?? cfg.timeoutMs ?? defaults.timeoutMs;
+    const blockedCidrs = Array.isArray(cfg.blockedCidrs) ? cfg.blockedCidrs : defaults.blockedCidrs;
+    const userAgent = cfg.userAgent ?? defaults.userAgent;
+    // Step 2: Validate URL and set User-Agent.
+    await validateUrl(url, {
+        allowedHosts: Array.isArray(cfg.allowedHosts) ? cfg.allowedHosts : defaults.allowedHosts,
+        blockedHosts: Array.isArray(cfg.blockedHosts) ? cfg.blockedHosts : defaults.blockedHosts,
+        blockedCidrs,
+    });
+    if (!headers["User-Agent"] && !headers["user-agent"]) {
+        headers["User-Agent"] = userAgent;
+    }
+    // Step 3: Send HEAD request with timeout.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "HEAD",
+            headers,
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            throw createTaggedError("HTTP_TIMEOUT", `HEAD request to ${url} timed out after ${timeoutMs}ms`, { url, timeoutMs });
+        }
+        throw createTaggedError("UPSTREAM_ERROR", `HEAD request failed for ${url}: ${err instanceof Error ? err.message : String(err)}`, { url });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const responseHeaders = {};
+    response.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+    });
+    // Step 4: Return headers and evidence.
+    return {
+        result: {
+            url,
+            status: response.status,
+            headers: responseHeaders,
+        },
+        evidence: [
+            {
+                type: "url",
+                ref: url,
+                summary: `HEAD ${url} → ${response.status}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=head.js.map

package/dist/src/http/head.js.map

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

package/dist/src/http/yahooFinance.d.ts

@@ -0,0 +1,39 @@
+export interface YahooQuoteItem {
+    symbol: string;
+    currency?: string;
+    price?: number;
+    previousClose?: number;
+    change?: number;
+    changePercent?: number;
+    open?: number;
+    high?: number;
+    low?: number;
+    volume?: number;
+    timestamp?: number;
+}
+/**
+ * Fetch quote snapshots from Yahoo Finance chart API.
+ * @tool
+ * @effect none
+ */
+export declare function yahooFinanceQuote(args: {
+    symbols?: string[];
+    symbol?: string;
+    tickers?: string;
+    range?: "1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "max";
+    timeoutMs?: number;
+    maxBytes?: number;
+}): Promise<{
+    result: {
+        symbols: string[];
+        quotes: YahooQuoteItem[];
+        range: "1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "max";
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=yahooFinance.d.ts.map

package/dist/src/http/yahooFinance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yahooFinance.d.ts","sourceRoot":"","sources":["../../../src/http/yahooFinance.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2ID;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;GAoCA"}

package/dist/src/http/yahooFinance.js

@@ -0,0 +1,160 @@
+import { getExtensionContext } from "../../index.js";
+import { DEFAULT_TIMEOUT_MS, DEFAULT_MAX_HTTP_BYTES, DEFAULT_HTTP_USER_AGENT, DEFAULT_BLOCKED_CIDRS, } from "./defaults.js";
+import { createTaggedError } from "@botbotgo/kit/sdk";
+import { validateUrl } from "../platform/securityCompat.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+const YAHOO_CHART_BASE = "https://query1.finance.yahoo.com/v8/finance/chart/";
+function getYahooConfig() {
+    const defaults = {
+        timeoutMs: DEFAULT_TIMEOUT_MS,
+        maxBytes: DEFAULT_MAX_HTTP_BYTES,
+        userAgent: DEFAULT_HTTP_USER_AGENT,
+        blockedCidrs: DEFAULT_BLOCKED_CIDRS,
+        allowedHosts: [],
+        blockedHosts: [],
+    };
+    const cfg = overrideWithConfig(defaults, getExtensionContext().config);
+    return {
+        timeoutMs: cfg.timeoutMs ?? defaults.timeoutMs,
+        maxBytes: cfg.maxBytes ?? defaults.maxBytes,
+        userAgent: cfg.userAgent ?? defaults.userAgent,
+        blockedCidrs: Array.isArray(cfg.blockedCidrs) ? cfg.blockedCidrs : defaults.blockedCidrs,
+        allowedHosts: Array.isArray(cfg.allowedHosts) ? cfg.allowedHosts : defaults.allowedHosts,
+        blockedHosts: Array.isArray(cfg.blockedHosts) ? cfg.blockedHosts : defaults.blockedHosts,
+    };
+}
+function normalizeSymbols(args) {
+    const fromSymbols = Array.isArray(args.symbols) ? args.symbols : [];
+    const fromSymbol = typeof args.symbol === "string" ? [args.symbol] : [];
+    const fromTickers = typeof args.tickers === "string" ? args.tickers.split(",") : [];
+    const symbols = [...fromSymbols, ...fromSymbol, ...fromTickers]
+        .map((value) => String(value).trim().toUpperCase())
+        .filter(Boolean);
+    if (!symbols.length)
+        throw createTaggedError("YAHOO_INVALID", "At least one symbol is required", {});
+    return symbols;
+}
+async function fetchYahooChartJson(args) {
+    const url = `${YAHOO_CHART_BASE}${encodeURIComponent(args.symbol)}?interval=1d&range=${args.range}`;
+    await validateUrl(url, {
+        allowedHosts: args.allowedHosts,
+        blockedHosts: args.blockedHosts,
+        blockedCidrs: args.blockedCidrs,
+    });
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), args.timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "GET",
+            headers: { "User-Agent": args.userAgent, Accept: "application/json" },
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === "AbortError") {
+            throw createTaggedError("HTTP_TIMEOUT", `Yahoo Finance request for ${args.symbol} timed out after ${args.timeoutMs}ms`, {
+                symbol: args.symbol,
+                timeoutMs: args.timeoutMs,
+            });
+        }
+        throw createTaggedError("UPSTREAM_ERROR", `Yahoo Finance request failed: ${err instanceof Error ? err.message : String(err)}`, {
+            symbol: args.symbol,
+        });
+    }
+    clearTimeout(timer);
+    const text = await response.text();
+    const bytes = Buffer.byteLength(text, "utf-8");
+    if (bytes > args.maxBytes) {
+        throw createTaggedError("HTTP_TOO_LARGE", `Yahoo Finance response ${bytes} bytes exceeds limit of ${args.maxBytes} bytes`, {
+            symbol: args.symbol,
+            bytes,
+            limit: args.maxBytes,
+        });
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw createTaggedError("UPSTREAM_ERROR", "Yahoo Finance returned invalid JSON", {
+            symbol: args.symbol,
+            textPreview: text.slice(0, 200),
+        });
+    }
+}
+function toQuote(symbol, response) {
+    const error = response.chart?.error;
+    if (error?.description) {
+        throw createTaggedError("YAHOO_ERROR", `Yahoo Finance error for ${symbol}: ${error.description}`, {
+            symbol,
+            code: error.code,
+        });
+    }
+    const result = response.chart?.result?.[0];
+    if (!result)
+        return { symbol };
+    const meta = result.meta ?? {};
+    const quoteArr = result.indicators?.quote?.[0];
+    const lastIdx = (result.timestamp?.length ?? 1) - 1;
+    const price = meta.regularMarketPrice ?? meta.previousClose ?? quoteArr?.close?.[lastIdx] ?? undefined;
+    const previousClose = meta.previousClose ?? meta.chartPreviousClose ?? quoteArr?.close?.[Math.max(0, lastIdx - 1)] ?? undefined;
+    const change = price != null && previousClose != null ? price - previousClose : undefined;
+    const changePercent = change != null && previousClose != null && previousClose !== 0
+        ? (change / previousClose) * 100
+        : undefined;
+    return {
+        symbol: meta.symbol ?? symbol,
+        currency: meta.currency,
+        price: price ?? undefined,
+        previousClose: previousClose ?? undefined,
+        change,
+        changePercent,
+        open: quoteArr?.open?.[lastIdx] ?? undefined,
+        high: quoteArr?.high?.[lastIdx] ?? undefined,
+        low: quoteArr?.low?.[lastIdx] ?? undefined,
+        volume: quoteArr?.volume?.[lastIdx] ?? undefined,
+        timestamp: result.timestamp?.[lastIdx],
+    };
+}
+/**
+ * Fetch quote snapshots from Yahoo Finance chart API.
+ * @tool
+ * @effect none
+ */
+export async function yahooFinanceQuote(args) {
+    const cfg = getYahooConfig();
+    const symbols = normalizeSymbols(args);
+    const range = args.range ?? "1d";
+    const timeoutMs = args.timeoutMs ?? cfg.timeoutMs;
+    const maxBytes = args.maxBytes ?? cfg.maxBytes;
+    const quotes = [];
+    for (const symbol of symbols) {
+        const data = await fetchYahooChartJson({
+            symbol,
+            range,
+            timeoutMs,
+            maxBytes,
+            userAgent: cfg.userAgent,
+            allowedHosts: cfg.allowedHosts,
+            blockedHosts: cfg.blockedHosts,
+            blockedCidrs: cfg.blockedCidrs,
+        });
+        quotes.push(toQuote(symbol, data));
+    }
+    const firstUrl = `${YAHOO_CHART_BASE}${encodeURIComponent(symbols[0])}?interval=1d&range=${range}`;
+    return {
+        result: {
+            symbols: quotes.map((q) => q.symbol),
+            quotes,
+            range,
+        },
+        evidence: [{
+                type: "url",
+                ref: firstUrl,
+                summary: `Yahoo Finance quote: ${symbols.join(", ")} (${quotes.length} result(s))`,
+                createdAt: new Date().toISOString(),
+            }],
+    };
+}
+//# sourceMappingURL=yahooFinance.js.map

package/dist/src/http/yahooFinance.js.map

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

package/dist/src/iterm/common.d.ts

@@ -0,0 +1,51 @@
+import { createTaggedError } from "@botbotgo/kit/sdk";
+export declare const RECORD_SEPARATOR = "\u001E";
+export declare const FIELD_SEPARATOR = "\u001F";
+export declare function quoteAppleScriptString(input: string): string;
+export declare function runOsaScript(lines: string[]): Promise<string>;
+export declare function targetSelectorScript(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+}): string[];
+export declare function applyOptionalNamingScript(args: {
+    windowName?: string;
+    tabName?: string;
+    sessionName?: string;
+    windowRef?: string;
+    tabRef?: string;
+    sessionRef?: string;
+}): string[];
+export declare function parsePipeTuple(output: string): {
+    windowId: number;
+    tabIndex: number;
+    sessionId: string;
+    sessionUniqueId: string;
+};
+export declare function returnTupleScript(args: {
+    windowRef?: string;
+    tabRef?: string;
+    sessionRef?: string;
+}): string[];
+export declare function normalizeRgb(args: {
+    hex?: string;
+    red?: number;
+    green?: number;
+    blue?: number;
+    alpha?: number;
+}): {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+};
+/**
+ * Read the visible buffer contents of an iTerm session via AppleScript.
+ */
+export declare function readSessionContents(args: {
+    windowId?: number;
+    tabIndex?: number;
+    sessionId?: string;
+}): Promise<string>;
+export { createTaggedError };
+//# sourceMappingURL=common.d.ts.map

package/dist/src/iterm/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/iterm/common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,gBAAgB,WAAS,CAAC;AACvC,eAAO,MAAM,eAAe,WAAS,CAAC;AAEtC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA+CnE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,EAAE,CAsEX;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,EAAE,CA8BX;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,EAAE,CAoCX;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyB9D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}