@mragentix/cli 4.2.37

package/dist/core/session-manager.js

@@ -0,0 +1,326 @@
+import fs from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { createInterface } from "node:readline";
+import path from "node:path";
+import crypto from "node:crypto";
+// ── Session Manager ────────────────────────────────────────
+function encodeCwd(cwd) {
+    return cwd.replace(/[\\/]/g, "_").replace(/:/g, "").replace(/^_/, "");
+}
+export class SessionManager {
+    sessionsDir;
+    constructor(sessionsDir) {
+        this.sessionsDir = sessionsDir;
+    }
+    dirForCwd(cwd) {
+        return path.join(this.sessionsDir, encodeCwd(cwd));
+    }
+    async create(cwd, provider, model) {
+        const id = crypto.randomUUID();
+        const timestamp = new Date().toISOString();
+        const dir = this.dirForCwd(cwd);
+        await fs.mkdir(dir, { recursive: true });
+        const fileName = `${timestamp.replace(/[:.]/g, "-")}_${id.slice(0, 8)}.jsonl`;
+        const filePath = path.join(dir, fileName);
+        const header = {
+            type: "session",
+            version: 2,
+            id,
+            timestamp,
+            cwd,
+            provider,
+            model,
+            leafId: null,
+        };
+        await fs.appendFile(filePath, JSON.stringify(header) + "\n", "utf-8");
+        return { id, path: filePath, header };
+    }
+    async load(sessionPath) {
+        // Stream the JSONL file line-by-line instead of loading the entire
+        // file into memory. For large sessions (100MB+) this avoids holding
+        // the raw string, the split array, and the parsed objects all at once.
+        let header = null;
+        const entries = [];
+        const rl = createInterface({
+            input: createReadStream(sessionPath, { encoding: "utf-8" }),
+            crlfDelay: Infinity,
+        });
+        for await (const line of rl) {
+            if (!line)
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.type === "session") {
+                    if (parsed.version === 2) {
+                        header = parsed;
+                    }
+                    else {
+                        // Upgrade v1 to v2
+                        const v1 = parsed;
+                        header = {
+                            type: "session",
+                            version: 2,
+                            id: v1.id,
+                            timestamp: v1.timestamp,
+                            cwd: v1.cwd,
+                            provider: v1.provider,
+                            model: v1.model,
+                            leafId: null,
+                        };
+                    }
+                }
+                else if (parsed.type === "message") {
+                    // v1 compat: entries without id/parentId
+                    const entry = parsed;
+                    if (!entry.id) {
+                        entry.id = crypto.randomUUID();
+                        entry.parentId = null;
+                    }
+                    entries.push(entry);
+                }
+                else {
+                    entries.push(parsed);
+                }
+            }
+            catch {
+                // Skip malformed JSON lines — a corrupt line shouldn't crash the session
+            }
+        }
+        if (!header) {
+            throw new Error(`Invalid session file: no header found in ${sessionPath}`);
+        }
+        return { header, entries };
+    }
+    async list(cwd) {
+        const dir = this.dirForCwd(cwd);
+        let files;
+        try {
+            files = await fs.readdir(dir);
+        }
+        catch {
+            return [];
+        }
+        const sessions = [];
+        for (const file of files) {
+            if (!file.endsWith(".jsonl"))
+                continue;
+            const filePath = path.join(dir, file);
+            try {
+                // Stream line-by-line to avoid loading entire file for listing
+                const rl = createInterface({
+                    input: createReadStream(filePath, { encoding: "utf-8" }),
+                    crlfDelay: Infinity,
+                });
+                let first = null;
+                let messageCount = 0;
+                for await (const line of rl) {
+                    if (!line)
+                        continue;
+                    try {
+                        const parsed = JSON.parse(line);
+                        if (!first) {
+                            if (parsed.type !== "session")
+                                break;
+                            first = parsed;
+                        }
+                        else if (parsed.type === "message") {
+                            messageCount++;
+                        }
+                    }
+                    catch {
+                        // Skip malformed lines
+                    }
+                }
+                if (!first || first.type !== "session")
+                    continue;
+                sessions.push({
+                    id: first.id,
+                    path: filePath,
+                    timestamp: first.timestamp,
+                    cwd: first.cwd,
+                    messageCount,
+                });
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+        sessions.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        return sessions;
+    }
+    async getMostRecent(cwd) {
+        const sessions = await this.list(cwd);
+        const withMessages = sessions.find((s) => s.messageCount > 0);
+        return withMessages?.path ?? null;
+    }
+    async appendEntry(sessionPath, entry) {
+        await fs.appendFile(sessionPath, JSON.stringify(entry) + "\n", "utf-8");
+    }
+    async updateLeaf(sessionPath, leafId) {
+        // Read only the first line (the header) instead of loading the entire file.
+        // For large session files (100MB+), this avoids a full file read+write.
+        const fd = await fs.open(sessionPath, "r+");
+        try {
+            // Read enough bytes to cover the header line (typically <500 bytes)
+            const buf = Buffer.alloc(4096);
+            const { bytesRead } = await fd.read(buf, 0, 4096, 0);
+            const chunk = buf.toString("utf-8", 0, bytesRead);
+            const newlineIdx = chunk.indexOf("\n");
+            if (newlineIdx === -1)
+                return;
+            const headerLine = chunk.slice(0, newlineIdx);
+            const header = JSON.parse(headerLine);
+            if (header.type !== "session")
+                return;
+            header.leafId = leafId;
+            const newHeaderLine = JSON.stringify(header);
+            if (newHeaderLine.length === headerLine.length) {
+                // Same length — overwrite in place (fast path)
+                await fd.write(newHeaderLine, 0, "utf-8");
+            }
+            else {
+                // Different length — must rewrite the file (rare: only on first leafId set)
+                await fd.close();
+                const content = await fs.readFile(sessionPath, "utf-8");
+                const firstNewline = content.indexOf("\n");
+                await fs.writeFile(sessionPath, newHeaderLine + content.slice(firstNewline), "utf-8");
+                return;
+            }
+        }
+        finally {
+            // fd.close() may have already been called in the else branch above,
+            // but calling it again on a closed handle is a no-op in Node >= 20.
+            await fd.close().catch(() => { });
+        }
+    }
+    /**
+     * Get messages for the current branch. If leafId is set, walks the
+     * DAG from leaf to root. Otherwise returns all entries linearly.
+     */
+    getMessages(entries, leafId) {
+        const branch = leafId ? this.getBranch(entries, leafId) : entries;
+        const messages = branch
+            .filter((e) => e.type === "message")
+            .map((e) => e.message)
+            .filter((m) => m.role !== "system");
+        // Repair orphaned tool_use blocks that lack matching tool_result messages.
+        // This can happen when a session is interrupted mid-tool-execution.
+        return SessionManager.repairToolPairs(messages);
+    }
+    /**
+     * Ensure every assistant message with tool_use blocks is followed by a tool
+     * message containing matching tool_result entries. Inserts synthetic
+     * tool_result messages where needed to prevent Anthropic API 400 errors.
+     */
+    static repairToolPairs(messages) {
+        const repaired = [];
+        for (let i = 0; i < messages.length; i++) {
+            const msg = messages[i];
+            repaired.push(msg);
+            if (msg.role !== "assistant")
+                continue;
+            const content = Array.isArray(msg.content) ? msg.content : [];
+            const toolUseIds = content
+                .filter((p) => p.type === "tool_call")
+                .map((p) => p.id);
+            if (toolUseIds.length === 0)
+                continue;
+            // Check if the next message is a tool message with matching results
+            const next = messages[i + 1];
+            if (next?.role === "tool" && Array.isArray(next.content)) {
+                const existingIds = new Set(next.content.map((r) => r.toolCallId));
+                const missing = toolUseIds.filter((id) => !existingIds.has(id));
+                if (missing.length > 0) {
+                    // Patch the existing tool message with missing results
+                    for (const id of missing) {
+                        next.content.push({
+                            type: "tool_result",
+                            toolCallId: id,
+                            content: "Tool execution was interrupted.",
+                            isError: true,
+                        });
+                    }
+                }
+            }
+            else {
+                // No tool message follows — insert a synthetic one
+                repaired.push({
+                    role: "tool",
+                    content: toolUseIds.map((id) => ({
+                        type: "tool_result",
+                        toolCallId: id,
+                        content: "Tool execution was interrupted.",
+                        isError: true,
+                    })),
+                });
+            }
+        }
+        return repaired;
+    }
+    /**
+     * Build a lookup Map from entry id → entry. Reusable across multiple
+     * getBranch / listBranches calls on the same entry set.
+     */
+    buildIndex(entries) {
+        return new Map(entries.map((e) => [e.id, e]));
+    }
+    /**
+     * Walk the DAG from a leaf entry back to the root, returning entries
+     * in chronological order (root → leaf). This is the "branch" — the
+     * path through the conversation tree that leads to the given leaf.
+     *
+     * Accepts an optional pre-built index to avoid redundant Map allocations
+     * when called in a loop.
+     */
+    getBranch(entries, leafId, byId) {
+        if (!leafId)
+            return entries;
+        const index = byId ?? this.buildIndex(entries);
+        const branch = [];
+        let current = leafId;
+        while (current) {
+            const entry = index.get(current);
+            if (!entry)
+                break;
+            branch.push(entry);
+            current = entry.parentId;
+        }
+        return branch.reverse();
+    }
+    /**
+     * List all branches (leaf nodes) in a session's entry DAG.
+     * A leaf is any entry whose id is not referenced as a parentId by any other entry.
+     */
+    listBranches(entries) {
+        if (entries.length === 0)
+            return [];
+        // Build shared index once — reused by every getBranch call below
+        const byId = this.buildIndex(entries);
+        // Find all ids that are referenced as parentId
+        const parentIds = new Set(entries.map((e) => e.parentId).filter(Boolean));
+        // Leaves = entries whose id is NOT in parentIds
+        const leaves = entries.filter((e) => !parentIds.has(e.id));
+        // Build childCount once — was previously rebuilt per-leaf (O(n²))
+        const childCount = new Map();
+        for (const e of entries) {
+            childCount.set(e.parentId, (childCount.get(e.parentId) ?? 0) + 1);
+        }
+        return leaves.map((leaf) => {
+            const branch = this.getBranch(entries, leaf.id, byId);
+            let branchPointId = branch[0]?.id ?? leaf.id;
+            for (const e of branch) {
+                if ((childCount.get(e.parentId) ?? 0) > 1) {
+                    branchPointId = e.id;
+                    break;
+                }
+            }
+            return {
+                branchPointId,
+                leafId: leaf.id,
+                entryCount: branch.length,
+                timestamp: branch[0]?.timestamp ?? leaf.timestamp,
+            };
+        });
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/core/session-manager.js.map

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

package/dist/core/settings-manager.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+declare const SettingsSchema: z.ZodObject<{
+    autoCompact: z.ZodDefault<z.ZodBoolean>;
+    compactThreshold: z.ZodDefault<z.ZodNumber>;
+    defaultProvider: z.ZodDefault<z.ZodEnum<{
+        anthropic: "anthropic";
+        openai: "openai";
+        glm: "glm";
+        moonshot: "moonshot";
+    }>>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+    thinkingEnabled: z.ZodDefault<z.ZodBoolean>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        max: "max";
+    }>>;
+    theme: z.ZodDefault<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+        auto: "auto";
+    }>>;
+    showTokenUsage: z.ZodDefault<z.ZodBoolean>;
+    showThinking: z.ZodDefault<z.ZodBoolean>;
+    enabledTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type Settings = z.infer<typeof SettingsSchema>;
+export declare const DEFAULT_SETTINGS: Settings;
+export declare class SettingsManager {
+    private settings;
+    private filePath;
+    private loaded;
+    constructor(filePath?: string);
+    load(): Promise<Settings>;
+    save(): Promise<void>;
+    get<K extends keyof Settings>(key: K): Settings[K];
+    set<K extends keyof Settings>(key: K, value: Settings[K]): Promise<void>;
+    getAll(): Settings;
+}
+export {};
+//# sourceMappingURL=settings-manager.d.ts.map

package/dist/core/settings-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-manager.d.ts","sourceRoot":"","sources":["../../src/core/settings-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYlB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,QAS9B,CAAC;AAIF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAI5C,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,MAAM,IAAI,QAAQ;CAGnB"}

package/dist/core/settings-manager.js

@@ -0,0 +1,64 @@
+import fs from "node:fs/promises";
+import { z } from "zod";
+import { getAppPaths } from "../config.js";
+// ── Settings Schema ────────────────────────────────────────
+const SettingsSchema = z.object({
+    autoCompact: z.boolean().default(true),
+    compactThreshold: z.number().min(0.1).max(1.0).default(0.8),
+    defaultProvider: z.enum(["anthropic", "openai", "glm", "moonshot"]).default("anthropic"),
+    defaultModel: z.string().optional(),
+    maxTokens: z.number().int().min(256).default(16384),
+    thinkingEnabled: z.boolean().default(false),
+    thinkingLevel: z.enum(["low", "medium", "high", "max"]).optional(),
+    theme: z.enum(["auto", "dark", "light"]).default("auto"),
+    showTokenUsage: z.boolean().default(true),
+    showThinking: z.boolean().default(true),
+    enabledTools: z.array(z.string()).optional(),
+});
+export const DEFAULT_SETTINGS = {
+    autoCompact: true,
+    compactThreshold: 0.8,
+    defaultProvider: "anthropic",
+    maxTokens: 16384,
+    thinkingEnabled: false,
+    theme: "auto",
+    showTokenUsage: true,
+    showThinking: true,
+};
+// ── Settings Manager ───────────────────────────────────────
+export class SettingsManager {
+    settings = { ...DEFAULT_SETTINGS };
+    filePath;
+    loaded = false;
+    constructor(filePath) {
+        this.filePath = filePath ?? getAppPaths().settingsFile;
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(this.filePath, "utf-8");
+            const raw = JSON.parse(content);
+            // Merge with defaults so new fields get default values
+            this.settings = SettingsSchema.parse({ ...DEFAULT_SETTINGS, ...raw });
+        }
+        catch {
+            this.settings = { ...DEFAULT_SETTINGS };
+        }
+        this.loaded = true;
+        return this.settings;
+    }
+    async save() {
+        const content = JSON.stringify(this.settings, null, 2);
+        await fs.writeFile(this.filePath, content, "utf-8");
+    }
+    get(key) {
+        return this.settings[key];
+    }
+    async set(key, value) {
+        this.settings[key] = value;
+        await this.save();
+    }
+    getAll() {
+        return { ...this.settings };
+    }
+}
+//# sourceMappingURL=settings-manager.js.map

package/dist/core/settings-manager.js.map

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

package/dist/core/skills.d.ts

@@ -0,0 +1,23 @@
+export interface Skill {
+    name: string;
+    description: string;
+    content: string;
+    source: string;
+}
+/**
+ * Discover skills from global and project-local skill directories.
+ */
+export declare function discoverSkills(options: {
+    globalSkillsDir: string;
+    projectDir?: string;
+}): Promise<Skill[]>;
+/**
+ * Parse a skill file with optional frontmatter.
+ * Supports simple key: value frontmatter between --- delimiters.
+ */
+export declare function parseSkillFile(raw: string, source: string): Skill;
+/**
+ * Format skills into a system prompt section.
+ */
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/core/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAenB;AA+BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAwBjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAW7D"}

package/dist/core/skills.js

@@ -0,0 +1,89 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Discover skills from global and project-local skill directories.
+ */
+export async function discoverSkills(options) {
+    const skills = [];
+    // Global skills: ~/.mragentix/skills/*.md
+    const globalSkills = await loadSkillsFromDir(options.globalSkillsDir, "global");
+    skills.push(...globalSkills);
+    // Project skills: {cwd}/.mragentix/skills/*.md
+    if (options.projectDir) {
+        const projectSkillsDir = path.join(options.projectDir, ".mragentix", "skills");
+        const projectSkills = await loadSkillsFromDir(projectSkillsDir, "project");
+        skills.push(...projectSkills);
+    }
+    return skills;
+}
+async function loadSkillsFromDir(dir, source) {
+    const skills = [];
+    let files;
+    try {
+        files = await fs.readdir(dir);
+    }
+    catch {
+        return skills;
+    }
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        const filePath = path.join(dir, file);
+        try {
+            const content = await fs.readFile(filePath, "utf-8");
+            const skill = parseSkillFile(content, source);
+            if (!skill.name) {
+                skill.name = path.basename(file, ".md");
+            }
+            skills.push(skill);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return skills;
+}
+/**
+ * Parse a skill file with optional frontmatter.
+ * Supports simple key: value frontmatter between --- delimiters.
+ */
+export function parseSkillFile(raw, source) {
+    let name = "";
+    let description = "";
+    let content = raw;
+    // Check for frontmatter
+    if (raw.startsWith("---")) {
+        const endIndex = raw.indexOf("---", 3);
+        if (endIndex !== -1) {
+            const frontmatter = raw.slice(3, endIndex).trim();
+            content = raw.slice(endIndex + 3).trim();
+            for (const line of frontmatter.split("\n")) {
+                const colonIndex = line.indexOf(":");
+                if (colonIndex === -1)
+                    continue;
+                const key = line.slice(0, colonIndex).trim().toLowerCase();
+                const value = line.slice(colonIndex + 1).trim();
+                if (key === "name")
+                    name = value;
+                else if (key === "description")
+                    description = value;
+            }
+        }
+    }
+    return { name, description, content, source };
+}
+/**
+ * Format skills into a system prompt section.
+ */
+export function formatSkillsForPrompt(skills) {
+    if (skills.length === 0)
+        return "";
+    const parts = ["## Skills\n"];
+    for (const skill of skills) {
+        parts.push(`### ${skill.name}${skill.description ? ` — ${skill.description}` : ""}`);
+        parts.push(skill.content);
+        parts.push("");
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/skills.js.map

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

package/dist/core/slash-commands.d.ts

@@ -0,0 +1,35 @@
+export interface SlashCommandContext {
+    switchModel: (provider: string, model: string) => Promise<void>;
+    compact: () => Promise<void>;
+    newSession: () => Promise<void>;
+    listSessions: () => Promise<string>;
+    getSettings: () => Record<string, unknown>;
+    setSetting: (key: string, value: unknown) => Promise<void>;
+    getModelList: () => string;
+    quit: () => void;
+    /** Create a branch (rewind N messages and fork). */
+    branch: (stepsBack?: number) => Promise<string>;
+    /** List all branches in the current session. */
+    listBranches: () => Promise<string>;
+}
+export interface SlashCommand {
+    name: string;
+    aliases: string[];
+    description: string;
+    usage: string;
+    execute: (args: string, context: SlashCommandContext) => Promise<string> | string;
+}
+export declare class SlashCommandRegistry {
+    private commands;
+    register(command: SlashCommand): void;
+    unregister(name: string): void;
+    get(name: string): SlashCommand | undefined;
+    getAll(): SlashCommand[];
+    parse(input: string): {
+        name: string;
+        args: string;
+    } | null;
+    execute(input: string, context: SlashCommandContext): Promise<string | null>;
+}
+export declare function createBuiltinCommands(): SlashCommand[];
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/core/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAElC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,gDAAgD;IAChD,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACnF;AAID,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAmC;IAEnD,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAOrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,MAAM,IAAI,YAAY,EAAE;IAaxB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASrD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CASnF;AAID,wBAAgB,qBAAqB,IAAI,YAAY,EAAE,CA8HtD"}