@jungjaehoon/mama-os 0.77.0 → 0.78.0

package/dist/cli/commands/uninstall.js

@@ -0,0 +1,262 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUninstall = runUninstall;
+/**
+ * `mama uninstall [--dry-run] [--data [--toolkit]]`: stop MAMA and remove its service. With
+ * --data, once the MAMA home's path has been typed back, also remove what MAMA created: the MAMA
+ * home, the folder of each person it registered under `member_root` (and the folders it retired),
+ * and the common skills under `tools_root` (with --toolkit, the toolkit's versions too). A folder
+ * MAMA did not create is never removed whole: `member_root` and `tools_root` go only once empty, so
+ * a misconfigured root (a volume, a shared folder) loses nothing but MAMA's own entries.
+ * `--dry-run` lists what would go and what stays, and changes nothing. The program itself is an npm
+ * package, which npm removes.
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const config_js_1 = require("../../runtime/config.js");
+const backend_security_js_1 = require("../../runtime/backend-security.js");
+const member_paths_js_1 = require("../../runtime/member-paths.js");
+const document_toolkit_js_1 = require("../../tools/document-toolkit.js");
+const prompt_js_1 = require("../prompt.js");
+const daemon_control_js_1 = require("../runtime/daemon-control.js");
+const control_js_1 = require("./control.js");
+const service_js_1 = require("./service.js");
+const USAGE = 'Usage: mama uninstall [--dry-run] [--data [--toolkit]]';
+const PRINCIPAL_ID = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+function parseArgs(args) {
+    const flags = new Set(args);
+    for (const arg of flags) {
+        if (!['--dry-run', '--data', '--toolkit'].includes(arg))
+            throw new prompt_js_1.CliInputError(USAGE);
+    }
+    if (flags.has('--toolkit') && !flags.has('--data'))
+        throw new prompt_js_1.CliInputError(USAGE);
+    return {
+        dryRun: flags.has('--dry-run'),
+        data: flags.has('--data'),
+        toolkit: flags.has('--toolkit'),
+    };
+}
+/** Bytes under a path, links counted as themselves; null when part of it cannot be read. */
+function sizeOf(path) {
+    try {
+        const stat = (0, node_fs_1.lstatSync)(path);
+        if (!stat.isDirectory())
+            return stat.size;
+        let sum = 0;
+        for (const name of (0, node_fs_1.readdirSync)(path)) {
+            const size = sizeOf((0, node_path_1.join)(path, name));
+            if (size === null)
+                return null;
+            sum += size;
+        }
+        return sum;
+    }
+    catch {
+        return null;
+    }
+}
+function sized(path) {
+    const bytes = sizeOf(path);
+    return bytes === null
+        ? 'size unknown: part of it cannot be read'
+        : `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+/** Inside `parent`, or `parent` itself, by physical path (real case, links resolved). */
+function within(parent, child) {
+    const path = (0, node_path_1.relative)((0, backend_security_js_1.physicalReadPath)(parent), (0, backend_security_js_1.physicalReadPath)(child));
+    return path === '' || (path !== '..' && !path.startsWith(`..${node_path_1.sep}`));
+}
+/** The ids of the people MAMA registered, from its own database. */
+function registeredPeople(config) {
+    if (!(0, node_fs_1.existsSync)(config.database.path))
+        return [];
+    const db = new better_sqlite3_1.default(config.database.path, { readonly: true, fileMustExist: true });
+    try {
+        return db.prepare('SELECT principal_id FROM principals').all()
+            .map((row) => row.principal_id)
+            .filter((id) => PRINCIPAL_ID.test(id));
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * What --data removes. The MAMA home goes whole, and is refused when it is a link or when it is the
+ * filesystem root, HOME or a folder holding HOME (compared by physical path, so a different letter
+ * case on a case-insensitive disk is the same folder). Under member_root and tools_root only the
+ * entries MAMA creates go.
+ */
+function dataPlan(home, configPath, toolkit) {
+    const root = (0, node_path_1.dirname)(configPath);
+    const plan = { root, remove: [], emptied: [], stays: [] };
+    if (!(0, node_fs_1.existsSync)(root))
+        return plan;
+    if ((0, node_fs_1.lstatSync)(root).isSymbolicLink()) {
+        throw new prompt_js_1.CliInputError(`${root} is a link; remove its target, or the link, yourself`);
+    }
+    if (within((0, backend_security_js_1.physicalReadPath)(root), home) || (0, backend_security_js_1.physicalReadPath)(root) === node_path_1.sep) {
+        throw new prompt_js_1.CliInputError(`refusing to remove ${root}: it is the filesystem root, your home or a folder that holds it`);
+    }
+    if ((0, node_fs_1.existsSync)(configPath)) {
+        const config = (0, config_js_1.loadConfig)({ home, path: configPath });
+        if (config.member_root !== undefined && (0, node_fs_1.existsSync)(config.member_root)) {
+            for (const id of registeredPeople(config)) {
+                const folder = (0, node_path_1.join)(config.member_root, id);
+                if ((0, node_fs_1.existsSync)(folder))
+                    plan.remove.push({ path: folder, what: `${id}'s workspace and state` });
+                for (const temp of [(0, member_paths_js_1.memberClaudeTmpDir)(id), (0, member_paths_js_1.memberRoomTmpRoot)(id)]) {
+                    if ((0, node_fs_1.existsSync)(temp))
+                        plan.remove.push({ path: temp, what: `${id}'s temporary files` });
+                }
+            }
+            for (const entry of (0, node_fs_1.readdirSync)(config.member_root)) {
+                if (entry.startsWith('.retired-')) {
+                    plan.remove.push({ path: (0, node_path_1.join)(config.member_root, entry), what: 'a retired folder' });
+                }
+            }
+            plan.emptied.push(config.member_root);
+        }
+        if (config.tools_root !== undefined && (0, node_fs_1.existsSync)(config.tools_root)) {
+            for (const entry of (0, node_fs_1.readdirSync)(config.tools_root)) {
+                const path = (0, node_path_1.join)(config.tools_root, entry);
+                if (entry === 'skills') {
+                    plan.remove.push({ path, what: 'the common skills' });
+                }
+                else if (!toolkit) {
+                    continue;
+                }
+                else if (entry.startsWith('v-')) {
+                    plan.remove.push({ path, what: 'a document toolkit version', remove: document_toolkit_js_1.removeVersion });
+                }
+                else if (entry === 'current' ||
+                    entry.startsWith('.current-') ||
+                    entry === '.leases' ||
+                    entry === '.mama-document-toolkit') {
+                    plan.remove.push({ path, what: 'the document toolkit' });
+                }
+                else if (entry === 'apps' || entry === 'fonts') {
+                    // Homebrew installed these casks into tools_root and keeps their records.
+                    const casks = entry === 'apps' ? 'libreoffice' : 'font-noto-sans-cjk font-noto-serif-cjk';
+                    plan.stays.push({ path, what: `installed by Homebrew: brew uninstall --cask ${casks}` });
+                }
+            }
+            if (toolkit)
+                plan.emptied.push(config.tools_root);
+        }
+        // Settings can point outside the MAMA home; such a path is not proven to be MAMA's alone.
+        const elsewhere = [
+            { path: config.database.path, what: 'the database' },
+            { path: config.logging.file, what: 'the daemon log' },
+            { path: config.agent.codex_home ?? (0, node_path_1.join)(root, '.codex'), what: 'the Codex home' },
+            { path: config.jev.keyFile, what: 'the Jev key' },
+            { path: config.jev.vocabFile, what: "Jev's vocabulary" },
+            ...(config.agent.codex_cwd
+                ? [{ path: config.agent.codex_cwd, what: 'the Codex workspace' }]
+                : []),
+            ...(config.agent.tools?.mcp_config
+                ? [{ path: config.agent.tools.mcp_config, what: 'the MCP configuration' }]
+                : []),
+        ];
+        for (const entry of elsewhere) {
+            if ((0, node_fs_1.existsSync)(entry.path) && !within(root, entry.path)) {
+                plan.stays.push({
+                    path: entry.path,
+                    what: `${entry.what}, set outside the MAMA home; remove it yourself if it is MAMA's alone`,
+                });
+            }
+        }
+    }
+    plan.remove.push({
+        path: root,
+        what: 'the MAMA home: config, credentials, workspace, logs, backups and, by default, the database',
+    });
+    return plan;
+}
+async function runUninstall(args, options = {}) {
+    const { dryRun, data, toolkit } = parseArgs(args);
+    const home = options.home ?? (0, node_os_1.homedir)();
+    const configPath = options.configPath ?? (0, config_js_1.defaultConfigPath)(home);
+    const write = options.write ?? ((line) => console.log(line));
+    const plan = data ? dataPlan(home, configPath, toolkit) : null;
+    const notes = (prefix, say) => {
+        if (!plan)
+            return;
+        for (const entry of plan.remove)
+            say(`${prefix} ${entry.path} (${sized(entry.path)}): ${entry.what}`);
+        for (const folder of plan.emptied)
+            say(`${prefix} ${folder} too, if nothing else is left in it`);
+        for (const entry of plan.stays) {
+            say(`stays: ${entry.path} (${entry.what})`);
+        }
+    };
+    if (dryRun) {
+        write(`would stop MAMA and remove its service: ${(0, service_js_1.serviceFile)(options)}`);
+        notes('would remove', write);
+        if (!data)
+            write('the data stays; --data also removes it');
+        return 0;
+    }
+    if (plan && plan.remove.length > 0) {
+        const prompt = options.prompt ?? (0, prompt_js_1.createTerminalPrompt)();
+        (0, prompt_js_1.requireTTY)(prompt);
+        notes('removes', (line) => prompt.write(line));
+        const typed = (await prompt.text(`This cannot be undone. Type ${plan.root} to remove it`)).trim();
+        if (typed !== plan.root)
+            throw new prompt_js_1.CliInputError('Not confirmed; nothing was removed.');
+    }
+    // Whatever holds the install (the service's daemon, one started by hand) stops first; a command
+    // that cannot be stopped this way leaves everything as it was.
+    const control = (0, daemon_control_js_1.daemonControlPaths)((0, node_path_1.dirname)(configPath));
+    if ((0, daemon_control_js_1.lockHolder)(control) !== null) {
+        const stopped = await (0, control_js_1.runStop)([], options);
+        if (stopped !== 0)
+            return stopped;
+    }
+    const removed = await (0, service_js_1.uninstallService)(options);
+    if (removed !== 0 || !plan || !(0, node_fs_1.existsSync)(plan.root)) {
+        if (plan)
+            write('npm uninstall -g @jungjaehoon/mama-os removes the program itself');
+        return removed;
+    }
+    // One entry that cannot be removed does not stop the rest half-way; each failure is reported.
+    const failed = [];
+    const lock = (0, daemon_control_js_1.acquireInstallLock)(control, 'uninstall');
+    try {
+        for (const entry of plan.remove) {
+            try {
+                if (entry.remove)
+                    entry.remove(entry.path);
+                else
+                    (0, node_fs_1.rmSync)(entry.path, { recursive: true, force: true });
+                write(`removed ${entry.path}`);
+            }
+            catch (error) {
+                failed.push(`${entry.path}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        for (const folder of plan.emptied) {
+            if ((0, node_fs_1.existsSync)(folder) && (0, node_fs_1.readdirSync)(folder).length === 0) {
+                (0, node_fs_1.rmdirSync)(folder);
+                write(`removed ${folder}`);
+            }
+            else if ((0, node_fs_1.existsSync)(folder)) {
+                write(`kept ${folder}: it still holds what stays, or entries MAMA did not create`);
+            }
+        }
+    }
+    finally {
+        // The lock's file went with the MAMA home; closing it is all that is left.
+        lock.release();
+    }
+    for (const failure of failed)
+        write(`could not remove ${failure}`);
+    write('npm uninstall -g @jungjaehoon/mama-os removes the program itself');
+    return failed.length > 0 ? 1 : 0;
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/cli/commands/uninstall.js.map

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

package/dist/cli/index.js

@@ -3,16 +3,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_js_1 = require("../runtime/config.js");
 const prompt_js_1 = require("./prompt.js");
-/**
- * replay and backfill open the daemon's database and rewrite its workspace settings, the shell
- * sandbox's proxy ports among them, so they run only while the daemon is stopped.
- */
-async function requireDaemonStopped(command) {
-    const { daemonStatus } = await import('./commands/daemon.js');
-    if (daemonStatus() === 'running') {
-        throw new prompt_js_1.CliInputError(`Stop the daemon before mama ${command}: run mama stop`);
-    }
-}
 async function main() {
     const command = process.argv[2];
     if (command === 'tools') {
@@ -33,42 +23,99 @@ async function main() {
         return;
     }
     if (command === 'register-owner') {
-        await requireDaemonStopped('register-owner');
         const { runRegisterOwner } = await import('./commands/register-owner.js');
         await runRegisterOwner(process.argv.slice(3));
         return;
     }
+    if (command === 'logs') {
+        const { runLogs } = await import('./commands/logs.js');
+        const controller = new AbortController();
+        process.once('SIGINT', () => controller.abort());
+        await runLogs(process.argv.slice(3), { signal: controller.signal });
+        return;
+    }
     if (command === 'daemon') {
         const { runDaemon } = await import('./commands/daemon.js');
-        await runDaemon();
+        const { InstallBusyError, RestorePendingError } = await import('./runtime/daemon-control.js');
+        try {
+            const { DAEMON_LOG_LIMITS, openRotatingLog, takeOverOutput } = await import('../runtime/rotating-log.js');
+            await runDaemon({
+                captureOutput: (logFile) => takeOverOutput(openRotatingLog(logFile, DAEMON_LOG_LIMITS)),
+            });
+        }
+        catch (error) {
+            // Another process already holds this install, or a restore is unfinished: a clean exit,
+            // which the service files leave stopped (they restart only after a failure).
+            // A newer schema stays newer too; restarting into the refusal would only repeat it.
+            if (!(error instanceof InstallBusyError) &&
+                !(error instanceof RestorePendingError) &&
+                !isNewerSchema(error)) {
+                // The log line above names the error; this names the stage and the next step.
+                const stage = error.bootStage;
+                if (typeof stage === 'string') {
+                    console.error(`mama daemon failed at boot stage ${stage}; mama doctor checks the install`);
+                }
+                throw error;
+            }
+            console.error(error.message);
+        }
         return;
     }
     if (command === 'replay') {
-        await requireDaemonStopped('replay');
         const { runReplay } = await import('./commands/replay.js');
         await runReplay();
         return;
     }
     if (command === 'backfill') {
-        await requireDaemonStopped('backfill');
         const { runBackfill } = await import('./commands/backfill.js');
         await runBackfill(process.argv.slice(3));
         return;
     }
+    if (command === 'restore') {
+        const { runRestore } = await import('./commands/restore.js');
+        await runRestore(process.argv.slice(3));
+        return;
+    }
+    if (command === 'backup') {
+        const { runBackup } = await import('./commands/backup.js');
+        await runBackup(process.argv.slice(3));
+        return;
+    }
+    if (command === 'doctor') {
+        const { runDoctor } = await import('./commands/doctor.js');
+        process.exitCode = await runDoctor(process.argv.slice(3));
+        // A source probe that timed out may still hold a socket; once the output has drained, leave.
+        setTimeout(() => process.exit(), 1_000).unref();
+        return;
+    }
+    if (command === 'uninstall') {
+        const { runUninstall } = await import('./commands/uninstall.js');
+        process.exitCode = await runUninstall(process.argv.slice(3));
+        return;
+    }
+    if (command === 'service') {
+        const { runService } = await import('./commands/service.js');
+        process.exitCode = await runService(process.argv.slice(3));
+        return;
+    }
     if (command === 'status') {
-        const { daemonStatus } = await import('./commands/daemon.js');
-        console.log(daemonStatus());
+        const { runStatus } = await import('./commands/control.js');
+        process.exitCode = await runStatus(process.argv.slice(3));
         return;
     }
     if (command === 'stop') {
-        const { requestDaemonStop } = await import('./commands/daemon.js');
-        requestDaemonStop();
+        const { runStop } = await import('./commands/control.js');
+        process.exitCode = await runStop(process.argv.slice(3));
         return;
     }
-    console.log('Usage: mama init | tools install | secret set <NAME> | secret list | register-owner <telegram id> | daemon | replay | backfill <file> | status | stop');
+    console.log('Usage: mama init | tools install | secret set <NAME> | secret list | register-owner <telegram id> | daemon | replay | backfill <file> | status [--json] | stop | service install|start|stop|restart|status|uninstall | uninstall [--dry-run] [--data [--toolkit]] | doctor [--json] [--offline] [--report] | logs [-n <lines>] [--follow] | backup [--include-secrets] [--logs] | restore <archive> | restore --rollback');
+}
+/** Core's refusal of a database a newer version migrated; its message is core's own text. */
+function isNewerSchema(error) {
+    return error instanceof Error && error.code === 'MAMA_SCHEMA_NEWER';
 }
 void main().catch((error) => {
-    if (error instanceof prompt_js_1.CliInputError || error instanceof config_js_1.ConfigError) {
+    if (error instanceof prompt_js_1.CliInputError || error instanceof config_js_1.ConfigError || isNewerSchema(error)) {
         console.error(error.message);
     }
     else {

package/dist/cli/index.js.map

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

package/dist/cli/launch-files.d.ts

@@ -1,10 +1,93 @@
 export declare function findExecutable(name: string): string | undefined;
+/**
+ * A Node path that survives an upgrade. Homebrew removes a version's Cellar folder when it
+ * upgrades, but keeps `<prefix>/opt/<formula>` (and `<prefix>/bin/node` for `node`) pointing at
+ * the current one, so the launch files use those when the running Node lives in the Cellar.
+ */
+export declare function stableNodePath(execPath: string, exists?: (path: string) => boolean): string;
+/** A Node path that a version manager or an upgrade removes (I6). */
+export declare function versionedNodePath(path: string): boolean;
+/** The first comment line of every start.sh that mama writes. */
+export declare const START_SCRIPT_MARKER = "# Written by mama init or mama service install; mama service install rewrites it.";
 export declare function startScript(options: {
     home: string;
     nodePath: string;
     cliPath: string;
     executablePaths: string[];
+    /** Tests name which tool folders exist; by default the ones on this machine. */
+    exists?: (path: string) => boolean;
     viewer: Record<string, string>;
+    /** config.yaml's logging.level; the core logger reads it only from MAMA_LOG_LEVEL. */
+    logLevel: string;
+    /** `export` lines carried over verbatim from the script being replaced. */
+    carried?: readonly string[];
 }): string;
+/**
+ * Where a package manager installs the owner's command-line tools: Homebrew on Apple silicon
+ * (/opt/homebrew) and on Intel Macs and most Linux installs (/usr/local). The agent's shell runs
+ * those tools (python3 with its packages, sqlite3) and expects them ahead of the system's own, as
+ * in the owner's terminal.
+ */
+export declare const TOOL_DIRECTORIES: string[];
+/**
+ * The PATH a generated start.sh sets: Node's folder, the backend's and gws's, the package
+ * manager's folders that exist on this machine, then the system's.
+ */
+export declare function startPathEntries(options: {
+    nodePath: string;
+    executablePaths: string[];
+    /** Tests name what exists; by default the folders on this machine. */
+    exists?: (path: string) => boolean;
+}): string[];
+/**
+ * What the service manager captures before the daemon writes its own rotated log (daemon.log):
+ * start.sh's own messages, a crash while Node loads, a fatal error, a native library's writes.
+ */
+export declare const CRASH_LOG_NAME = "crash.log";
+/** start.sh empties the crash log at start once it is past this size. */
+export declare const CRASH_LOG_CAP_BYTES: number;
+/** Seconds a service manager waits for a stopping daemon before it kills it. */
+export declare const SERVICE_STOP_SECONDS = 60;
+/**
+ * The LaunchAgent restarts the daemon only after a failure: a clean exit (a stop, or a refusal
+ * because another process holds the install) leaves it stopped.
+ */
 export declare function launchAgent(home: string): string;
+/**
+ * The systemd user unit, with the same restart policy as the LaunchAgent. `%h` is the home folder,
+ * expanded by systemd per argument, so a path with spaces stays one argument. KillMode=mixed sends
+ * the stop signal to the daemon alone, which stops its children in order; anything left is killed
+ * when the stop times out.
+ */
+export declare function systemdUnit(): string;
+/** What an existing start.sh holds that a regenerated one would or would not reproduce. */
+export interface StartScriptReading {
+    /** Written by mama (it carries the marker line). */
+    readonly generated: boolean;
+    /** `export` lines kept verbatim, except PATH and MAMA_LOG_LEVEL, which are written anew. */
+    readonly carried: string[];
+    readonly path: string | null;
+    readonly logLevel: string | null;
+    readonly exec: string | null;
+    /** Other lines with an effect (assignments, commands) that the new script does not have. */
+    readonly notReproduced: string[];
+    /** It sources this install's auth.env with the generated line. */
+    readonly loadsAuthEnv: boolean;
+}
+/**
+ * Split a start.sh line into words as sh does before expansion: a `#` starting a word ends the
+ * line, single quotes are literal, double
+ * quotes keep their text (a backslash escapes `"`, `\\`, `$` and a backtick), and a backslash
+ * outside quotes escapes the next character. Variables stay as written.
+ */
+export declare function shellWords(line: string): string[];
+/** The PATH entries an `export PATH=` value names, with `$HOME` and `~` read as `home`. */
+export declare function startPathValue(value: string, home: string): string[];
+/** The values a start.sh's carried `export` lines set, unquoted. */
+export declare function startExports(reading: StartScriptReading): Record<string, string>;
+/**
+ * Read a start.sh against what this install's generated one holds. Only exact generated lines
+ * count as reproduced: a changed `cd` or a different sourced file is reported, not dropped.
+ */
+export declare function readStartScript(script: string, home: string): StartScriptReading;
 //# sourceMappingURL=launch-files.d.ts.map

package/dist/cli/launch-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-files.d.ts","sourceRoot":"","sources":["../../src/cli/launch-files.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY/D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,GAAG,MAAM,CAyBT;AAWD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAehD"}
+{"version":3,"file":"launch-files.d.ts","sourceRoot":"","sources":["../../src/cli/launch-files.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,MAAM,CASR;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,sFACqD,CAAC;AAEtF,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,GAAG,MAAM,CAmBT;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UAA0C,CAAC;AAExE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC,GAAG,MAAM,EAAE,CAWX;AAWD;;;GAGG;AACH,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAe/C,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAkBpC;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmCjD;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKpE;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA2ChF"}