plexus-agent-config 0.0.1

package/node_modules/plexus-agent-config-core/dist/agents/inspect.js

@@ -0,0 +1,169 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { pathExists } from "../store/fs-utils.js";
+import { AGENT_DISPLAY_NAMES, AGENT_PATHS, AGENT_ROOTS } from "../store/paths.js";
+import { isAgentInstalled } from "./detect.js";
+async function statFile(p) {
+    const status = { path: p, exists: false, isSymlink: false };
+    try {
+        const lst = await fs.lstat(p);
+        status.exists = true;
+        status.isSymlink = lst.isSymbolicLink();
+        if (status.isSymlink) {
+            try {
+                const t = await fs.readlink(p);
+                status.linkTarget = path.isAbsolute(t) ? t : path.resolve(path.dirname(p), t);
+            }
+            catch {
+                // ignore
+            }
+        }
+        try {
+            const s = await fs.stat(p); // follows symlink
+            status.size = s.size;
+            status.mtime = s.mtime.toISOString();
+        }
+        catch {
+            // dangling symlink
+        }
+    }
+    catch {
+        // not present
+    }
+    return status;
+}
+async function listSkills(skillsDir) {
+    if (!(await pathExists(skillsDir)))
+        return [];
+    try {
+        const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+        const out = [];
+        for (const entry of entries) {
+            // Skip OS noise and Plexus's own internal backup folders.
+            if (entry.name.startsWith("."))
+                continue;
+            if (entry.name.includes(".plexus-backup-"))
+                continue;
+            const full = path.join(skillsDir, entry.name);
+            let isSymlink = false;
+            let linkTarget;
+            try {
+                const lst = await fs.lstat(full);
+                isSymlink = lst.isSymbolicLink();
+                if (isSymlink) {
+                    const t = await fs.readlink(full);
+                    linkTarget = path.isAbsolute(t) ? t : path.resolve(path.dirname(full), t);
+                }
+            }
+            catch {
+                continue;
+            }
+            // Treat as skill if dir or symlink-to-dir.
+            const skillMd = path.join(full, "SKILL.md");
+            const hasSkillMd = await pathExists(skillMd);
+            out.push({
+                id: entry.name,
+                path: full,
+                isSymlink,
+                linkTarget,
+                hasSkillMd,
+            });
+        }
+        return out.sort((a, b) => a.id.localeCompare(b.id));
+    }
+    catch {
+        return [];
+    }
+}
+export function instructionsForAgent(agentId) {
+    const root = AGENT_ROOTS[agentId];
+    switch (agentId) {
+        case "claude-code":
+            return [
+                {
+                    label: "CLAUDE.md (user-level memory)",
+                    filename: "CLAUDE.md",
+                    abs: path.join(root, "CLAUDE.md"),
+                },
+            ];
+        case "cursor":
+            return [
+                {
+                    label: "AGENTS.md (user-level)",
+                    filename: "AGENTS.md",
+                    abs: path.join(root, "AGENTS.md"),
+                },
+            ];
+        case "codex":
+            return [
+                {
+                    label: "AGENTS.md (user-level)",
+                    filename: "AGENTS.md",
+                    abs: path.join(root, "AGENTS.md"),
+                },
+            ];
+        case "gemini-cli":
+            return [
+                {
+                    label: "GEMINI.md (user-level)",
+                    filename: "GEMINI.md",
+                    abs: path.join(root, "GEMINI.md"),
+                },
+            ];
+        case "qwen-code":
+            return [
+                {
+                    label: "QWEN.md (user-level)",
+                    filename: "QWEN.md",
+                    abs: path.join(root, "QWEN.md"),
+                },
+            ];
+        case "factory-droid":
+            return [
+                {
+                    label: "AGENTS.md (user-level)",
+                    filename: "AGENTS.md",
+                    abs: path.join(root, "AGENTS.md"),
+                },
+            ];
+    }
+}
+export async function inspectAgent(agentId) {
+    const caps = AGENT_PATHS[agentId];
+    const root = AGENT_ROOTS[agentId];
+    const installed = isAgentInstalled(agentId);
+    const [mcpFile, skillsDir] = await Promise.all([
+        statFile(caps.mcpPath),
+        statFile(caps.skillsDir),
+    ]);
+    const skills = caps.skills ? await listSkills(caps.skillsDir) : [];
+    const instructionFiles = [];
+    for (const ins of instructionsForAgent(agentId)) {
+        instructionFiles.push({
+            label: ins.label,
+            filename: ins.filename,
+            status: await statFile(ins.abs),
+        });
+    }
+    return {
+        id: agentId,
+        displayName: AGENT_DISPLAY_NAMES[agentId],
+        rootDir: root,
+        installed,
+        mcpFile,
+        mcpFileMode: caps.mcpFileMode ?? "shared",
+        skillsDir,
+        skills,
+        instructionFiles,
+    };
+}
+/** Read a file (small text; the UI only enables editing for instruction files & SKILL.md). */
+export async function readTextFile(absPath) {
+    return fs.readFile(absPath, "utf8");
+}
+/** Write a file, creating parent dir as needed. (Caller is responsible for backup if it cares.) */
+export async function writeTextFile(absPath, content) {
+    await fs.mkdir(path.dirname(absPath), { recursive: true });
+    await fs.writeFile(absPath, content, "utf8");
+}
+//# sourceMappingURL=inspect.js.map

package/node_modules/plexus-agent-config-core/dist/agents/inspect.js.map

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

package/node_modules/plexus-agent-config-core/dist/backup/index.d.ts

@@ -0,0 +1,70 @@
+import type { AgentId } from "../types.js";
+/** Where collision backups (from placeLinkOrCopy) end up. */
+export declare const COLLISION_BACKUP_ROOT: string;
+/** Where one-time-quarantined `.plexus-backup-*` residue ends up. */
+export declare const LEGACY_RESIDUE_ROOT: string;
+/**
+ * Plexus snapshots every agent's native MCP config file before any sync write.
+ *
+ * Snapshots live under `~/.config/plexus/backups/<ISO-timestamp>/` so a user
+ * can always restore the previous state with `cp` if Plexus made a wrong
+ * decision. We deliberately do NOT back up skill directories: skills are
+ * already symlinks to the Plexus store, and doubling the disk usage on every
+ * toggle would be expensive and rarely useful.
+ */
+export interface BackupEntry {
+    agent: AgentId;
+    /** Path of the snapshotted file inside the backup directory. */
+    backupPath: string;
+    /** Original path of the file we copied. */
+    originalPath: string;
+    /** Was the original a symlink? Lets restore reproduce the link. */
+    wasSymlink: boolean;
+    /** If symlink, the link target at snapshot time. */
+    linkTarget?: string;
+}
+export interface BackupSnapshot {
+    /** Backup directory (one per snapshot). */
+    dir: string;
+    /** ISO timestamp identifier. */
+    id: string;
+    entries: BackupEntry[];
+}
+export declare function snapshotAgentConfigs(opts?: {
+    reason?: string;
+}): Promise<BackupSnapshot>;
+export declare function listBackups(): Promise<BackupSnapshot[]>;
+/**
+ * Snapshot a single file (e.g. CLAUDE.md) before edit. Stored alongside the
+ * regular sync snapshots so the user has one consistent recovery surface.
+ */
+export declare function snapshotSingleFile(filePath: string, reason?: string): Promise<string | null>;
+/**
+ * Move a colliding file/dir into the central backups area instead of leaving
+ * `<name>.plexus-backup-<ts>` debris in the agent's own directory.
+ *
+ * Called by adapter `placeLinkOrCopy` whenever it needs to evict a real
+ * file/dir before placing a symlink.
+ */
+export declare function quarantineCollision(opts: {
+    agent: AgentId | "unknown";
+    sourcePath: string;
+}): Promise<string | null>;
+/**
+ * One-shot cleanup: scan every agent's skills dir for `.plexus-backup-*`
+ * residue (left by old versions of placeLinkOrCopy) and quarantine them
+ * into the central backups area. Idempotent.
+ */
+export declare function cleanupLegacyResidue(): Promise<{
+    moved: Array<{
+        agent: AgentId;
+        from: string;
+        to: string;
+    }>;
+}>;
+/** Restore one snapshot by copying every backed-up file back over the original. */
+export declare function restoreSnapshot(id: string): Promise<{
+    restored: number;
+    errors: string[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/plexus-agent-config-core/dist/backup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backup/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,QAAiD,CAAC;AACpF,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,QAAqD,CAAC;AAEtF;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AA2BD,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmD1B;AAqBD,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAuB7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBzB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC,CA4BD;AAED,mFAAmF;AACnF,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAwBD"}

package/node_modules/plexus-agent-config-core/dist/backup/index.js

@@ -0,0 +1,258 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureDir, pathExists } from "../store/fs-utils.js";
+import { AGENT_PATHS, ALL_AGENTS, PLEXUS_PATHS } from "../store/paths.js";
+/** Where collision backups (from placeLinkOrCopy) end up. */
+export const COLLISION_BACKUP_ROOT = path.join(PLEXUS_PATHS.backups, "_collisions");
+/** Where one-time-quarantined `.plexus-backup-*` residue ends up. */
+export const LEGACY_RESIDUE_ROOT = path.join(PLEXUS_PATHS.backups, "_legacy-residue");
+const KEEP = 20;
+const SNAPSHOT_ID_RE = /^\d{4}-\d{2}-\d{2}T/;
+async function createSnapshotDir() {
+    await ensureDir(PLEXUS_PATHS.backups);
+    const base = new Date().toISOString().replace(/[:.]/g, "-");
+    for (let i = 0; i < 1000; i += 1) {
+        const id = i === 0 ? base : `${base}-${String(i).padStart(3, "0")}`;
+        const dir = path.join(PLEXUS_PATHS.backups, id);
+        try {
+            await fs.mkdir(dir, { recursive: false });
+            return { id, dir };
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+        }
+    }
+    throw new Error(`Could not allocate a unique backup directory for ${base}`);
+}
+function backupFileName(filePath) {
+    const parsed = path.parse(filePath);
+    const hash = crypto.createHash("sha256").update(path.resolve(filePath)).digest("hex").slice(0, 8);
+    return `${parsed.name}.${hash}${parsed.ext || ".bak"}`;
+}
+export async function snapshotAgentConfigs(opts) {
+    const { id, dir } = await createSnapshotDir();
+    if (opts?.reason) {
+        await fs.writeFile(path.join(dir, "_reason.txt"), opts.reason, "utf8").catch(() => { });
+    }
+    const entries = [];
+    for (const agentId of ALL_AGENTS) {
+        const caps = AGENT_PATHS[agentId];
+        if (!caps.mcp)
+            continue;
+        if (!(await pathExists(caps.mcpPath)))
+            continue;
+        let wasSymlink = false;
+        let linkTarget;
+        try {
+            const lst = await fs.lstat(caps.mcpPath);
+            wasSymlink = lst.isSymbolicLink();
+            if (wasSymlink)
+                linkTarget = await fs.readlink(caps.mcpPath);
+        }
+        catch {
+            continue;
+        }
+        const ext = path.extname(caps.mcpPath) || ".bak";
+        const fname = `${agentId}-mcp${ext}`;
+        const backupPath = path.join(dir, fname);
+        try {
+            // Always copy the resolved file content (so the backup is self-contained).
+            const content = await fs.readFile(caps.mcpPath);
+            await fs.writeFile(backupPath, content);
+            entries.push({
+                agent: agentId,
+                backupPath,
+                originalPath: caps.mcpPath,
+                wasSymlink,
+                linkTarget,
+            });
+        }
+        catch {
+            // best-effort; skip agents we can't read
+        }
+    }
+    // Write a manifest so a human can interpret a backup dir without grepping.
+    await fs.writeFile(path.join(dir, "manifest.json"), JSON.stringify({ id, createdAt: new Date().toISOString(), entries }, null, 2), "utf8");
+    await pruneOldBackups(KEEP);
+    return { dir, id, entries };
+}
+async function pruneOldBackups(keep) {
+    try {
+        const ents = await fs.readdir(PLEXUS_PATHS.backups, { withFileTypes: true });
+        const dirs = ents
+            .filter((e) => e.isDirectory() && SNAPSHOT_ID_RE.test(e.name))
+            .map((e) => e.name)
+            .sort()
+            .reverse();
+        for (const old of dirs.slice(keep)) {
+            await fs.rm(path.join(PLEXUS_PATHS.backups, old), {
+                recursive: true,
+                force: true,
+            });
+        }
+    }
+    catch {
+        // ignore — pruning is best-effort
+    }
+}
+export async function listBackups() {
+    try {
+        const ents = await fs.readdir(PLEXUS_PATHS.backups, { withFileTypes: true });
+        const dirs = ents
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort()
+            .reverse();
+        const out = [];
+        for (const d of dirs) {
+            const dir = path.join(PLEXUS_PATHS.backups, d);
+            try {
+                const raw = await fs.readFile(path.join(dir, "manifest.json"), "utf8");
+                const m = JSON.parse(raw);
+                out.push({ dir, id: m.id, entries: m.entries });
+            }
+            catch {
+                out.push({ dir, id: d, entries: [] });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Snapshot a single file (e.g. CLAUDE.md) before edit. Stored alongside the
+ * regular sync snapshots so the user has one consistent recovery surface.
+ */
+export async function snapshotSingleFile(filePath, reason) {
+    if (!(await pathExists(filePath)))
+        return null;
+    const { id, dir } = await createSnapshotDir();
+    if (reason) {
+        await fs.writeFile(path.join(dir, "_reason.txt"), reason, "utf8").catch(() => { });
+    }
+    const fname = backupFileName(filePath);
+    const backupPath = path.join(dir, fname);
+    try {
+        const content = await fs.readFile(filePath);
+        await fs.writeFile(backupPath, content);
+        await fs.writeFile(path.join(dir, "manifest.json"), JSON.stringify({
+            id,
+            createdAt: new Date().toISOString(),
+            entries: [{ agent: null, backupPath, originalPath: filePath, wasSymlink: false }],
+        }, null, 2), "utf8");
+        await pruneOldBackups(KEEP);
+        return dir;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Move a colliding file/dir into the central backups area instead of leaving
+ * `<name>.plexus-backup-<ts>` debris in the agent's own directory.
+ *
+ * Called by adapter `placeLinkOrCopy` whenever it needs to evict a real
+ * file/dir before placing a symlink.
+ */
+export async function quarantineCollision(opts) {
+    if (!(await pathExists(opts.sourcePath)))
+        return null;
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
+    const destDir = path.join(COLLISION_BACKUP_ROOT, ts, opts.agent);
+    await ensureDir(destDir);
+    const destPath = path.join(destDir, path.basename(opts.sourcePath));
+    try {
+        await fs.rename(opts.sourcePath, destPath);
+        return destPath;
+    }
+    catch {
+        // Cross-device or permission — fall back to copy + delete.
+        try {
+            const lst = await fs.lstat(opts.sourcePath);
+            if (lst.isDirectory()) {
+                await fs.cp(opts.sourcePath, destPath, { recursive: true });
+                await fs.rm(opts.sourcePath, { recursive: true, force: true });
+            }
+            else {
+                await fs.copyFile(opts.sourcePath, destPath);
+                await fs.unlink(opts.sourcePath);
+            }
+            return destPath;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * One-shot cleanup: scan every agent's skills dir for `.plexus-backup-*`
+ * residue (left by old versions of placeLinkOrCopy) and quarantine them
+ * into the central backups area. Idempotent.
+ */
+export async function cleanupLegacyResidue() {
+    const moved = [];
+    for (const agentId of ALL_AGENTS) {
+        const caps = AGENT_PATHS[agentId];
+        if (!caps.skills)
+            continue;
+        if (!(await pathExists(caps.skillsDir)))
+            continue;
+        let entries;
+        try {
+            entries = await fs.readdir(caps.skillsDir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (!name.includes(".plexus-backup-"))
+                continue;
+            const src = path.join(caps.skillsDir, name);
+            const ts = new Date().toISOString().replace(/[:.]/g, "-");
+            const destDir = path.join(LEGACY_RESIDUE_ROOT, ts, agentId);
+            await ensureDir(destDir);
+            const dest = path.join(destDir, name);
+            try {
+                await fs.rename(src, dest);
+                moved.push({ agent: agentId, from: src, to: dest });
+            }
+            catch {
+                // best effort
+            }
+        }
+    }
+    return { moved };
+}
+/** Restore one snapshot by copying every backed-up file back over the original. */
+export async function restoreSnapshot(id) {
+    const snapshots = await listBackups();
+    const snap = snapshots.find((s) => s.id === id);
+    if (!snap)
+        return { restored: 0, errors: [`No snapshot with id ${id}`] };
+    const errors = [];
+    let restored = 0;
+    for (const entry of snap.entries) {
+        try {
+            // Remove existing file/symlink first to avoid writing through links.
+            try {
+                await fs.unlink(entry.originalPath);
+            }
+            catch {
+                // ignore
+            }
+            const content = await fs.readFile(entry.backupPath);
+            await ensureDir(path.dirname(entry.originalPath));
+            await fs.writeFile(entry.originalPath, content);
+            restored += 1;
+        }
+        catch (err) {
+            errors.push(`${entry.agent}: ${err.message}`);
+        }
+    }
+    return { restored, errors };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/plexus-agent-config-core/dist/backup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backup/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG1E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACpF,qEAAqE;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAgCtF,MAAM,IAAI,GAAG,EAAE,CAAC;AAChB,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAE7C,KAAK,UAAU,iBAAiB;IAC9B,MAAM,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QAClE,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAE1C;IACC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE9C,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,SAAS;QACxB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAAE,SAAS;QAEhD,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzC,UAAU,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;YAClC,IAAI,UAAU;gBAAE,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC;QACjD,MAAM,KAAK,GAAG,GAAG,OAAO,OAAO,GAAG,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,2EAA2E;YAC3E,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,OAAO;gBACd,UAAU;gBACV,YAAY,EAAE,IAAI,CAAC,OAAO;gBAC1B,UAAU;gBACV,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAC7E,MAAM,CACP,CAAC;IAEF,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aAC7D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE;aACN,OAAO,EAAE,CAAC;QACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;gBAChD,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE;aACN,OAAO,EAAE,CAAC;QACb,MAAM,GAAG,GAAqB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;gBACvE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2C,CAAC;gBACpE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,MAAe;IAEf,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC9C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAC/B,IAAI,CAAC,SAAS,CACZ;YACE,EAAE;YACF,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;SAClF,EACD,IAAI,EACJ,CAAC,CACF,EACD,MAAM,CACP,CAAC;QACF,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAGzC;IACC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;QAC3D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5D,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IAGxC,MAAM,KAAK,GAAwD,EAAE,CAAC;IACtE,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC3B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAE,SAAS;QAClD,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAAE,SAAS;YAChD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAI9C,MAAM,SAAS,GAAG,MAAM,WAAW,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,uBAAuB,EAAE,EAAE,CAAC,EAAE,CAAC;IAEzE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,qEAAqE;YACrE,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChD,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/node_modules/plexus-agent-config-core/dist/debug/index.d.ts

@@ -0,0 +1,71 @@
+import type { AgentId } from "../types.js";
+/**
+ * "Debug snapshot" — a one-shot dump of every path Plexus cares about.
+ *
+ * Designed to be copy/pasted into a chat with a maintainer when something
+ * goes wrong (sync didn't take effect, symlink looks weird, file size is 0,
+ * etc.). It deliberately avoids reading file *contents* — only metadata —
+ * so secrets in `~/.claude.json` etc. never leak.
+ */
+export interface PathStat {
+    /** Absolute path. */
+    path: string;
+    /** Path with `$HOME` collapsed to `~`, for readable output. */
+    display: string;
+    exists: boolean;
+    /** "file" | "dir" | "symlink" | "missing" */
+    kind: "file" | "dir" | "symlink" | "missing";
+    /** If symlink: the absolute target. */
+    linkTarget?: string;
+    /** If symlink: whether the target currently exists. */
+    linkTargetExists?: boolean;
+    /** Size in bytes (resolved through symlink). */
+    size?: number;
+    /** ISO mtime (resolved through symlink). */
+    mtime?: string;
+    /** For directories: number of entries (skipping dotfiles & .plexus-backup-*). */
+    entryCount?: number;
+}
+export interface DirectoryListing {
+    dir: PathStat;
+    entries: PathStat[];
+}
+export interface AgentDebugBlock {
+    id: AgentId;
+    displayName: string;
+    installed: boolean;
+    mcpFileMode: "exclusive" | "shared";
+    root: PathStat;
+    mcpFile: PathStat;
+    instructionFile: PathStat | null;
+    skillsDir: PathStat;
+    skillEntries: PathStat[];
+}
+export interface PlexusStoreBlock {
+    root: PathStat;
+    config: PathStat;
+    team: PathStat;
+    personal: PathStat;
+    cacheMcp: PathStat;
+    backups: PathStat;
+    teamMcpServers: PathStat;
+    personalMcpServers: PathStat;
+    teamSkillEntries: PathStat[];
+    personalSkillEntries: PathStat[];
+    cacheMcpEntries: PathStat[];
+    backupCount: number;
+}
+export interface DebugSnapshot {
+    generatedAt: string;
+    host: {
+        platform: string;
+        release: string;
+        node: string;
+        home: string;
+    };
+    plexus: PlexusStoreBlock;
+    agents: AgentDebugBlock[];
+}
+export declare function collectDebugSnapshot(): Promise<DebugSnapshot>;
+export declare function formatDebugSnapshot(s: DebugSnapshot, version?: string): string;
+//# sourceMappingURL=index.d.ts.map

package/node_modules/plexus-agent-config-core/dist/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IACvB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC;IAClB,eAAe,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC;IAClB,cAAc,EAAE,QAAQ,CAAC;IACzB,kBAAkB,EAAE,QAAQ,CAAC;IAC7B,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,oBAAoB,EAAE,QAAQ,EAAE,CAAC;IACjC,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AA8JD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CAcnE;AAoFD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAe9E"}