@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/host-modules/xlsx.js

@@ -0,0 +1,323 @@
+/**
+ * `@nodetool-ai/sandbox-xlsx` — exceljs, on the host.
+ *
+ * exceljs is built on Node streams and ships its own zip layer; it is not a
+ * guest-module candidate and never will be. It runs here, and the guest gets
+ * records back, or hands records over and gets workbook bytes.
+ */
+import { optionsOf, requireBytes, unwrapLibrary } from "./limits.js";
+import { isFunction, isObjectLike, isString } from "../utils/type-guards.js";
+/** Sheets one `write` call may produce. */
+export const MAX_WRITE_SHEETS = 64;
+/** Cells one `write` call may produce, across every sheet. */
+export const MAX_WRITE_CELLS = 250_000;
+async function loadExcelJs(where) {
+    const mod = await import("exceljs");
+    return unwrapLibrary(mod, where, "exceljs", (v) => isFunction(v?.Workbook));
+}
+/**
+ * Excel workbook bytes to records per sheet; pass `sheet` to get one sheet's
+ * rows directly. Formula cells yield their computed result.
+ */
+export async function parse(bytes, options) {
+    const where = "xlsx.parse";
+    const workbookBytes = requireBytes(where, bytes);
+    const opts = optionsOf(options);
+    const header = opts.header === undefined ? true : Boolean(opts.header);
+    const wantedSheet = opts.sheet === undefined || opts.sheet === null ? undefined : String(opts.sheet);
+    const excel = await loadExcelJs(where);
+    const workbook = new excel.Workbook();
+    const copy = new Uint8Array(workbookBytes);
+    await workbook.xlsx.load(copy.buffer);
+    const cellValue = (cell) => {
+        const v = cell.value;
+        if (v === null || v === undefined)
+            return null;
+        if (v instanceof Date)
+            return v.toISOString();
+        if (typeof v === "object") {
+            const rec = v;
+            // exceljs rich values: formulas carry `result`, rich text `richText`,
+            // hyperlinks `text`.
+            if (rec.result !== undefined)
+                return rec.result;
+            if (isString(rec.text))
+                return rec.text;
+            if (Array.isArray(rec.richText)) {
+                return rec.richText
+                    .map((part) => String(part.text ?? ""))
+                    .join("");
+            }
+            return String(v);
+        }
+        return v;
+    };
+    const sheetRows = (sheet) => {
+        const raw = [];
+        sheet.eachRow({ includeEmpty: false }, (row) => {
+            const cells = [];
+            row.eachCell({ includeEmpty: true }, (cell, col) => {
+                cells[col - 1] = cellValue(cell);
+            });
+            raw.push(cells);
+        });
+        if (!header)
+            return raw;
+        const [head, ...rest] = raw;
+        if (!head)
+            return [];
+        const keys = head.map((h, i) => (h === null ? `col_${i + 1}` : String(h)));
+        return rest.map((cells) => {
+            const record = {};
+            keys.forEach((key, i) => {
+                record[key] = cells[i] ?? null;
+            });
+            return record;
+        });
+    };
+    const sheets = {};
+    workbook.eachSheet((sheet) => {
+        sheets[sheet.name] = sheetRows(sheet);
+    });
+    if (wantedSheet !== undefined) {
+        const match = sheets[wantedSheet];
+        if (match === undefined) {
+            throw new Error(`${where}: no sheet named "${wantedSheet}". Sheets: ${Object.keys(sheets).join(", ")}`);
+        }
+        return match;
+    }
+    return sheets;
+}
+/** `A1` / `B10` to a 1-based column number. Anything else is a caller error. */
+function columnNumber(where, letters) {
+    if (!/^[A-Za-z]+$/.test(letters)) {
+        throw new Error(`${where}: "${letters}" is not a column reference`);
+    }
+    let result = 0;
+    for (const ch of letters.toUpperCase()) {
+        result = result * 26 + (ch.charCodeAt(0) - 64);
+    }
+    return result;
+}
+/** `A1`, `A1:C20` — a rectangle in 1-based row/column numbers. */
+function parseRange(where, range) {
+    if (!isString(range) || !range.trim()) {
+        throw new Error(`${where}: a style needs a range like "A1:C20"`);
+    }
+    const cells = range.split(":");
+    if (cells.length > 2) {
+        throw new Error(`${where}: "${range}" is not a cell range`);
+    }
+    const corner = (cell) => {
+        const match = /^([A-Za-z]+)([0-9]+)$/.exec(cell.trim());
+        if (match === null) {
+            throw new Error(`${where}: "${range}" is not a cell range`);
+        }
+        return { row: Number(match[2]), col: columnNumber(where, match[1]) };
+    };
+    const start = corner(cells[0]);
+    const end = cells.length === 2 ? corner(cells[1]) : start;
+    return {
+        top: Math.min(start.row, end.row),
+        left: Math.min(start.col, end.col),
+        bottom: Math.max(start.row, end.row),
+        right: Math.max(start.col, end.col)
+    };
+}
+/** `FFCC00` or `#FFCC00` to exceljs's ARGB. */
+function argb(where, value, label) {
+    const text = String(value).trim().replace(/^#/, "");
+    if (!/^([0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(text)) {
+        throw new Error(`${where}: ${label} must be a hex colour like "FFCC00"`);
+    }
+    return (text.length === 6 ? `FF${text}` : text).toUpperCase();
+}
+function asRecordArray(where, value, label) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value)) {
+        throw new Error(`${where}: ${label} must be an array`);
+    }
+    return value.map((entry) => {
+        if (!isObjectLike(entry) || Array.isArray(entry)) {
+            throw new Error(`${where}: every ${label} entry must be an object`);
+        }
+        return entry;
+    });
+}
+/** The sheet list, from either accepted shape, with per-sheet options resolved. */
+function readSheetSpecs(where, sheets, options) {
+    const defaultHeader = options.header === undefined ? true : Boolean(options.header);
+    const entries = [];
+    if (Array.isArray(sheets)) {
+        for (const [index, entry] of sheets.entries()) {
+            if (!isObjectLike(entry) || Array.isArray(entry)) {
+                throw new Error(`${where}: sheet ${index} must be an object with a name`);
+            }
+            const sheet = entry;
+            const name = String(sheet.name ?? "").trim();
+            if (!name)
+                throw new Error(`${where}: sheet ${index} has no name`);
+            entries.push([name, sheet]);
+        }
+    }
+    else if (isObjectLike(sheets)) {
+        for (const [name, rows] of Object.entries(sheets)) {
+            if (!Array.isArray(rows)) {
+                throw new Error(`${where}: sheet "${name}" must hold an array of rows`);
+            }
+            entries.push([name, rows]);
+        }
+    }
+    else {
+        throw new Error(`${where}: sheets must be {name: rows} or [{name, rows}], not ${typeof sheets}`);
+    }
+    if (entries.length === 0) {
+        throw new Error(`${where}: a workbook needs at least one sheet`);
+    }
+    if (entries.length > MAX_WRITE_SHEETS) {
+        throw new Error(`${where}: ${entries.length} sheets exceeds the ${MAX_WRITE_SHEETS} sheet limit`);
+    }
+    const seen = new Set();
+    return entries.map(([name, source]) => {
+        if (seen.has(name))
+            throw new Error(`${where}: duplicate sheet name "${name}"`);
+        seen.add(name);
+        const sheet = Array.isArray(source)
+            ? { rows: source }
+            : source;
+        const rows = sheet.rows;
+        if (!Array.isArray(rows)) {
+            throw new Error(`${where}: sheet "${name}" must hold an array of rows`);
+        }
+        const columns = sheet.columns;
+        if (columns !== undefined && !Array.isArray(columns)) {
+            throw new Error(`${where}: sheet "${name}" columns must be an array of names`);
+        }
+        return {
+            name,
+            rows,
+            header: sheet.header === undefined ? defaultHeader : Boolean(sheet.header),
+            columns: columns === undefined
+                ? undefined
+                : columns.map((column) => String(column)),
+            styles: asRecordArray(where, sheet.styles, `sheet "${name}" styles`)
+        };
+    });
+}
+/** What exceljs should store for one guest value. */
+function writeValue(value) {
+    if (value === undefined)
+        return null;
+    if (!isObjectLike(value))
+        return value;
+    if (value instanceof Uint8Array) {
+        throw new Error("xlsx.write: a cell cannot hold bytes");
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Records to workbook bytes.
+ *
+ * `sheets` is either `{"Costs": [...]}` or `[{name, rows, header, columns,
+ * styles}]`. Rows are records by default, keyed by the union of their keys in
+ * first-seen order; `header: false` takes arrays of cells instead. Column
+ * widths are fitted to the content unless `autoFitColumns: false`.
+ */
+export async function write(sheets, options) {
+    const where = "xlsx.write";
+    const opts = optionsOf(options);
+    const specs = readSheetSpecs(where, sheets, opts);
+    const autoFit = opts.autoFitColumns === undefined ? true : Boolean(opts.autoFitColumns);
+    const excel = await loadExcelJs(where);
+    const workbook = new excel.Workbook();
+    let cellBudget = MAX_WRITE_CELLS;
+    const spend = (cells) => {
+        cellBudget -= cells;
+        if (cellBudget < 0) {
+            throw new Error(`${where}: the workbook exceeds the ${MAX_WRITE_CELLS} cell limit`);
+        }
+    };
+    for (const spec of specs) {
+        const sheet = workbook.addWorksheet(spec.name);
+        const widths = [];
+        const put = (row, col, value) => {
+            sheet.getCell(row, col).value = writeValue(value);
+            const length = value === null || value === undefined ? 0 : String(value).length;
+            widths[col - 1] = Math.max(widths[col - 1] ?? 0, length);
+        };
+        if (spec.header) {
+            const keys = spec.columns ? [...spec.columns] : [];
+            if (keys.length === 0) {
+                for (const row of spec.rows) {
+                    if (!isObjectLike(row) || Array.isArray(row)) {
+                        throw new Error(`${where}: sheet "${spec.name}" rows must be objects (pass header: false for arrays)`);
+                    }
+                    for (const key of Object.keys(row)) {
+                        if (!keys.includes(key))
+                            keys.push(key);
+                    }
+                }
+            }
+            spend((spec.rows.length + 1) * Math.max(keys.length, 1));
+            keys.forEach((key, index) => put(1, index + 1, key));
+            spec.rows.forEach((row, index) => {
+                const record = (row ?? {});
+                keys.forEach((key, col) => put(index + 2, col + 1, record[key] ?? null));
+            });
+        }
+        else {
+            let widest = 0;
+            for (const row of spec.rows) {
+                if (!Array.isArray(row)) {
+                    throw new Error(`${where}: sheet "${spec.name}" rows must be arrays when header is false`);
+                }
+                widest = Math.max(widest, row.length);
+            }
+            spend(spec.rows.length * Math.max(widest, 1));
+            spec.rows.forEach((row, index) => {
+                row.forEach((cell, col) => put(index + 1, col + 1, cell));
+            });
+        }
+        for (const style of spec.styles) {
+            const range = parseRange(where, style.range);
+            const font = {};
+            if (style.bold !== undefined)
+                font.bold = Boolean(style.bold);
+            if (style.italic !== undefined)
+                font.italic = Boolean(style.italic);
+            if (style.size !== undefined)
+                font.size = Number(style.size);
+            if (style.color !== undefined) {
+                font.color = { argb: argb(where, style.color, "color") };
+            }
+            const fill = style.background === undefined
+                ? undefined
+                : {
+                    type: "pattern",
+                    pattern: "solid",
+                    fgColor: { argb: argb(where, style.background, "background") }
+                };
+            for (let row = range.top; row <= range.bottom; row++) {
+                for (let col = range.left; col <= range.right; col++) {
+                    const cell = sheet.getCell(row, col);
+                    if (Object.keys(font).length > 0)
+                        cell.font = { ...cell.font, ...font };
+                    if (fill !== undefined)
+                        cell.fill = fill;
+                    if (style.numberFormat !== undefined) {
+                        cell.numFmt = String(style.numberFormat);
+                    }
+                }
+            }
+        }
+        if (autoFit) {
+            widths.forEach((width, index) => {
+                sheet.getColumn(index + 1).width = Math.min(Math.max(width + 2, 8), 80);
+            });
+        }
+    }
+    const buffer = await workbook.xlsx.writeBuffer();
+    return buffer instanceof Uint8Array ? new Uint8Array(buffer) : new Uint8Array(buffer);
+}
+//# sourceMappingURL=xlsx.js.map

package/dist/host-modules/xlsx.js.map

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

package/dist/host-modules/xml.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `@nodetool-ai/sandbox-xml` — fast-xml-parser, on the host.
+ *
+ * The library reads a bare `window`, which the guest does not have, so the
+ * compiler refuses it as a guest module. It runs here instead.
+ */
+/**
+ * A parsed XML document. Elements become objects, repeated elements become
+ * arrays, and every leaf is a string — the parser is constructed below with
+ * `parseTagValue`/`parseAttributeValue` off, so nothing is coerced to a number.
+ */
+export type XmlValue = string | XmlValue[] | {
+    [key: string]: XmlValue;
+};
+/**
+ * XML (RSS/Atom feeds, sitemaps) as a plain object.
+ *
+ * Attributes ride along prefixed `@_` so they never collide with child-element
+ * keys, and text values stay text — a numeric-looking id must not change shape.
+ * Invalid XML throws with the parser's own reason.
+ */
+export declare function parse(text: unknown, options?: unknown): Promise<XmlValue>;
+//# sourceMappingURL=xml.d.ts.map

package/dist/host-modules/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/host-modules/xml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC;AAiBzE;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiB/E"}

package/dist/host-modules/xml.js

@@ -0,0 +1,38 @@
+/**
+ * `@nodetool-ai/sandbox-xml` — fast-xml-parser, on the host.
+ *
+ * The library reads a bare `window`, which the guest does not have, so the
+ * compiler refuses it as a guest module. It runs here instead.
+ */
+import { optionsOf, requireText, unwrapLibrary } from "./limits.js";
+import { isFunction } from "../utils/type-guards.js";
+async function loadFastXmlParser(where) {
+    const mod = await import("fast-xml-parser");
+    return unwrapLibrary(mod, where, "fast-xml-parser", (v) => isFunction(v?.XMLParser));
+}
+/**
+ * XML (RSS/Atom feeds, sitemaps) as a plain object.
+ *
+ * Attributes ride along prefixed `@_` so they never collide with child-element
+ * keys, and text values stay text — a numeric-looking id must not change shape.
+ * Invalid XML throws with the parser's own reason.
+ */
+export async function parse(text, options) {
+    const where = "xml.parse";
+    const source = requireText(where, text);
+    const opts = optionsOf(options);
+    const fxp = await loadFastXmlParser(where);
+    const valid = fxp.XMLValidator.validate(source);
+    if (valid !== true) {
+        throw new Error(`${where}: invalid XML (${valid.err.msg})`);
+    }
+    const parser = new fxp.XMLParser({
+        ignoreAttributes: opts.attributes === false,
+        attributeNamePrefix: "@_",
+        parseTagValue: false,
+        parseAttributeValue: false,
+        trimValues: true
+    });
+    return parser.parse(source);
+}
+//# sourceMappingURL=xml.js.map

package/dist/host-modules/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/host-modules/xml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAcrD,KAAK,UAAU,iBAAiB,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACrD,OAAO,aAAa,CAClB,GAAG,EACH,KAAK,EACL,iBAAiB,EACjB,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAE,CAAyB,EAAE,SAAS,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAa,EAAE,OAAiB;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,kBAAkB,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC;QAC/B,gBAAgB,EAAE,IAAI,CAAC,UAAU,KAAK,KAAK;QAC3C,mBAAmB,EAAE,IAAI;QACzB,aAAa,EAAE,KAAK;QACpB,mBAAmB,EAAE,KAAK;QAC1B,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/host-modules/zip.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@nodetool-ai/sandbox-zip` — fflate, on the host.
+ *
+ * fflate is pure JavaScript and the M3 compiler admits it, so this pack *could*
+ * have shipped as a guest module. It does not, and the reason is the cap below:
+ * a zip bomb is a policy question, and a policy enforced inside the guest is
+ * enforced by code the guest could simply not call. The guest's own 64 MB heap
+ * does not replicate it — fflate inflates into host memory first. So the
+ * library stays on the host, where {@link MAX_UNZIP_TOTAL_BYTES} sits between
+ * the archive and the guest with nothing around it.
+ */
+/** Total uncompressed size `unzip` will inflate before refusing. */
+export declare const MAX_UNZIP_TOTAL_BYTES: number;
+/**
+ * Extract a zip archive to a map of entry path to content bytes.
+ *
+ * Refuses an archive whose entries inflate past
+ * {@link MAX_UNZIP_TOTAL_BYTES} — checked as the entries are walked, so a bomb
+ * is stopped part way rather than after it has been materialized.
+ */
+export declare function unzip(bytes: unknown): Promise<Record<string, unknown>>;
+/** Build a zip archive from named entries; string values are UTF-8 encoded. */
+export declare function zip(files: unknown): Promise<Record<string, string>>;
+//# sourceMappingURL=zip.d.ts.map

package/dist/host-modules/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../src/host-modules/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAiBtD;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiB5E;AAED,+EAA+E;AAC/E,wBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA6BzE"}

package/dist/host-modules/zip.js

@@ -0,0 +1,70 @@
+/**
+ * `@nodetool-ai/sandbox-zip` — fflate, on the host.
+ *
+ * fflate is pure JavaScript and the M3 compiler admits it, so this pack *could*
+ * have shipped as a guest module. It does not, and the reason is the cap below:
+ * a zip bomb is a policy question, and a policy enforced inside the guest is
+ * enforced by code the guest could simply not call. The guest's own 64 MB heap
+ * does not replicate it — fflate inflates into host memory first. So the
+ * library stays on the host, where {@link MAX_UNZIP_TOTAL_BYTES} sits between
+ * the archive and the guest with nothing around it.
+ */
+import { toGuestBytes } from "../sandbox-bytes.js";
+import { requireBytes, unwrapLibrary } from "./limits.js";
+import { isFunction, isObjectLike, isString } from "../utils/type-guards.js";
+/** Total uncompressed size `unzip` will inflate before refusing. */
+export const MAX_UNZIP_TOTAL_BYTES = 50 * 1024 * 1024;
+async function loadFflate(where) {
+    const mod = await import("fflate");
+    return unwrapLibrary(mod, where, "fflate", (v) => isFunction(v?.unzipSync));
+}
+/**
+ * Extract a zip archive to a map of entry path to content bytes.
+ *
+ * Refuses an archive whose entries inflate past
+ * {@link MAX_UNZIP_TOTAL_BYTES} — checked as the entries are walked, so a bomb
+ * is stopped part way rather than after it has been materialized.
+ */
+export async function unzip(bytes) {
+    const where = "zip.unzip";
+    const archive = requireBytes(where, bytes);
+    const fflate = await loadFflate(where);
+    const entries = fflate.unzipSync(archive);
+    let total = 0;
+    const out = {};
+    for (const [name, content] of Object.entries(entries)) {
+        total += content.length;
+        if (total > MAX_UNZIP_TOTAL_BYTES) {
+            throw new Error(`${where}: archive inflates past the ${MAX_UNZIP_TOTAL_BYTES} byte limit`);
+        }
+        out[name] = toGuestBytes(content);
+    }
+    return out;
+}
+/** Build a zip archive from named entries; string values are UTF-8 encoded. */
+export async function zip(files) {
+    const where = "zip.zip";
+    if (!isObjectLike(files) || Array.isArray(files)) {
+        throw new Error(`${where}: files must be an object mapping names to Uint8Array or string content`);
+    }
+    const fflate = await loadFflate(where);
+    const input = {};
+    let total = 0;
+    for (const [name, content] of Object.entries(files)) {
+        const bytes = content instanceof Uint8Array
+            ? content
+            : isString(content)
+                ? new TextEncoder().encode(content)
+                : null;
+        if (bytes === null) {
+            throw new Error(`${where}: entry "${name}" must be a Uint8Array or string`);
+        }
+        total += bytes.length;
+        if (total > MAX_UNZIP_TOTAL_BYTES) {
+            throw new Error(`${where}: entries exceed the ${MAX_UNZIP_TOTAL_BYTES} byte limit`);
+        }
+        input[name] = bytes;
+    }
+    return toGuestBytes(fflate.zipSync(input));
+}
+//# sourceMappingURL=zip.js.map

package/dist/host-modules/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../src/host-modules/zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,YAAY,EACZ,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAEjC,oEAAoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAOtD,KAAK,UAAU,UAAU,CAAC,KAAa;IACrC,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,aAAa,CAClB,GAAG,EACH,KAAK,EACL,QAAQ,EACR,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAE,CAA4B,EAAE,SAAS,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAc;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QACxB,IAAI,KAAK,GAAG,qBAAqB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,+BAA+B,qBAAqB,aAAa,CAC1E,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAc;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,yEAAyE,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GACT,OAAO,YAAY,UAAU;YAC3B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACjB,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;gBACnC,CAAC,CAAC,IAAI,CAAC;QACb,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,IAAI,kCAAkC,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;QACtB,IAAI,KAAK,GAAG,qBAAqB,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,wBAAwB,qBAAqB,aAAa,CACnE,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}