@congzhen/changewayguard 6.8.12

package/dist/agent/workspace-scanner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Workspace MD File Scanner
+ *
+ * Scans OpenClaw workspace for all .md files and categorizes them:
+ * - soul.md (agent personality)
+ * - agent.md (agent configuration)
+ * - memories/*.md (conversation memories)
+ * - heartbeat.md (task scheduler)
+ * - Other md files in workspace root
+ */
+export type FileType = "soul" | "agent" | "memory" | "task" | "skill" | "plugin" | "other";
+export interface WorkspaceFile {
+    path: string;
+    absolutePath: string;
+    content: string;
+    type: FileType;
+    sizeBytes: number;
+}
+/**
+ * Scan workspace for all .md files
+ */
+export declare function scanWorkspaceMdFiles(): Promise<WorkspaceFile[]>;
+/**
+ * Scan specific file types
+ */
+export declare function scanFilesByType(types: FileType[]): Promise<WorkspaceFile[]>;
+/**
+ * Get summary of workspace files
+ */
+export declare function getWorkspaceSummary(): Promise<{
+    totalFiles: number;
+    byType: Record<FileType, number>;
+    totalSizeBytes: number;
+}>;
+//# sourceMappingURL=workspace-scanner.d.ts.map

package/dist/agent/workspace-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-scanner.d.ts","sourceRoot":"","sources":["../../agent/workspace-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAqED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CA2BrE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGjF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAyBD"}

package/dist/agent/workspace-scanner.js

@@ -0,0 +1,137 @@
+/**
+ * Workspace MD File Scanner
+ *
+ * Scans OpenClaw workspace for all .md files and categorizes them:
+ * - soul.md (agent personality)
+ * - agent.md (agent configuration)
+ * - memories/*.md (conversation memories)
+ * - heartbeat.md (task scheduler)
+ * - Other md files in workspace root
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { openclawHome } from "./env.js";
+/**
+ * Get OpenClaw workspace directory
+ */
+function getWorkspaceDir() {
+    return openclawHome;
+}
+/**
+ * Categorize file by path
+ */
+function categorizeFile(relativePath) {
+    const lower = relativePath.toLowerCase();
+    if (lower === "soul.md")
+        return "soul";
+    if (lower === "agent.md")
+        return "agent";
+    if (lower === "heartbeat.md")
+        return "task";
+    if (lower.startsWith("memories/") || lower.startsWith("memories\\"))
+        return "memory";
+    if (lower.startsWith("skills/") || lower.startsWith("skills\\"))
+        return "skill";
+    if (lower.startsWith("plugins/") || lower.startsWith("plugins\\"))
+        return "plugin";
+    return "other";
+}
+/**
+ * Recursively find all .md files in a directory
+ */
+async function findMdFiles(dir, baseDir) {
+    const files = [];
+    try {
+        const entries = await fs.promises.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules, .git, dist, build directories
+                if (["node_modules", ".git", "dist", "build", ".cache"].includes(entry.name)) {
+                    continue;
+                }
+                // Recursively scan subdirectories
+                const subFiles = await findMdFiles(fullPath, baseDir);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                const relativePath = path.relative(baseDir, fullPath);
+                files.push(relativePath);
+            }
+        }
+    }
+    catch {
+        // Ignore permission errors, etc.
+    }
+    return files;
+}
+/**
+ * Read file content safely
+ */
+async function readFileSafe(filePath) {
+    try {
+        return await fs.promises.readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan workspace for all .md files
+ */
+export async function scanWorkspaceMdFiles() {
+    const workspaceDir = getWorkspaceDir();
+    const files = [];
+    // Find all .md files
+    const mdFiles = await findMdFiles(workspaceDir, workspaceDir);
+    // Read each file
+    for (const relativePath of mdFiles) {
+        const absolutePath = path.join(workspaceDir, relativePath);
+        const content = await readFileSafe(absolutePath);
+        if (content === null)
+            continue; // Skip unreadable files
+        const type = categorizeFile(relativePath);
+        const sizeBytes = Buffer.byteLength(content, "utf-8");
+        files.push({
+            path: relativePath,
+            absolutePath,
+            content,
+            type,
+            sizeBytes,
+        });
+    }
+    return files;
+}
+/**
+ * Scan specific file types
+ */
+export async function scanFilesByType(types) {
+    const allFiles = await scanWorkspaceMdFiles();
+    return allFiles.filter(f => types.includes(f.type));
+}
+/**
+ * Get summary of workspace files
+ */
+export async function getWorkspaceSummary() {
+    const files = await scanWorkspaceMdFiles();
+    const byType = {
+        soul: 0,
+        agent: 0,
+        memory: 0,
+        task: 0,
+        skill: 0,
+        plugin: 0,
+        other: 0,
+    };
+    let totalSizeBytes = 0;
+    for (const file of files) {
+        byType[file.type]++;
+        totalSizeBytes += file.sizeBytes;
+    }
+    return {
+        totalFiles: files.length,
+        byType,
+        totalSizeBytes,
+    };
+}
+//# sourceMappingURL=workspace-scanner.js.map

package/dist/agent/workspace-scanner.js.map

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

package/dist/dashboard-launcher.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Dashboard Launcher for MoltGuard
+ *
+ * Starts the local Dashboard in-process for monitoring agent activity.
+ * All components (MoltGuard, Gateway, Dashboard) run in the same process.
+ */
+export declare const DASHBOARD_PORT = 53667;
+/**
+ * Get the plugin's data directory
+ */
+export declare function getPluginDataDir(): string;
+interface LaunchOptions {
+    apiKey: string;
+    agentId: string;
+    coreUrl: string;
+    dataDir?: string;
+    autoStart?: boolean;
+}
+interface LaunchResult {
+    localUrl: string;
+    token: string;
+}
+/**
+ * Start the local Dashboard (in-process)
+ */
+export declare function startLocalDashboard(options: LaunchOptions): Promise<LaunchResult>;
+/**
+ * Check if Dashboard is running
+ */
+export declare function isDashboardRunning(): boolean;
+/**
+ * Get current Dashboard URL
+ */
+export declare function getDashboardUrl(): string | null;
+/**
+ * Get current token
+ */
+export declare function getDashboardToken(): string | null;
+/**
+ * Error for development mode (when build is required)
+ */
+export declare class DevModeError extends Error {
+    dashboardDir: string;
+    constructor(dashboardDir: string);
+    getInstructions(): string;
+}
+/**
+ * Stop Dashboard server
+ */
+export declare function stopLocalDashboard(): Promise<void>;
+export {};
+//# sourceMappingURL=dashboard-launcher.d.ts.map

package/dist/dashboard-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-launcher.d.ts","sourceRoot":"","sources":["../dashboard-launcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAqBpC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AA+GD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA4JvF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAClB,YAAY,EAAE,MAAM;gBAApB,YAAY,EAAE,MAAM;IAKvC,eAAe,IAAI,MAAM;CAc1B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBxD"}

package/dist/dashboard-launcher.js

@@ -0,0 +1,363 @@
+/**
+ * Dashboard Launcher for MoltGuard
+ *
+ * Starts the local Dashboard in-process for monitoring agent activity.
+ * All components (MoltGuard, Gateway, Dashboard) run in the same process.
+ */
+import crypto from "node:crypto";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+import { setDashboardPort } from "./agent/gateway-manager.js";
+import { withChangewayOpenPrefix } from "./agent/auth.js";
+import { openclawHome } from "./agent/env.js";
+import { loadJsonSync } from "./agent/fs-utils.js";
+// Dashboard state
+let dashboardRunning = false;
+let currentToken = null;
+let currentLocalUrl = null;
+let dashboardCloseFn = null;
+let startupInProgress = false;
+let startupPromise = null;
+export const DASHBOARD_PORT = 53667;
+const TOKEN_FILE = path.join(os.homedir(), ".openclaw", "credentials", "changewayguard", "dashboard-session-token");
+/**
+ * Get the package root directory
+ */
+function getPackageRoot() {
+    if (typeof import.meta !== 'undefined' && import.meta.url) {
+        const currentFile = fileURLToPath(import.meta.url);
+        const currentDir = path.dirname(currentFile);
+        if (currentDir.endsWith('dist')) {
+            return path.dirname(currentDir);
+        }
+        return currentDir;
+    }
+    if (__dirname.endsWith('dist')) {
+        return path.dirname(__dirname);
+    }
+    return __dirname;
+}
+/**
+ * Get the plugin's data directory
+ */
+export function getPluginDataDir() {
+    return path.join(openclawHome, "extensions", "changewayguard", "data");
+}
+/**
+ * Check if a port is responding to HTTP health check
+ */
+async function isPortResponding(port) {
+    try {
+        const healthUrl = withChangewayOpenPrefix(`http://localhost:${port}/health`);
+        const res = await fetch(healthUrl, {
+            signal: AbortSignal.timeout(1000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a port is in use (TCP level check)
+ */
+async function isPortInUse(port) {
+    const net = await import("node:net");
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once("listening", () => {
+            server.close();
+            resolve(false);
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+/**
+ * Wait for a port to become available
+ */
+async function waitForPortAvailable(port, timeoutMs = 10000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        const inUse = await isPortInUse(port);
+        if (!inUse) {
+            return true;
+        }
+        // Wait 500ms before checking again
+        await new Promise(r => setTimeout(r, 500));
+    }
+    return false;
+}
+/**
+ * Read saved token from file
+ */
+function readSavedToken() {
+    if (fs.existsSync(TOKEN_FILE)) {
+        try {
+            const data = loadJsonSync(TOKEN_FILE);
+            if (data.token && typeof data.token === "string") {
+                return data.token;
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return null;
+}
+/**
+ * Save token to file
+ */
+function saveToken(token, port) {
+    try {
+        const tokenDir = path.dirname(TOKEN_FILE);
+        fs.mkdirSync(tokenDir, { recursive: true });
+        fs.writeFileSync(TOKEN_FILE, JSON.stringify({ token, port }));
+    }
+    catch {
+        // Ignore
+    }
+}
+/**
+ * Find the Dashboard directory
+ */
+function findDashboardDir() {
+    const packageRoot = getPackageRoot();
+    const candidates = [
+        // 1. Bundled in moltguard package (production)
+        { dir: path.join(packageRoot, "dashboard-dist"), bundled: true },
+        // 2. Relative to moltguard (monorepo development)
+        { dir: path.join(packageRoot, "..", "dashboard"), bundled: false },
+    ];
+    for (const candidate of candidates) {
+        const checkFile = candidate.bundled
+            ? path.join(candidate.dir, "api", "package.json")
+            : path.join(candidate.dir, "package.json");
+        if (fs.existsSync(checkFile)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Start the local Dashboard (in-process)
+ */
+export async function startLocalDashboard(options) {
+    // If already running, return existing URL
+    if (dashboardRunning && currentToken && currentLocalUrl) {
+        return {
+            localUrl: currentLocalUrl,
+            token: currentToken,
+        };
+    }
+    // If startup is already in progress, wait for it
+    if (startupInProgress && startupPromise) {
+        return startupPromise;
+    }
+    // Check if Dashboard is already running (e.g., dev mode with pnpm dev, or previous instance)
+    const isAlreadyRunning = await isPortResponding(DASHBOARD_PORT);
+    if (isAlreadyRunning) {
+        const existingToken = readSavedToken();
+        if (existingToken) {
+            currentToken = existingToken;
+            currentLocalUrl = `http://localhost:${DASHBOARD_PORT}/dashboard/?token=${existingToken}`;
+            dashboardRunning = true;
+            return {
+                localUrl: currentLocalUrl,
+                token: existingToken,
+            };
+        }
+        // Port is responding but no token - another process is using it
+        // Don't try to start, just throw
+        throw new Error(`Port ${DASHBOARD_PORT} is already in use by another process`);
+    }
+    // Check if port is in use but not responding (e.g., server shutting down)
+    // Wait for it to become available
+    const portInUse = await isPortInUse(DASHBOARD_PORT);
+    if (portInUse) {
+        // Port is held but not responding - likely shutting down, wait for it
+        const portAvailable = await waitForPortAvailable(DASHBOARD_PORT, 15000);
+        if (!portAvailable) {
+            throw new Error(`Port ${DASHBOARD_PORT} is still in use after waiting. Please try again.`);
+        }
+    }
+    // Mark startup in progress and create promise
+    startupInProgress = true;
+    const doStartup = async () => {
+        try {
+            // Find dashboard directory
+            const dashboard = findDashboardDir();
+            if (!dashboard) {
+                throw new Error("Dashboard directory not found.");
+            }
+            // Generate token
+            const token = crypto.randomBytes(16).toString("hex");
+            currentToken = token;
+            // Determine data and web directories
+            const dataDir = options.dataDir || getPluginDataDir();
+            fs.mkdirSync(dataDir, { recursive: true });
+            // CRITICAL: Set environment variables BEFORE importing dashboard modules
+            // This ensures the database client uses the correct path
+            // Uses setEnv() helper to keep env access centralised (avoids scanner false-positive)
+            const { setEnv } = await import("./agent/env.js");
+            setEnv("DASHBOARD_DATA_DIR", dataDir);
+            setEnv("LOCAL_MODE", "true");
+            if (options.coreUrl) {
+                setEnv("OG_CORE_URL", options.coreUrl);
+            }
+            // Save token before starting
+            saveToken(token, DASHBOARD_PORT);
+            // Start Dashboard in-process with retry on EADDRINUSE
+            const startWithRetry = async (startFn, config, maxRetries = 3) => {
+                for (let attempt = 1; attempt <= maxRetries; attempt++) {
+                    try {
+                        return await startFn(config);
+                    }
+                    catch (err) {
+                        if (err?.code === "EADDRINUSE" || err?.message?.includes("EADDRINUSE")) {
+                            if (attempt < maxRetries) {
+                                // Wait and retry
+                                await new Promise(r => setTimeout(r, 1000 * attempt));
+                                continue;
+                            }
+                        }
+                        throw err;
+                    }
+                }
+                throw new Error("Failed to start dashboard after retries");
+            };
+            let result;
+            if (dashboard.bundled) {
+                // Production: import from bundled dist
+                const apiIndexPath = path.join(dashboard.dir, "api", "index.js");
+                const webOutDir = path.join(dashboard.dir, "web");
+                const { startDashboard } = await import(apiIndexPath);
+                result = await startWithRetry(startDashboard, {
+                    port: DASHBOARD_PORT,
+                    localMode: true,
+                    localToken: token,
+                    webOutDir,
+                    dataDir,
+                    coreUrl: options.coreUrl,
+                });
+            }
+            else {
+                // Development: import from source (requires build)
+                const apiIndexPath = path.join(dashboard.dir, "apps", "api", "dist", "index.js");
+                const webOutDir = path.join(dashboard.dir, "apps", "web", "out");
+                if (!fs.existsSync(apiIndexPath)) {
+                    throw new DevModeError(dashboard.dir);
+                }
+                const { startDashboard } = await import(apiIndexPath);
+                result = await startWithRetry(startDashboard, {
+                    port: DASHBOARD_PORT,
+                    localMode: true,
+                    localToken: token,
+                    webOutDir,
+                    dataDir,
+                    coreUrl: options.coreUrl,
+                });
+            }
+            // Save close function for cleanup
+            dashboardCloseFn = result.close;
+            dashboardRunning = true;
+            currentLocalUrl = `http://localhost:${DASHBOARD_PORT}/dashboard/?token=${token}`;
+            // Notify gateway manager of dashboard port for activity reporting
+            setDashboardPort(DASHBOARD_PORT);
+            return {
+                localUrl: currentLocalUrl,
+                token,
+            };
+        }
+        finally {
+            // Always reset startup state when done (success or failure)
+            startupInProgress = false;
+            startupPromise = null;
+        }
+    };
+    // Assign the promise so concurrent calls can wait on it
+    startupPromise = doStartup();
+    return startupPromise;
+}
+/**
+ * Check if Dashboard is running
+ */
+export function isDashboardRunning() {
+    return dashboardRunning;
+}
+/**
+ * Get current Dashboard URL
+ */
+export function getDashboardUrl() {
+    return currentLocalUrl;
+}
+/**
+ * Get current token
+ */
+export function getDashboardToken() {
+    return currentToken;
+}
+/**
+ * Error for development mode (when build is required)
+ */
+export class DevModeError extends Error {
+    dashboardDir;
+    constructor(dashboardDir) {
+        super("Development mode requires dashboard build");
+        this.dashboardDir = dashboardDir;
+        this.name = "DevModeError";
+    }
+    getInstructions() {
+        return [
+            "**Dashboard Not Built**",
+            "",
+            "Build the Dashboard first:",
+            "",
+            "```bash",
+            `cd ${this.dashboardDir}`,
+            `pnpm build`,
+            "```",
+            "",
+            "Then run `/og_dashboard` again.",
+        ].join("\n");
+    }
+}
+/**
+ * Stop Dashboard server
+ */
+export async function stopLocalDashboard() {
+    // Wait for any in-progress startup to complete first
+    if (startupInProgress && startupPromise) {
+        try {
+            await startupPromise;
+        }
+        catch {
+            // Ignore startup errors - we're stopping anyway
+        }
+    }
+    if (dashboardCloseFn) {
+        try {
+            await dashboardCloseFn();
+        }
+        catch {
+            // Ignore errors during shutdown
+        }
+        dashboardCloseFn = null;
+    }
+    // Reset all state
+    dashboardRunning = false;
+    currentLocalUrl = null;
+    currentToken = null;
+    startupInProgress = false;
+    startupPromise = null;
+}
+//# sourceMappingURL=dashboard-launcher.js.map

package/dist/dashboard-launcher.js.map

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

package/dist/gateway/activity.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Gateway Activity Logger
+ *
+ * Tracks sanitization and restoration events for monitoring.
+ */
+import type { ActivityListener, MappingTable } from "./types.js";
+/**
+ * Generate a unique request ID
+ */
+export declare function generateRequestId(): string;
+/**
+ * Register an activity listener
+ */
+export declare function addActivityListener(listener: ActivityListener): void;
+/**
+ * Remove an activity listener
+ */
+export declare function removeActivityListener(listener: ActivityListener): void;
+/**
+ * Clear all activity listeners
+ */
+export declare function clearActivityListeners(): void;
+/**
+ * Count categories from mapping table
+ * Handles both old format (__email_1__) and new format (__PII_EMAIL_ADDRESS_00000001__)
+ */
+export declare function countCategories(mappingTable: MappingTable): Record<string, number>;
+/**
+ * Log a sanitization event (request going out)
+ */
+export declare function logSanitizeEvent(params: {
+    requestId: string;
+    backend: string;
+    endpoint: string;
+    model?: string;
+    mappingTable: MappingTable;
+    redactionCount: number;
+    durationMs?: number;
+}): void;
+/**
+ * Log a restoration event (response coming back)
+ */
+export declare function logRestoreEvent(params: {
+    requestId: string;
+    backend: string;
+    endpoint: string;
+    model?: string;
+    mappingTable: MappingTable;
+    restorationCount: number;
+    durationMs?: number;
+}): void;
+//# sourceMappingURL=activity.d.ts.map

package/dist/gateway/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAwB,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQvF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAKvE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAeD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAgBP;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAgBP"}