@solarisdk/e2b-compat 0.0.0-stage → 0.1.0

package/dist/code-interpreter.js

@@ -0,0 +1,357 @@
+// `@e2b/code-interpreter` on Solari: `Sandbox` with runCode and code contexts. Python runs in Solari's persistent
+// kernel (rich results, structured charts). `bash` runs as a one-shot command. Other languages throw (the guest
+// ships a Python kernel only). The default template, `code-interpreter-v1`, is built into your org on first use.
+import { Image, TemplateClient } from "@solarisdk/core";
+import { resolveConn } from "./config.js";
+import { CommandExitError, InvalidArgumentError, SandboxError, SolariCompatUnsupported, TimeoutError, translateError } from "./errors.js";
+import { Sandbox as BaseSandbox } from "./sandbox.js";
+import { resolveTemplateId } from "./template.js";
+// --- result types (shapes follow @e2b/code-interpreter) ---------------------------------------------------------
+export var ChartType;
+(function (ChartType) {
+    ChartType["LINE"] = "line";
+    ChartType["SCATTER"] = "scatter";
+    ChartType["BAR"] = "bar";
+    ChartType["PIE"] = "pie";
+    ChartType["BOX_AND_WHISKER"] = "box_and_whisker";
+    ChartType["SUPERCHART"] = "superchart";
+    ChartType["UNKNOWN"] = "unknown";
+})(ChartType || (ChartType = {}));
+export var ScaleType;
+(function (ScaleType) {
+    ScaleType["LINEAR"] = "linear";
+    ScaleType["DATETIME"] = "datetime";
+    ScaleType["CATEGORICAL"] = "categorical";
+    ScaleType["LOG"] = "log";
+    ScaleType["SYMLOG"] = "symlog";
+    ScaleType["LOGIT"] = "logit";
+    ScaleType["FUNCTION"] = "function";
+    ScaleType["FUNCTIONLOG"] = "functionlog";
+    ScaleType["ASINH"] = "asinh";
+})(ScaleType || (ScaleType = {}));
+export class OutputMessage {
+    line;
+    timestamp;
+    error;
+    constructor(line, timestamp, error) {
+        this.line = line;
+        this.timestamp = timestamp;
+        this.error = error;
+    }
+    toString() {
+        return this.line;
+    }
+}
+export class ExecutionError {
+    name;
+    value;
+    traceback;
+    constructor(name, value, traceback) {
+        this.name = name;
+        this.value = value;
+        this.traceback = traceback;
+    }
+}
+export class Result {
+    raw;
+    isMainResult;
+    text;
+    html;
+    markdown;
+    svg;
+    png;
+    jpeg;
+    pdf;
+    latex;
+    json;
+    javascript;
+    data;
+    chart;
+    extra;
+    constructor(raw, isMainResult) {
+        this.raw = raw;
+        this.isMainResult = isMainResult;
+        const known = new Set(["text/plain", "text/html", "text/markdown", "image/svg+xml", "image/png", "image/jpeg", "application/pdf", "text/latex", "application/json", "application/javascript", "data", "chart", "extra"]);
+        this.text = raw["text/plain"];
+        this.html = raw["text/html"];
+        this.markdown = raw["text/markdown"];
+        this.svg = raw["image/svg+xml"];
+        this.png = raw["image/png"];
+        this.jpeg = raw["image/jpeg"];
+        this.pdf = raw["application/pdf"];
+        this.latex = raw["text/latex"];
+        this.json = raw["application/json"];
+        this.javascript = raw["application/javascript"];
+        this.data = raw.data;
+        this.chart = raw.chart;
+        const extra = Object.fromEntries(Object.entries(raw).filter(([k]) => !known.has(k)));
+        this.extra = raw.extra ?? (Object.keys(extra).length ? extra : undefined);
+    }
+    formats() {
+        const f = [];
+        for (const [k, v] of [["text", this.text], ["html", this.html], ["markdown", this.markdown], ["svg", this.svg], ["png", this.png], ["jpeg", this.jpeg], ["pdf", this.pdf], ["latex", this.latex], ["json", this.json], ["javascript", this.javascript], ["data", this.data], ["chart", this.chart]]) {
+            if (v !== undefined)
+                f.push(k);
+        }
+        return f;
+    }
+    toJSON() {
+        return {
+            ...(this.extra !== undefined ? { extra: this.extra } : {}),
+            text: this.text,
+            html: this.html,
+            markdown: this.markdown,
+            svg: this.svg,
+            png: this.png,
+            jpeg: this.jpeg,
+            pdf: this.pdf,
+            latex: this.latex,
+            json: this.json,
+            javascript: this.javascript,
+        };
+    }
+}
+export class Execution {
+    results;
+    logs;
+    error;
+    executionCount;
+    constructor(results = [], logs = { stdout: [], stderr: [] }, error, executionCount) {
+        this.results = results;
+        this.logs = logs;
+        this.error = error;
+        this.executionCount = executionCount;
+    }
+    get text() {
+        return this.results.find((r) => r.isMainResult)?.text;
+    }
+    toJSON() {
+        return { results: this.results, logs: this.logs, error: this.error };
+    }
+}
+// --- mapping from Solari results ------------------------------------------------------------------------------------
+function mapChart(c) {
+    const type = c.type === "composite" ? ChartType.SUPERCHART : Object.values(ChartType).includes(c.type) ? c.type : ChartType.UNKNOWN;
+    const out = { type, title: c.title ?? "", elements: c.elements ?? [] };
+    if (c.xLabel !== undefined)
+        out.x_label = c.xLabel;
+    if (c.yLabel !== undefined)
+        out.y_label = c.yLabel;
+    if (c.x) {
+        out.x_ticks = c.x.ticks ?? [];
+        out.x_scale = c.x.scale ?? ScaleType.LINEAR;
+        out.x_tick_labels = (c.x.ticks ?? []).map(String);
+    }
+    if (c.y) {
+        out.y_ticks = c.y.ticks ?? [];
+        out.y_scale = c.y.scale ?? ScaleType.LINEAR;
+        out.y_tick_labels = (c.y.ticks ?? []).map(String);
+    }
+    return out;
+}
+function toResult(item, isMain) {
+    const raw = {};
+    if (item.text !== undefined)
+        raw["text/plain"] = item.text;
+    if (item.html !== undefined)
+        raw["text/html"] = item.html;
+    if (item.markdown !== undefined)
+        raw["text/markdown"] = item.markdown;
+    if (item.svg !== undefined)
+        raw["image/svg+xml"] = item.svg;
+    if (item.png !== undefined)
+        raw["image/png"] = item.png;
+    if (item.jpeg !== undefined)
+        raw["image/jpeg"] = item.jpeg;
+    if (item.latex !== undefined)
+        raw["text/latex"] = item.latex;
+    if (item.json !== undefined)
+        raw["application/json"] = typeof item.json === "string" ? item.json : JSON.stringify(item.json);
+    if (item.chart)
+        raw.chart = mapChart(item.chart);
+    return new Result(raw, isMain);
+}
+function toExecutionError(err) {
+    if (typeof err === "string") {
+        const lines = err.trim().split("\n");
+        const last = lines[lines.length - 1] ?? err;
+        const m = /^([A-Za-z_][\w.]*)(?::\s*(.*))?$/.exec(last);
+        return new ExecutionError(m?.[1] ?? "Error", m?.[2] ?? last, err);
+    }
+    const o = err;
+    return new ExecutionError(o.name ?? "Error", o.message ?? "", o.traceback ?? "");
+}
+// --- default template -------------------------------------------------------------------------------------------------
+export const CODE_INTERPRETER_TEMPLATE = "code-interpreter-v1";
+/** The data-analysis stack of E2B's default code-interpreter image, minus the very large audio/NLP/vision wheels. */
+export const CODE_INTERPRETER_PACKAGES = [
+    "pandas", "scipy", "scikit-learn", "scikit-image", "seaborn", "plotly", "bokeh", "imageio",
+    "sympy", "xarray", "joblib", "nltk", "textblob", "requests", "aiohttp", "beautifulsoup4", "openpyxl", "xlrd", "python-docx",
+    "pytz", "pytest",
+];
+/**
+ * numpy, matplotlib and pillow ship in the base image as Debian packages built against numpy 1.x. Installing the
+ * data stack pulls numpy 2.x, which breaks them ("numpy.core.multiarray failed to import"), so they are reinstalled
+ * from PyPI first. The Debian matplotlib is removed so the two copies cannot mix (mixed copies lose Axes3D and the
+ * kernel's structured chart extraction).
+ */
+const PIP_BASE = "rm -rf /usr/lib/python3/dist-packages/matplotlib* /usr/lib/python3/dist-packages/mpl_toolkits* /usr/lib/python3/dist-packages/pylab.py && pip install --ignore-installed numpy matplotlib pillow";
+const building = new Map();
+/** Build `code-interpreter-v1` into your org (several minutes, once). `Sandbox.create()` calls this when it is missing. */
+export function buildCodeInterpreterTemplate(opts = {}) {
+    const conn = resolveConn(opts);
+    const key = `${conn.apiKey}\n${conn.baseUrl}`;
+    let p = building.get(key);
+    if (!p) {
+        p = (async () => {
+            try {
+                const client = new TemplateClient({ apiKey: conn.apiKey, baseUrl: conn.baseUrl });
+                const view = await client.build(Image.fromTemplate("base").runCommands(PIP_BASE).pipInstall(CODE_INTERPRETER_PACKAGES), { name: CODE_INTERPRETER_TEMPLATE, ...(opts.onLog ? { onLog: opts.onLog } : {}) });
+                return view.templateId;
+            }
+            catch (e) {
+                throw translateError(e);
+            }
+            finally {
+                building.delete(key);
+            }
+        })();
+        building.set(key, p);
+    }
+    return p;
+}
+async function ensureCodeInterpreterTemplate(conn) {
+    const override = typeof process !== "undefined" ? process.env.SOLARI_CODE_INTERPRETER_TEMPLATE : undefined;
+    if (override)
+        return resolveTemplateId(conn, override);
+    try {
+        return await resolveTemplateId(conn, CODE_INTERPRETER_TEMPLATE);
+    }
+    catch (e) {
+        if (!(e instanceof Error) || !/not found/.test(e.message))
+            throw e;
+    }
+    console.warn(`@solarisdk/e2b-compat: building the "${CODE_INTERPRETER_TEMPLATE}" template into your Solari org (one time, several minutes). To prebuild, call buildCodeInterpreterTemplate().`);
+    return buildCodeInterpreterTemplate({ apiKey: conn.apiKey, apiUrl: conn.baseUrl });
+}
+// --- sandbox -----------------------------------------------------------------------------------------------------------
+const contexts = new Map();
+const ctxOf = (id) => {
+    let m = contexts.get(id);
+    if (!m)
+        contexts.set(id, (m = new Map()));
+    return m;
+};
+const RESET_CONTEXT = "for __n in [n for n in list(globals()) if not n.startswith('__')]:\n    del globals()[__n]\ndel __n\n";
+export class Sandbox extends BaseSandbox {
+    static defaultTemplate = CODE_INTERPRETER_TEMPLATE;
+    static resolveTemplate(conn, template) {
+        return template === CODE_INTERPRETER_TEMPLATE ? ensureCodeInterpreterTemplate(conn) : resolveTemplateId(conn, template);
+    }
+    async runCode(code, opts = {}) {
+        if (opts.language && opts.context)
+            throw new InvalidArgumentError("You can provide context or language, but not both at the same time.");
+        if (opts.envs && Object.keys(opts.envs).length > 0)
+            throw new SolariCompatUnsupported("runCode envs", "set variables with sandbox.commands or os.environ in the code");
+        const language = opts.context?.language ?? opts.language ?? "python";
+        const run = language === "bash" ? this.runBash(code) : this.runPython(code, language, opts.context);
+        const exec = await withTimeout(run, opts.timeoutMs);
+        const now = Date.now() * 1e6;
+        for (const l of exec.logs.stdout)
+            await opts.onStdout?.(new OutputMessage(l, now, false));
+        for (const l of exec.logs.stderr)
+            await opts.onStderr?.(new OutputMessage(l, now, true));
+        for (const r of exec.results)
+            await opts.onResult?.(r);
+        if (exec.error)
+            await opts.onError?.(exec.error);
+        return exec;
+    }
+    async runPython(code, language, context) {
+        if (!["python", "python3", "py", "ipython"].includes(language)) {
+            throw new SolariCompatUnsupported(`runCode language "${language}"`, "the Solari guest ships a Python kernel (and bash through language: 'bash')");
+        }
+        const r = await this.box.on((sb) => sb.runCode(code, { language: "python", ...(context ? { contextId: context.id } : {}) }));
+        const stdout = [];
+        const stderr = [];
+        const items = [];
+        for (const it of r.results) {
+            if (it.type === "stdout") {
+                if (it.text)
+                    stdout.push(it.text);
+            }
+            else if (it.type === "stderr") {
+                if (it.text)
+                    stderr.push(it.text);
+            }
+            else
+                items.push(it);
+        }
+        const lastText = items.map((i, n) => (i.text !== undefined ? n : -1)).filter((n) => n >= 0).pop();
+        const results = items.map((it, n) => toResult(it, n === lastText));
+        return new Execution(results, { stdout, stderr }, r.error !== undefined ? toExecutionError(r.error) : undefined);
+    }
+    async runBash(code) {
+        try {
+            const r = await this.commands.run(code, { timeoutMs: 0 });
+            return new Execution([], { stdout: r.stdout ? [r.stdout] : [], stderr: r.stderr ? [r.stderr] : [] });
+        }
+        catch (e) {
+            if (e instanceof CommandExitError) {
+                return new Execution([], { stdout: e.stdout ? [e.stdout] : [], stderr: e.stderr ? [e.stderr] : [] }, new ExecutionError("CommandExitError", `exit status ${e.exitCode}`, e.stderr));
+            }
+            throw e;
+        }
+    }
+    async createCodeContext(opts = {}) {
+        const language = opts.language ?? "python";
+        if (!["python", "python3", "py", "ipython"].includes(language)) {
+            throw new SolariCompatUnsupported(`createCodeContext language "${language}"`, "the Solari guest ships a Python kernel only");
+        }
+        const id = await this.box.on((sb) => sb.createCodeContext("python"));
+        const cwd = opts.cwd ?? (await this.box.home());
+        if (opts.cwd)
+            await this.box.on((sb) => sb.runCode(`import os\nos.chdir(${JSON.stringify(opts.cwd)})\n`, { language: "python", contextId: id }));
+        const ctx = { id, language: "python", cwd };
+        ctxOf(this.sandboxId).set(id, ctx);
+        return ctx;
+    }
+    /** Contexts created through this process (Solari cannot list a sandbox's kernels). */
+    async listCodeContexts() {
+        return [...ctxOf(this.sandboxId).values()];
+    }
+    /** Forgets the context. The kernel stays alive until the sandbox ends (Solari has no kernel destroy call). */
+    async removeCodeContext(context) {
+        const id = typeof context === "string" ? context : context.id;
+        if (!ctxOf(this.sandboxId).delete(id))
+            throw new SandboxError(`Context ${id} not found`);
+    }
+    /** Clears the context's variables and working directory (the kernel process is not restarted). */
+    async restartCodeContext(context) {
+        const id = typeof context === "string" ? context : context.id;
+        const ctx = ctxOf(this.sandboxId).get(id);
+        if (!ctx)
+            throw new SandboxError(`Context ${id} not found`);
+        await this.box.on((sb) => sb.runCode(`${RESET_CONTEXT}import os\nos.chdir(${JSON.stringify(ctx.cwd)})\n`, { language: "python", contextId: id }));
+    }
+}
+async function withTimeout(p, ms) {
+    if (!ms || ms <= 0)
+        return p;
+    let timer;
+    try {
+        return await Promise.race([
+            p,
+            new Promise((_, rej) => {
+                timer = setTimeout(() => rej(new TimeoutError(`Execution timed out after ${ms}ms (the kernel keeps running the code)`)), ms);
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export default Sandbox;
+/** @internal Exposed for unit tests. */
+export const _internal = { toResult, toExecutionError, mapChart };
+//# sourceMappingURL=code-interpreter.js.map

package/dist/code-interpreter.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,141 @@
+import type { Box } from "./box.js";
+export interface CommandResult {
+    exitCode: number;
+    error?: string;
+    stdout: string;
+    stderr: string;
+}
+export interface CommandRequestOpts {
+    requestTimeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface CommandStartOpts extends CommandRequestOpts {
+    background?: boolean;
+    cwd?: string;
+    user?: string;
+    envs?: Record<string, string>;
+    onStdout?: (data: string) => void | Promise<void>;
+    onStderr?: (data: string) => void | Promise<void>;
+    stdin?: boolean;
+    timeoutMs?: number;
+}
+export type CommandConnectOpts = Pick<CommandStartOpts, "onStderr" | "onStdout" | "timeoutMs"> & CommandRequestOpts;
+export interface ProcessInfo {
+    pid: number;
+    tag?: string;
+    cmd: string;
+    args: string[];
+    envs: Record<string, string>;
+    cwd?: string;
+}
+export interface CommandStreamInputOpts {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface PtyCreateOpts extends CommandRequestOpts {
+    cols: number;
+    rows: number;
+    onData: (data: Uint8Array) => void | Promise<void>;
+    timeoutMs?: number;
+    user?: string;
+    envs?: Record<string, string>;
+    cwd?: string;
+}
+export type PtyConnectOpts = Pick<PtyCreateOpts, "onData" | "timeoutMs"> & CommandRequestOpts;
+/** The Solari side of one tracked process, however it was started. */
+interface Backend {
+    kill(): Promise<void>;
+    stdin(data: Uint8Array | string): Promise<void>;
+    closeStdin?: () => Promise<void>;
+}
+/** What `commands.run({ background: true })` and `pty.create` return. */
+export declare class CommandHandle {
+    private readonly backend;
+    private readonly pty;
+    readonly pid: number;
+    private _stdout;
+    private _stderr;
+    private _exit;
+    private _error;
+    private readonly done;
+    private finish;
+    private readonly stdoutCbs;
+    private readonly stderrCbs;
+    private readonly ptyCbs;
+    /** @internal */
+    constructor(pid: number, backend: Backend, pty: boolean);
+    get stdout(): string;
+    get stderr(): string;
+    get exitCode(): number | undefined;
+    get error(): string | undefined;
+    /** @internal */
+    _data(stream: "stdout" | "stderr", data: string): void;
+    /** @internal */
+    _ptyData(data: Uint8Array): void;
+    /** @internal */
+    _onStdout(cb?: (d: string) => void | Promise<void>): void;
+    /** @internal */
+    _onStderr(cb?: (d: string) => void | Promise<void>): void;
+    /** @internal */
+    _onPty(cb?: (d: Uint8Array) => void | Promise<void>): void;
+    /** @internal */
+    _exited(code: number, error?: string): void;
+    /** Wait for the command to end. Throws {@link CommandExitError} on a non-zero exit, as E2B does. */
+    wait(): Promise<CommandResult>;
+    /** Stop receiving output; the command keeps running. */
+    disconnect(): Promise<void>;
+    /** SIGKILL. `false` when the command already ended. */
+    kill(): Promise<boolean>;
+    sendStdin(data: string | Uint8Array, _opts?: CommandRequestOpts): Promise<void>;
+    closeStdin(_opts?: CommandRequestOpts): Promise<void>;
+}
+/** Ordered input stream, built over repeated writes (Solari writes are ordered per command). */
+export declare class CommandInputHandle {
+    private readonly write;
+    private closed;
+    private queue;
+    constructor(write: (d: string | Uint8Array) => Promise<void>);
+    send(data: string | Uint8Array): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class Commands {
+    private readonly box;
+    /** @internal */
+    constructor(box: Box);
+    get supportsStdinClose(): boolean;
+    run(cmd: string, opts?: CommandStartOpts & {
+        background?: false;
+    }): Promise<CommandResult>;
+    run(cmd: string, opts: CommandStartOpts & {
+        background: true;
+    }): Promise<CommandHandle>;
+    run(cmd: string, opts?: CommandStartOpts & {
+        background?: boolean;
+    }): Promise<CommandHandle | CommandResult>;
+    private start;
+    /** Commands and PTYs this process started on the sandbox that have not ended. */
+    list(_opts?: CommandRequestOpts): Promise<ProcessInfo[]>;
+    kill(pid: number, _opts?: CommandRequestOpts): Promise<boolean>;
+    sendStdin(pid: number, data: string | Uint8Array, opts?: CommandRequestOpts): Promise<void>;
+    streamInput(pid: number, _opts?: CommandStreamInputOpts): CommandInputHandle;
+    closeStdin(pid: number, opts?: CommandRequestOpts): Promise<void>;
+    connect(pid: number, opts?: CommandConnectOpts): Promise<CommandHandle>;
+    private known;
+}
+export declare class Pty {
+    private readonly box;
+    /** @internal */
+    constructor(box: Box);
+    create(opts: PtyCreateOpts): Promise<CommandHandle>;
+    connect(pid: number, opts?: PtyConnectOpts): Promise<CommandHandle>;
+    sendInput(pid: number, data: Uint8Array, _opts?: CommandRequestOpts): Promise<void>;
+    streamInput(pid: number, _opts?: CommandStreamInputOpts): CommandInputHandle;
+    resize(pid: number, size: {
+        cols: number;
+        rows: number;
+    }, _opts?: CommandRequestOpts): Promise<void>;
+    kill(pid: number, _opts?: CommandRequestOpts): Promise<boolean>;
+    private pty;
+}
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AACD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,kBAAkB,CAAC;AACpH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AACD,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,WAAW,CAAC,GAAG,kBAAkB,CAAC;AAI9F,sEAAsE;AACtE,UAAU,OAAO;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAkBD,yEAAyE;AACzE,qBAAa,aAAa;IAetB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAftB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAE7E,gBAAgB;gBAEd,GAAG,EAAE,MAAM,EACM,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,OAAO;IAM/B,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IACD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,gBAAgB;IAChB,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAStD,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAGhC,gBAAgB;IAChB,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGzD,gBAAgB;IAChB,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGzD,gBAAgB;IAChB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAG1D,gBAAgB;IAChB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAO3C,oGAAoG;IAC9F,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAOpC,wDAAwD;IAClD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,uDAAuD;IACjD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAWxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/E,UAAU,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI5D;AAED,gGAAgG;AAChG,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAoC;gBACpB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC;IAC7E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED,qBAAa,QAAQ;IAEP,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,gBAAgB;gBACa,GAAG,EAAE,GAAG;IAErC,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG;QAAE,UAAU,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAC1F,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IACvF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;YAyB9F,KAAK;IAiCnB,iFAAiF;IAC3E,IAAI,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAM/D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,GAAG,kBAAkB;IAKtE,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAO7E,OAAO,CAAC,KAAK;CAOd;AAED,qBAAa,GAAG;IAEF,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,gBAAgB;gBACa,GAAG,EAAE,GAAG;IAE/B,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAcnD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAOnE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzF,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,sBAAsB,GAAG,kBAAkB;IAKtE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASpG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAOrE,OAAO,CAAC,GAAG;CAKZ"}