@multiplayer-app/agent 0.1.19 → 0.1.21

package/dist/app/runner.js

@@ -0,0 +1,429 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppRunner = exports.APP_LOG_DIR = void 0;
+exports.logTail = logTail;
+// Runs an app (config.ts's resolveApp): its installs (and, deployed, its builds), then every
+// service on its own $PORT and every daemon, each in its own process group with its output in
+// .builder/logs and its directory's node_modules/.bin and .venv/bin first on PATH, as npm scripts
+// have. A process that exits is started again after a backoff; a service is running once its
+// port answers. The runner also says where a request path goes (routes()).
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const protocol_1 = require("../transport/protocol");
+const preview_proxy_1 = require("../runtime/preview-proxy");
+const workload_1 = require("../runtime/workload");
+const config_1 = require("./config");
+const route_pattern_1 = require("./route-pattern");
+const rules_1 = require("./rules");
+const static_server_1 = require("./static-server");
+/** Where the app's logs go, relative to its directory (kept out of snapshots and commits). */
+exports.APP_LOG_DIR = '.builder/logs';
+const KILL_GRACE_MS = 5000;
+/** A try to connect on loopback costs next to nothing, and a visitor is waiting on the answer. */
+const READY_POLL_MS = 50;
+/**
+ * What a built release's processes run with: `npm run start` runs `start` and not what surrounds it,
+ * so an app's `prestart: tsc` doesn't build again. npm reads the first, pnpm the second.
+ */
+const ONLY_THE_SCRIPT_NAMED = { npm_config_ignore_scripts: 'true', npm_config_enable_pre_post_scripts: 'false' };
+async function canConnect(port) {
+    try {
+        const socket = await (0, preview_proxy_1.connectLocal)(port);
+        socket.destroy();
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function describeCommand(command) {
+    return Array.isArray(command) ? command.join(' ') : command;
+}
+class AppRunner {
+    constructor(config, options) {
+        var _a, _b, _c, _d, _e;
+        this.config = config;
+        this.options = options;
+        this.processes = new Map();
+        /** Its processes are all known: until then, none running doesn't mean all of them are. */
+        this.launched = false;
+        this.stopped = false;
+        this.logs = new Set();
+        this.spawn = (_a = options.spawn) !== null && _a !== void 0 ? _a : node_child_process_1.spawn;
+        this.isListening = (_b = options.isListening) !== null && _b !== void 0 ? _b : canConnect;
+        this.backoff = (_c = options.backoff) !== null && _c !== void 0 ? _c : { initialMs: 1000, maxMs: 30000, resetAfterMs: 60000 };
+        this.readyPollMs = (_d = options.readyPollMs) !== null && _d !== void 0 ? _d : READY_POLL_MS;
+        this.phase = options.prebuilt ? 'starting' : 'installing';
+        this.rewrites = ((_e = config.rewrites) !== null && _e !== void 0 ? _e : []).map((rewrite) => ({ pattern: (0, route_pattern_1.compileRoute)(rewrite.source), service: rewrite.destination.service }));
+    }
+    status() {
+        const processes = [...this.processes.values()].map((managed) => ({ ...managed.status }));
+        return { phase: this.currentPhase(), ...(this.error ? { error: this.error } : {}), processes };
+    }
+    currentPhase() {
+        if (this.error)
+            return 'failed';
+        if (this.phase !== 'starting' || !this.launched)
+            return this.phase;
+        const services = [...this.processes.values()].filter((managed) => managed.status.kind === 'service');
+        return services.every((managed) => managed.status.state === 'running') ? 'running' : 'starting';
+    }
+    /**
+     * A service is on its first start, so what a page calls may not be there yet. One that has
+     * crashed and is restarting doesn't count: it might never come up.
+     */
+    firstStartPending() {
+        const { phase, processes } = this.status();
+        return phase === 'starting' && processes.some((process) => process.kind === 'service' && process.state !== 'running' && process.state !== 'crashed' && process.restarts === 0);
+    }
+    changed() {
+        var _a, _b;
+        if (!this.stopped)
+            (_b = (_a = this.options).onStatus) === null || _b === void 0 ? void 0 : _b.call(_a, this.status());
+    }
+    logPath(name) {
+        return node_path_1.default.join(this.options.dir, exports.APP_LOG_DIR, `${name}.log`);
+    }
+    relativeLog(name) {
+        return `${exports.APP_LOG_DIR}/${name}.log`;
+    }
+    openLog(name) {
+        const stream = (0, workload_1.workloadAppendStream)(this.logPath(name));
+        stream.on('error', (error) => console.error(`[app] cannot write ${this.relativeLog(name)}:`, error.message));
+        this.logs.add(stream);
+        stream.on('close', () => this.logs.delete(stream));
+        return stream;
+    }
+    launch(command, cwd, env, logName) {
+        const log = this.openLog(logName);
+        log.write(`\n--- ${new Date().toISOString()} ${describeCommand(command)}\n`);
+        const options = {
+            ...(0, workload_1.workloadIdentity)(),
+            cwd,
+            env: (0, workload_1.workloadEnv)(env),
+            detached: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        };
+        const child = Array.isArray(command) ? this.spawn(command[0], command.slice(1), options) : this.spawn('sh', ['-c', command], options);
+        for (const stream of [child.stdout, child.stderr]) {
+            stream === null || stream === void 0 ? void 0 : stream.on('data', (chunk) => {
+                log.write(chunk);
+                if (this.options.echoOutput)
+                    process.stdout.write(`[${logName}] ${chunk.toString('utf8')}`);
+            });
+        }
+        child.once('close', () => log.end());
+        return child;
+    }
+    /** The processes' env in `cwd`: its own installed tools (node_modules/.bin, a .venv) come first. */
+    envFor(cwd) {
+        var _a, _b;
+        const tools = [node_path_1.default.join(cwd, 'node_modules', '.bin'), node_path_1.default.join(cwd, '.venv', 'bin')];
+        return { ...this.options.env, PATH: [...tools, (_b = (_a = this.options.env.PATH) !== null && _a !== void 0 ? _a : process.env.PATH) !== null && _b !== void 0 ? _b : ''].filter(Boolean).join(node_path_1.default.delimiter) };
+    }
+    /** Runs a one-off step (an install or a build) to completion: its exit code (null when it couldn't run). */
+    runStep(command, cwd, logName) {
+        return new Promise((resolve) => {
+            const child = this.launch(command, cwd, this.envFor(cwd), logName);
+            this.step = child;
+            child.once('error', () => resolve(null));
+            child.once('exit', (code) => {
+                if (this.step === child)
+                    this.step = undefined;
+                resolve(code);
+            });
+        });
+    }
+    resolveDir(root) {
+        return node_path_1.default.resolve(this.options.dir, root !== null && root !== void 0 ? root : '.');
+    }
+    /** Ports for services that name none: DEFAULT_APP_PORT upward, past reserved and busy ones. */
+    async assignPorts() {
+        const assigned = new Map();
+        const taken = new Set(Object.values(this.config.services).flatMap((service) => (service.port ? [service.port] : [])));
+        let next = protocol_1.DEFAULT_APP_PORT;
+        for (const [name, service] of Object.entries(this.config.services)) {
+            if (!(0, config_1.serviceCommand)(service, this.options.mode))
+                continue;
+            if (service.port) {
+                assigned.set(name, service.port);
+                continue;
+            }
+            while (taken.has(next) || protocol_1.GUEST_RESERVED_PORTS.includes(next) || (await this.isListening(next)))
+                next++;
+            assigned.set(name, next);
+            taken.add(next);
+        }
+        return assigned;
+    }
+    async buildMarker() {
+        if (!this.options.buildId)
+            return undefined;
+        return node_path_1.default.join(this.options.dir, '.builder', `built-${this.options.buildId.replace(/[^A-Za-z0-9_-]/g, '')}`);
+    }
+    /** Installs and builds as this mode does, starting nothing. False when a step failed (status says why) or it was stopped. */
+    async prepare() {
+        await (0, workload_1.makeWorkloadDir)(node_path_1.default.join(this.options.dir, exports.APP_LOG_DIR));
+        const marker = await this.buildMarker();
+        const built = marker ? await node_fs_1.promises.access(marker).then(() => true, () => false) : false;
+        if (!built && !this.options.prebuilt && !(await this.install()))
+            return false;
+        if (this.options.mode === 'production' && !built) {
+            if (!this.options.prebuilt && !(await this.build()))
+                return false;
+            if (marker)
+                await (0, workload_1.writeWorkloadFile)(marker, new Date().toISOString());
+        }
+        else if (this.options.mode === 'dev' && !(await this.build((service) => !service.devCommand))) {
+            // In a session VM only a service with no dev server is built: it is served from its output.
+            return false;
+        }
+        return !this.stopped;
+    }
+    /** Installs (and builds, deployed), then starts every process. Resolves once they're launched. */
+    async start() {
+        var _a, _b;
+        if (!(await this.prepare()))
+            return;
+        this.phase = 'starting';
+        const ports = await this.assignPorts();
+        for (const [name, service] of Object.entries(this.config.services)) {
+            const command = (0, config_1.serviceCommand)(service, this.options.mode);
+            const cwd = this.resolveDir(service.root);
+            const managed = {
+                status: { name, kind: 'service', state: 'starting', restarts: 0 },
+                cwd,
+                command,
+                startedAt: 0,
+                failures: 0,
+            };
+            // A dev server standing in for what deploys as static files routes for itself (Vite's own
+            // SPA fallback): the rules about those files are not for it. Clean URLs are only about files.
+            const devServerOfStaticSite = Boolean(command && service.outputDirectory && !service.startCommand);
+            managed.rules = (0, rules_1.compileRules)({
+                ...service,
+                cleanUrls: !command && service.cleanUrls,
+                rewrites: devServerOfStaticSite ? undefined : service.rewrites,
+                trailingSlash: devServerOfStaticSite ? undefined : service.trailingSlash,
+            });
+            if (command) {
+                managed.status.port = ports.get(name);
+                managed.status.log = this.relativeLog(name);
+            }
+            else {
+                // Static: the built output deployed, its directory (or root) in the session VM.
+                const output = node_path_1.default.resolve(cwd, (_a = service.outputDirectory) !== null && _a !== void 0 ? _a : '.');
+                managed.site = (0, static_server_1.createStaticSite)(output, managed.rules, { hideProjectFiles: output === node_path_1.default.resolve(cwd) });
+                managed.status.state = 'running';
+            }
+            this.processes.set(name, managed);
+        }
+        for (const [name, daemon] of Object.entries((_b = this.config.daemons) !== null && _b !== void 0 ? _b : {})) {
+            this.processes.set(name, {
+                status: { name, kind: 'daemon', state: 'starting', restarts: 0, log: this.relativeLog(name) },
+                cwd: this.resolveDir(daemon.root),
+                command: (0, config_1.daemonCommand)(daemon, this.options.mode),
+                startedAt: 0,
+                failures: 0,
+            });
+        }
+        this.launched = true;
+        for (const managed of this.processes.values())
+            if (managed.command)
+                this.startProcess(managed);
+        this.changed();
+    }
+    fail(error) {
+        this.error = error;
+        this.changed();
+        return false;
+    }
+    async install() {
+        var _a, _b;
+        this.phase = 'installing';
+        this.changed();
+        const seen = new Set();
+        const entries = [...Object.values(this.config.services), ...Object.values((_a = this.config.daemons) !== null && _a !== void 0 ? _a : {})];
+        for (const entry of entries) {
+            if (!entry.installCommand || this.stopped)
+                continue;
+            const cwd = this.resolveDir(entry.root);
+            const key = `${cwd}\0${entry.installCommand}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const code = await this.runStep(entry.installCommand, cwd, 'install');
+            if (code !== 0)
+                return this.fail(`Install failed in ${(_b = entry.root) !== null && _b !== void 0 ? _b : '.'} (exit ${code !== null && code !== void 0 ? code : 'error'}); see ${this.relativeLog('install')}`);
+        }
+        return !this.stopped;
+    }
+    async build(which = () => true) {
+        const builds = Object.entries(this.config.services).filter(([, service]) => service.buildCommand && which(service));
+        if (!builds.length)
+            return !this.stopped;
+        this.phase = 'building';
+        this.changed();
+        for (const [name, service] of builds) {
+            if (!service.buildCommand || this.stopped)
+                continue;
+            const code = await this.runStep(service.buildCommand, this.resolveDir(service.root), `${name}.build`);
+            if (code !== 0)
+                return this.fail(`Build of ${name} failed (exit ${code !== null && code !== void 0 ? code : 'error'}); see ${this.relativeLog(`${name}.build`)}`);
+        }
+        return !this.stopped;
+    }
+    startProcess(managed) {
+        if (this.stopped || !managed.command)
+            return;
+        const env = { ...this.envFor(managed.cwd), ...(this.options.prebuilt ? ONLY_THE_SCRIPT_NAMED : {}) };
+        if (managed.status.port)
+            env.PORT = String(managed.status.port);
+        else
+            delete env.PORT;
+        managed.status.state = 'starting';
+        managed.startedAt = Date.now();
+        const child = this.launch(managed.command, managed.cwd, env, managed.status.name);
+        managed.child = child;
+        child.once('error', (error) => {
+            console.error(`[app] ${managed.status.name} could not start:`, error.message);
+            this.exited(managed, child, null, null);
+        });
+        child.once('exit', (code, signal) => this.exited(managed, child, code, signal));
+        if (managed.status.port)
+            this.pollReady(managed, child);
+    }
+    pollReady(managed, child) {
+        managed.readyTimer = setTimeout(() => {
+            if (managed.child !== child || this.stopped)
+                return;
+            void this.isListening(managed.status.port).then((listening) => {
+                if (managed.child !== child || this.stopped)
+                    return;
+                if (!listening)
+                    return this.pollReady(managed, child);
+                managed.status.state = 'running';
+                this.changed();
+            });
+        }, this.readyPollMs);
+    }
+    exited(managed, child, code, signal) {
+        if (managed.child !== child)
+            return;
+        managed.child = undefined;
+        clearTimeout(managed.readyTimer);
+        if (this.stopped) {
+            managed.status.state = 'stopped';
+            return;
+        }
+        managed.status.state = 'crashed';
+        managed.status.exitCode = code;
+        managed.status.signal = signal;
+        // A process that stayed up for a while starts over at the shortest wait.
+        managed.failures = Date.now() - managed.startedAt >= this.backoff.resetAfterMs ? 1 : managed.failures + 1;
+        const delay = Math.min(this.backoff.initialMs * 2 ** (managed.failures - 1), this.backoff.maxMs);
+        this.changed();
+        managed.restartTimer = setTimeout(() => {
+            managed.status.restarts++;
+            this.startProcess(managed);
+            this.changed();
+        }, delay);
+    }
+    routeTo(name) {
+        const managed = this.processes.get(name);
+        if (!managed)
+            return { kind: 'unavailable' };
+        if (managed.site && managed.rules)
+            return { kind: 'static', site: managed.site, rules: managed.rules };
+        if (managed.status.state === 'running' && managed.status.port && managed.rules)
+            return { kind: 'port', port: managed.status.port, rules: managed.rules };
+        return { kind: 'unavailable', process: { ...managed.status } };
+    }
+    /**
+     * Where a request for `pathname` goes: a service's port, its static files, or nowhere yet, for
+     * every rewrite that matches, in order. A static service without the file passes it to the next.
+     */
+    routes(pathname) {
+        if (!this.rewrites.length) {
+            const first = Object.keys(this.config.services)[0];
+            return first ? [this.routeTo(first)] : [{ kind: 'none' }];
+        }
+        const matching = this.rewrites.filter((rewrite) => (0, route_pattern_1.matchRoute)(rewrite.pattern, pathname)).map((rewrite) => this.routeTo(rewrite.service));
+        return matching.length ? matching : [{ kind: 'none' }];
+    }
+    /** Resolves once every service is running or has crashed (or the app failed), or after `timeoutMs`. */
+    settled(timeoutMs) {
+        const done = () => {
+            const status = this.status();
+            if (status.phase === 'failed' || status.phase === 'running')
+                return true;
+            return status.phase === 'starting' && !this.firstStartPending();
+        };
+        return new Promise((resolve) => {
+            const deadline = Date.now() + timeoutMs;
+            const check = () => {
+                if (done() || Date.now() >= deadline || this.stopped)
+                    return resolve(this.status());
+                setTimeout(check, READY_POLL_MS);
+            };
+            check();
+        });
+    }
+    kill(child, signal) {
+        try {
+            // The whole process group: a shell and the dev server it started.
+            if (child.pid)
+                process.kill(-child.pid, signal);
+        }
+        catch (_a) {
+            try {
+                child.kill(signal);
+            }
+            catch (_b) {
+                // Already gone.
+            }
+        }
+    }
+    /** Stops every process (SIGTERM, then SIGKILL after a grace period). */
+    async stop() {
+        this.stopped = true;
+        const exits = [];
+        const children = [this.step];
+        for (const managed of this.processes.values()) {
+            clearTimeout(managed.restartTimer);
+            clearTimeout(managed.readyTimer);
+            children.push(managed.child);
+        }
+        for (const child of children) {
+            if (!child || child.exitCode !== null || child.signalCode !== null)
+                continue;
+            exits.push(new Promise((resolve) => {
+                const force = setTimeout(() => this.kill(child, 'SIGKILL'), KILL_GRACE_MS);
+                child.once('exit', () => {
+                    clearTimeout(force);
+                    resolve();
+                });
+                this.kill(child, 'SIGTERM');
+            }));
+        }
+        await Promise.all(exits);
+        for (const log of this.logs)
+            log.end();
+    }
+}
+exports.AppRunner = AppRunner;
+/** A log's last `lines` lines, for telling the model or a person why something failed. */
+async function logTail(dir, relativeLog, lines = 40) {
+    try {
+        const text = (await (0, workload_1.readInside)(dir, node_path_1.default.join(dir, relativeLog))).toString('utf8');
+        return text.split('\n').slice(-lines).join('\n');
+    }
+    catch (_a) {
+        return '';
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/app/runner.js.map

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

package/dist/app/site.d.ts

@@ -0,0 +1,73 @@
+import type { AppConfig, AppMode } from './config';
+import { type RoutePattern } from './route-pattern';
+import { type RoutingRules } from './rules';
+interface SiteService {
+    name: string;
+    root: string;
+    /** Where its static files are, from the workspace; undefined when only its process answers. */
+    output?: string;
+    /** It runs a process in a session VM. */
+    runs: boolean;
+    /** Its output is its own folder, so what's at the top of that is the service's, not the site's. */
+    hideProjectFiles: boolean;
+    rules: RoutingRules;
+    framework?: string | null;
+}
+export interface AppSite {
+    services: SiteService[];
+    routes: Array<{
+        pattern: RoutePattern;
+        service: SiteService;
+    }>;
+}
+export type SiteAnswer = 
+/** `hashed`: its name changes with its content, so it can be cached for good. */
+{
+    kind: 'file';
+    file: string;
+    headers: Array<{
+        key: string;
+        value: string;
+    }>;
+    hashed: boolean;
+} | {
+    kind: 'redirect';
+    status: number;
+    location: string;
+}
+/** Only the service's running process can answer this path. */
+ | {
+    kind: 'process';
+    service: string;
+} | {
+    kind: 'none';
+};
+/** Whether a workspace file exists, by its path from the workspace root. */
+type FileExists = (file: string) => boolean | Promise<boolean>;
+/**
+ * The URLs `config` is served at: as in a session VM, or, for 'production', as deployed. Deployed, a
+ * service with a command is that process alone; in a session VM its dev server's saved output
+ * answers for whoever can't start it.
+ */
+export declare function appSite(config: AppConfig, mode?: AppMode): AppSite;
+/** Whether the app's URL leads to a process, such as an API or a dev server, not only to stored files. */
+export declare function siteRunsProcess(site: AppSite): boolean;
+/**
+ * What the site answers at `pathname`: a stored file of a static service, or the first service with
+ * a process, trying each route that matches in order, as the guest does. Redirects answer first.
+ */
+export declare function resolveSitePath(site: AppSite, pathname: string, search: string, exists: FileExists): Promise<SiteAnswer>;
+export interface SiteLocation {
+    /** The path it opens at on the app's URL. */
+    url: string;
+    /** Its path within the static output it is served from; absent for a process's own page. */
+    staticPath?: string;
+}
+/**
+ * Where the site serves a workspace file, checked against the routes (another service may hold that
+ * URL), or undefined when builder.json doesn't describe it. A service's process answers at `/` for
+ * the index.html at its root: the page a dev server starts from.
+ */
+export declare function siteLocationOf(site: AppSite, file: string, exists: FileExists): Promise<SiteLocation | undefined>;
+export {};
+//# sourceMappingURL=site.d.ts.map

package/dist/app/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/app/site.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC7E,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAGlF,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yCAAyC;IACzC,IAAI,EAAE,OAAO,CAAA;IACb,mGAAmG;IACnG,gBAAgB,EAAE,OAAO,CAAA;IACzB,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAyBD,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CAC/D;AAED,MAAM,MAAM,UAAU;AACpB,iFAAiF;AAC/E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACxD,+DAA+D;GAC7D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB,4EAA4E;AAC5E,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,OAAe,GAAG,OAAO,CAqBzE;AAOD,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGtD;AAaD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAqB9H;AAED,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA0BvH"}