strray-ai 1.7.0 → 1.7.2

package/dist/plugins/plugin-system.js

@@ -0,0 +1,419 @@
+/**
+ * Plugin Ecosystem
+ *
+ * Secure plugin system for third-party agent extensions.
+ * Provides sandboxed execution, validation, and lifecycle management.
+ *
+ * @version 1.0.0
+ * @since 2026-01-07
+ */
+import { frameworkLogger, generateJobId } from "../core/framework-logger.js";
+export class PluginValidator {
+    requiredFields = [
+        "id",
+        "name",
+        "version",
+        "description",
+        "author",
+        "license",
+        "engines",
+    ];
+    securityChecks = [
+        "validatePackageName",
+        "validateDependencies",
+        "validatePermissions",
+        "validateCodeSecurity",
+        "validateResourceLimits",
+    ];
+    /**
+     * Comprehensive plugin validation
+     */
+    async validatePlugin(pluginPath) {
+        const result = {
+            valid: false,
+            errors: [],
+            warnings: [],
+            securityIssues: [],
+            compatibilityScore: 0,
+        };
+        try {
+            const packageJson = await this.loadPackageJson(pluginPath);
+            const metadataValidation = this.validateMetadata(packageJson);
+            result.errors.push(...metadataValidation.errors);
+            result.warnings.push(...metadataValidation.warnings);
+            const capabilitiesValidation = this.validateCapabilities(packageJson);
+            result.errors.push(...capabilitiesValidation.errors);
+            result.warnings.push(...capabilitiesValidation.warnings);
+            const securityValidation = await this.validateSecurity(pluginPath, packageJson);
+            result.securityIssues.push(...securityValidation.issues);
+            result.errors.push(...securityValidation.errors);
+            result.compatibilityScore = this.calculateCompatibilityScore(packageJson);
+            result.valid =
+                result.errors.length === 0 && result.securityIssues.length === 0;
+        }
+        catch (error) {
+            result.errors.push(`Validation failed: ${error}`);
+        }
+        return result;
+    }
+    async loadPackageJson(pluginPath) {
+        const fs = require("fs").promises;
+        const path = require("path");
+        const packagePath = path.join(pluginPath, "package.json");
+        const content = await fs.readFile(packagePath, "utf-8");
+        return JSON.parse(content);
+    }
+    validateMetadata(packageJson) {
+        const errors = [];
+        const warnings = [];
+        for (const field of this.requiredFields) {
+            if (!packageJson[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        if (packageJson.version && !/^\d+\.\d+\.\d+/.test(packageJson.version)) {
+            errors.push("Invalid version format (expected semver)");
+        }
+        if (!packageJson.engines?.strray) {
+            errors.push("Missing StringRay engine requirement");
+        }
+        const suspiciousKeywords = [
+            "hack",
+            "exploit",
+            "malware",
+            "virus",
+            "trojan",
+        ];
+        const keywords = packageJson.keywords || [];
+        for (const keyword of keywords) {
+            if (suspiciousKeywords.some((s) => keyword.toLowerCase().includes(s))) {
+                warnings.push(`Suspicious keyword detected: ${keyword}`);
+            }
+        }
+        return { errors, warnings };
+    }
+    validateCapabilities(packageJson) {
+        const errors = [];
+        const warnings = [];
+        const capabilities = packageJson.stringrayCapabilities;
+        if (!capabilities) {
+            errors.push("Missing stringrayCapabilities in package.json");
+            return { errors, warnings };
+        }
+        if (!capabilities.agentTypes || !Array.isArray(capabilities.agentTypes)) {
+            errors.push("Missing or invalid agentTypes in capabilities");
+        }
+        if (!capabilities.supportedTasks ||
+            !Array.isArray(capabilities.supportedTasks)) {
+            errors.push("Missing or invalid supportedTasks in capabilities");
+        }
+        if (!capabilities.requiredPermissions ||
+            !Array.isArray(capabilities.requiredPermissions)) {
+            warnings.push("Missing requiredPermissions - assuming minimal permissions");
+        }
+        return { errors, warnings };
+    }
+    async validateSecurity(pluginPath, packageJson) {
+        const issues = [];
+        const errors = [];
+        const dangerousDeps = [
+            "eval",
+            "child_process",
+            "fs",
+            "net",
+            "http",
+            "https",
+            "crypto",
+            "tls",
+            "cluster",
+            "worker_threads",
+        ];
+        const allDeps = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies,
+        };
+        for (const dep of Object.keys(allDeps)) {
+            if (dangerousDeps.includes(dep)) {
+                issues.push(`Potentially dangerous dependency: ${dep}`);
+            }
+        }
+        const scripts = packageJson.scripts || {};
+        for (const [name, script] of Object.entries(scripts)) {
+            if (typeof script === "string") {
+                if (script.includes("rm -rf") ||
+                    script.includes("sudo") ||
+                    script.includes("chmod +x")) {
+                    issues.push(`Potentially dangerous script: ${name}`);
+                }
+            }
+        }
+        const fs = require("fs").promises;
+        const path = require("path");
+        try {
+            const files = await fs.readdir(pluginPath);
+            const hasIndex = files.includes("index.js") || files.includes("index.ts");
+            if (!hasIndex) {
+                errors.push("Plugin must have an index.js or index.ts file");
+            }
+            for (const file of files) {
+                const stat = await fs.stat(path.join(pluginPath, file));
+                if (stat.isFile() && stat.mode & parseInt("111", 8)) {
+                    issues.push(`Executable file detected: ${file}`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`Failed to validate plugin structure: ${error}`);
+        }
+        return { issues, errors };
+    }
+    calculateCompatibilityScore(packageJson) {
+        let score = 0;
+        const strrayEngine = packageJson.engines?.strray;
+        if (strrayEngine) {
+            if (strrayEngine === "^1.0.0")
+                score += 30;
+            else if (strrayEngine.startsWith("^1."))
+                score += 20;
+            else if (strrayEngine.startsWith("~1."))
+                score += 15;
+            else
+                score += 5;
+        }
+        const nodeEngine = packageJson.engines?.node;
+        if (nodeEngine) {
+            if (nodeEngine === "^18.0.0" || nodeEngine === ">=18.0.0")
+                score += 20;
+            else if (nodeEngine.startsWith("^18."))
+                score += 15;
+            else
+                score += 5;
+        }
+        const keywords = packageJson.keywords || [];
+        const relevantKeywords = ["strray", "plugin", "agent", "ai", "framework"];
+        const relevantCount = keywords.filter((k) => relevantKeywords.some((r) => k.toLowerCase().includes(r))).length;
+        score += Math.min(relevantCount * 5, 25);
+        if (packageJson.description)
+            score += 10;
+        if (packageJson.homepage)
+            score += 5;
+        if (packageJson.repository)
+            score += 5;
+        return Math.min(score, 100);
+    }
+}
+export class PluginSandbox {
+    sandbox = null;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            memoryLimit: 50, // 50MB
+            timeout: 30000, // 30 seconds
+            allowedModules: ["util", "events", "stream", "buffer", "string_decoder"],
+            networkAccess: false,
+            fileSystemAccess: false,
+            environmentVariables: [],
+            ...config,
+        };
+    }
+    /**
+     * Execute plugin code in sandbox
+     */
+    async executePlugin(pluginPath, method, ...args) {
+        const vm = require("vm");
+        const fs = require("fs").promises;
+        const path = require("path");
+        const pluginCode = await fs.readFile(path.join(pluginPath, "index.js"), "utf-8");
+        const context = vm.createContext({
+            console: {
+                log: async (...args) => await frameworkLogger.log("plugin-system", "-plugin-args-error-args-any-console-error-plugin-a", "error", { message: "[PLUGIN]", ...args }),
+                error: (...args) => console.error("[PLUGIN]", ...args),
+                warn: (...args) => console.warn("[PLUGIN]", ...args),
+            },
+            require: this.createRestrictedRequire(),
+            process: {
+                env: this.filterEnvironmentVariables(),
+                version: process.version,
+                platform: process.platform,
+            },
+            Buffer: Buffer,
+            setTimeout: setTimeout,
+            clearTimeout: clearTimeout,
+            setInterval: setInterval,
+            clearInterval: clearInterval,
+        });
+        const script = new vm.Script(pluginCode);
+        const pluginInstance = script.runInContext(context);
+        return Promise.race([
+            pluginInstance[method](...args),
+            new Promise((_, reject) => setTimeout(() => reject(new Error("Plugin execution timeout")), this.config.timeout)),
+        ]);
+    }
+    createRestrictedRequire() {
+        const Module = require("module");
+        const originalRequire = Module.prototype.require;
+        return (id) => {
+            if (!this.config.allowedModules.includes(id)) {
+                throw new Error(`Module '${id}' is not allowed in plugin sandbox`);
+            }
+            return originalRequire.call(this, id);
+        };
+    }
+    filterEnvironmentVariables() {
+        const filtered = {};
+        for (const key of this.config.environmentVariables) {
+            if (process.env[key]) {
+                filtered[key] = process.env[key];
+            }
+        }
+        return filtered;
+    }
+}
+export class PluginRegistry {
+    plugins = new Map();
+    activePlugins = new Set();
+    validator;
+    sandbox;
+    constructor() {
+        this.validator = new PluginValidator();
+        this.sandbox = new PluginSandbox();
+    }
+    /**
+     * Register a plugin
+     */
+    async registerPlugin(pluginPath) {
+        try {
+            const validation = await this.validator.validatePlugin(pluginPath);
+            if (!validation.valid) {
+                return {
+                    success: false,
+                    errors: [...validation.errors, ...validation.securityIssues],
+                };
+            }
+            const pluginInstance = await this.sandbox.executePlugin(pluginPath, "createPlugin");
+            this.plugins.set(pluginInstance.metadata.id, pluginInstance);
+            const jobId = generateJobId("plugin-system-register");
+            frameworkLogger.log("plugin-system", "plugin registered", "success", {
+                name: pluginInstance.metadata.name,
+                version: pluginInstance.metadata.version,
+            }, undefined, jobId);
+            return { success: true, errors: [] };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errors: [`Plugin registration failed: ${error}`],
+            };
+        }
+    }
+    /**
+     * Activate a plugin
+     */
+    async activatePlugin(pluginId, config = {}) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin) {
+            console.error(`Plugin ${pluginId} not found`);
+            return false;
+        }
+        try {
+            await plugin.initialize(config);
+            await plugin.activate();
+            this.activePlugins.add(pluginId);
+            const jobId = generateJobId("plugin-system-activate");
+            frameworkLogger.log("plugin-system", "plugin activated", "success", {
+                name: plugin.metadata.name,
+            }, undefined, jobId);
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ Plugin activation failed: ${error}`);
+            return false;
+        }
+    }
+    /**
+     * Deactivate a plugin
+     */
+    async deactivatePlugin(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return false;
+        try {
+            await plugin.deactivate();
+            this.activePlugins.delete(pluginId);
+            const jobId = generateJobId("plugin-system-deactivate");
+            frameworkLogger.log("plugin-system", "plugin deactivated", "success", {
+                name: plugin.metadata.name,
+            }, undefined, jobId);
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ Plugin deactivation failed: ${error}`);
+            return false;
+        }
+    }
+    /**
+     * Get plugin instance
+     */
+    getPlugin(pluginId) {
+        return this.plugins.get(pluginId) || null;
+    }
+    /**
+     * List all registered plugins
+     */
+    listPlugins() {
+        return Array.from(this.plugins.entries()).map(([id, plugin]) => ({
+            id,
+            name: plugin.metadata.name,
+            version: plugin.metadata.version,
+            active: this.activePlugins.has(id),
+        }));
+    }
+    /**
+     * Get plugin health status
+     */
+    async getPluginHealth(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return null;
+        try {
+            return await plugin.getHealthStatus();
+        }
+        catch (error) {
+            return {
+                status: "unhealthy",
+                lastCheck: Date.now(),
+                uptime: 0,
+                errorCount: 1,
+                warningCount: 0,
+                details: { error: String(error) },
+            };
+        }
+    }
+    /**
+     * Unregister a plugin
+     */
+    async unregisterPlugin(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return false;
+        if (this.activePlugins.has(pluginId)) {
+            await this.deactivatePlugin(pluginId);
+        }
+        try {
+            await plugin.dispose();
+        }
+        catch (error) {
+            console.warn(`Plugin disposal failed: ${error}`);
+        }
+        this.plugins.delete(pluginId);
+        const jobId = generateJobId("plugin-system-unregister");
+        frameworkLogger.log("plugin-system", "plugin unregistered", "success", {
+            name: plugin.metadata.name,
+        }, undefined, jobId);
+        return true;
+    }
+}
+export const pluginValidator = new PluginValidator();
+export const pluginSandbox = new PluginSandbox();
+export const pluginRegistry = new PluginRegistry();
+//# sourceMappingURL=plugin-system.js.map

package/dist/plugins/plugin-system.js.map

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

package/dist/plugins/stringray-codex-injection.d.ts

@@ -0,0 +1,21 @@
+/**
+ * StringRay Plugin for OpenCode
+ *
+ * Enterprise AI orchestration with systematic error prevention.
+ * This plugin provides intelligent agent coordination and codex-based code quality enforcement.
+ *
+ * @version 1.1.2
+ * @author StringRay Framework Team
+ */
+export declare function stringrayPlugin(input: any): {
+    config: (input: {
+        client?: string;
+        directory?: string;
+        worktree?: string;
+    }) => void;
+    "experimental.chat.system.transform": (messages: any[], context: any) => any[];
+    "tool.execute.before": (tool: string, args: any) => void;
+    "tool.execute.after": (tool: string, args: any, result: any) => void;
+};
+export default stringrayPlugin;
+//# sourceMappingURL=stringray-codex-injection.d.ts.map

package/dist/plugins/stringray-codex-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringray-codex-injection.d.ts","sourceRoot":"","sources":["../../src/plugins/stringray-codex-injection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwMH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG;oBA/LxB;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;qDAYgD,GAAG,EAAE,WAAW,GAAG;kCA8HtC,MAAM,QAAQ,GAAG;iCAYlB,MAAM,QAAQ,GAAG,UAAU,GAAG;EA6D5D;AAGD,eAAe,eAAe,CAAC"}

package/dist/plugins/stringray-codex-injection.js

@@ -0,0 +1,169 @@
+/**
+ * StringRay Plugin for OpenCode
+ *
+ * Enterprise AI orchestration with systematic error prevention.
+ * This plugin provides intelligent agent coordination and codex-based code quality enforcement.
+ *
+ * @version 1.1.2
+ * @author StringRay Framework Team
+ */
+import { frameworkLogger, generateJobId } from "../core/framework-logger.js";
+import { TokenManager } from "../utils/token-manager.js";
+const tokenManager = new TokenManager();
+const pluginHooks = {
+    config: (input) => {
+        const jobId = generateJobId("codex-injector-init");
+        frameworkLogger.log("codex-injector", "plugin initialized", "info", {}, undefined, jobId);
+    },
+    "experimental.chat.system.transform": (messages, context) => {
+        const jobId = generateJobId("codex-injector-transform");
+        frameworkLogger.log("codex-injector", "chat.system.transform hook called", "info", { messageCount: messages?.length }, undefined, jobId);
+        // Inject codex context into system messages for agent guidance
+        try {
+            const fullContent = `## StringRay Framework Codex v1.2.25
+
+Welcome to StringRay AI! This session includes systematic error prevention and production-ready development guidelines.
+
+### 🚀 Available Framework Capabilities
+
+**Agent Commands (use @agent-name):**
+- **@orchestrator** - Multi-agent workflow coordination (accesses all internal agents)
+- **@enforcer** - Codex compliance & error prevention
+
+**Internal Agent System:**
+All 8 specialized agents (architect, bug-triage-specialist, code-reviewer, security-auditor, refactorer, testing-lead, researcher) are available internally through orchestrator coordination and framework operations.
+
+**Skills System (23 lazy-loaded capabilities):**
+- project-analysis, testing-strategy, code-review, security-audit, performance-optimization
+- refactoring-strategies, ui-ux-design, documentation-generation, and more
+
+**Framework Tools:**
+- **framework-reporting-system** - Generate comprehensive activity reports
+- **complexity-analyzer** - Analyze code complexity and delegation decisions
+- **codex-injector** - Apply development standards automatically
+
+**Help & Discovery:**
+To discover all available capabilities, use the framework-help system:
+- Get capabilities overview and command examples
+- Access detailed explanations of any framework feature
+- Available through MCP server: framework-help
+
+### Core Principles:
+- **Progressive Prod-Ready Code**: All code must be production-ready from the first commit
+- **No Patches/Boiler/Stubs**: Prohibit temporary patches and incomplete implementations
+- **Surgical Fixes**: Apply precise, targeted fixes with root cause resolution
+- **Type Safety First**: Leverage TypeScript's type system fully
+- **Single Source of Truth**: Maintain authoritative sources for all information
+
+### Development Guidelines:
+- **YAGNI**: Don't implement features not currently needed
+- **DRY**: Don't repeat yourself - extract reusable logic
+- **Separation of Concerns**: Keep UI, business logic, and data layers distinct
+- **Test Coverage >85%**: Maintain comprehensive behavioral test coverage
+- **Performance Budget**: Bundle size <2MB (gzipped <700KB)
+
+For complete codex documentation, see: .opencode/strray/codex.json
+
+### 🔒 Critical Spawn Governance (All Agents)
+
+**MANDATORY: All agents must follow these spawn governance rules:**
+
+- **Maximum 2 subagents total** across all operations within a single agent session
+- **No nested subagent spawning** - subagents cannot spawn their own subagents
+- **Solo agents (researcher)** can spawn 0 subagents - they are terminal agents
+- **Always check spawn authorization** before creating new agents via agentSpawnGovernor
+- **Report spawn attempts** to monitoring system before execution
+- **Terminate gracefully** if spawn limits exceeded - do not attempt workarounds
+- **Single level only** - coordinator agents can spawn workers, but workers cannot spawn more agents
+
+**Violation of these rules will result in immediate system shutdown to prevent infinite loops.**`;
+            const limitCheck = tokenManager.checkLimits(fullContent);
+            let finalContent = fullContent;
+            if (!limitCheck.withinLimit) {
+                const jobId = generateJobId("codex-injector-token-exceed");
+                frameworkLogger.log("codex-injector", "Codex content exceeds token limits, pruning context", "error", {
+                    currentTokens: limitCheck.currentTokens,
+                    maxTokens: limitCheck.maxTokens,
+                }, undefined, jobId);
+                finalContent = tokenManager.pruneContext(fullContent);
+            }
+            else if (limitCheck.warning) {
+                const jobId = generateJobId("codex-injector-token-warning");
+                frameworkLogger.log("codex-injector", "Codex content approaching token limits", "info", {
+                    currentTokens: limitCheck.currentTokens,
+                    maxTokens: limitCheck.maxTokens,
+                }, undefined, jobId);
+            }
+            // CRITICAL: DO NOT add complexity analysis here
+            // Complexity analysis belongs in the delegation system, not context injection
+            // This plugin should ONLY handle codex context injection
+            const codexMessage = {
+                role: "system",
+                content: finalContent,
+            };
+            // Modify context.system array to include codex message
+            if (context && context.system && Array.isArray(context.system)) {
+                context.system.unshift(codexMessage);
+            }
+            // Return the original messages (the hook modifies context in place)
+            return messages;
+        }
+        catch (error) {
+            console.error("❌ StringRay: Error injecting codex context:", error);
+            // Return original messages if injection fails
+            return messages;
+        }
+    },
+    "tool.execute.before": (tool, args) => {
+        const jobId = generateJobId("codex-injector-tool-before");
+        frameworkLogger.log("codex-injector", "tool.execute.before hook called", "info", { tool }, undefined, jobId);
+    },
+    "tool.execute.after": (tool, args, result) => {
+        const jobId = generateJobId("codex-injector-tool-after");
+        frameworkLogger.log("codex-injector", "tool.execute.after hook called", "success", { tool }, undefined, jobId);
+    },
+};
+// Lightweight bypass for simple interactions
+function isSimpleInteraction(input) {
+    if (!input || typeof input !== "object")
+        return false;
+    // Check messages for simple greetings/chats
+    if (input.messages && Array.isArray(input.messages)) {
+        const lastMessage = input.messages[input.messages.length - 1];
+        if (lastMessage && lastMessage.content) {
+            const content = String(lastMessage.content).toLowerCase().trim();
+            // Detect basic greetings and chat
+            if (content.match(/^(hi|hello|hey|sup|yo|howdy|greeting|chat|how are you|what'?s up)$/i)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+// Export a function that returns the plugin hooks object
+export function stringrayPlugin(input) {
+    // Fast path for simple interactions - skip full framework activation
+    if (isSimpleInteraction(input)) {
+        return {
+            config: () => { }, // No-op for simple interactions
+            "experimental.chat.system.transform": (messages, context) => {
+                // Insert minimal welcome message for simple interactions
+                const lightMessage = {
+                    role: "system",
+                    content: "Hello! I'm the StrRay Agentic Framework. Ready to help with development tasks.",
+                };
+                if (context && context.system && Array.isArray(context.system)) {
+                    context.system.unshift(lightMessage);
+                }
+                return messages;
+            },
+            "tool.execute.before": () => { },
+            "tool.execute.after": () => { },
+        };
+    }
+    // Full framework activation for complex requests
+    return pluginHooks;
+}
+// Default export for compatibility
+export default stringrayPlugin;
+//# sourceMappingURL=stringray-codex-injection.js.map

package/dist/plugins/stringray-codex-injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringray-codex-injection.js","sourceRoot":"","sources":["../../src/plugins/stringray-codex-injection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;AAExC,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC,KAIR,EAAE,EAAE;QACH,MAAM,KAAK,GAAG,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACnD,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,EACN,EAAE,EACF,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;IAED,oCAAoC,EAAE,CAAC,QAAe,EAAE,OAAY,EAAE,EAAE;QACtE,MAAM,KAAK,GAAG,aAAa,CAAC,0BAA0B,CAAC,CAAC;QACxD,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,mCAAmC,EACnC,MAAM,EACN,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,EAClC,SAAS,EACT,KAAK,CACN,CAAC;QAEF,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGAwDuE,CAAC;YAE5F,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;YACzD,IAAI,YAAY,GAAG,WAAW,CAAC;YAE/B,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,6BAA6B,CAAC,CAAC;gBAC3D,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,qDAAqD,EACrD,OAAO,EACP;oBACE,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,SAAS,EAAE,UAAU,CAAC,SAAS;iBAChC,EACD,SAAS,EACT,KAAK,CACN,CAAC;gBACF,YAAY,GAAG,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACxD,CAAC;iBAAM,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,8BAA8B,CAAC,CAAC;gBAC5D,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,wCAAwC,EACxC,MAAM,EACN;oBACE,aAAa,EAAE,UAAU,CAAC,aAAa;oBACvC,SAAS,EAAE,UAAU,CAAC,SAAS;iBAChC,EACD,SAAS,EACT,KAAK,CACN,CAAC;YACJ,CAAC;YAED,gDAAgD;YAChD,8EAA8E;YAC9E,yDAAyD;YAEzD,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,YAAY;aACtB,CAAC;YAEF,uDAAuD;YACvD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACvC,CAAC;YAED,oEAAoE;YACpE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACpE,8CAA8C;YAC9C,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qBAAqB,EAAE,CAAC,IAAY,EAAE,IAAS,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,aAAa,CAAC,4BAA4B,CAAC,CAAC;QAC1D,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,iCAAiC,EACjC,MAAM,EACN,EAAE,IAAI,EAAE,EACR,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;IAED,oBAAoB,EAAE,CAAC,IAAY,EAAE,IAAS,EAAE,MAAW,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAC;QACzD,eAAe,CAAC,GAAG,CACjB,gBAAgB,EAChB,gCAAgC,EAChC,SAAS,EACT,EAAE,IAAI,EAAE,EACR,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,6CAA6C;AAC7C,SAAS,mBAAmB,CAAC,KAAU;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEtD,4CAA4C;IAC5C,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,WAAW,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACjE,kCAAkC;YAClC,IACE,OAAO,CAAC,KAAK,CACX,qEAAqE,CACtE,EACD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,qEAAqE;IACrE,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,gCAAgC;YAClD,oCAAoC,EAAE,CAAC,QAAe,EAAE,OAAY,EAAE,EAAE;gBACtE,yDAAyD;gBACzD,MAAM,YAAY,GAAG;oBACnB,IAAI,EAAE,QAAQ;oBACd,OAAO,EACL,gFAAgF;iBACnF,CAAC;gBACF,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/D,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACvC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,qBAAqB,EAAE,GAAG,EAAE,GAAE,CAAC;YAC/B,oBAAoB,EAAE,GAAG,EAAE,GAAE,CAAC;SAC/B,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,mCAAmC;AACnC,eAAe,eAAe,CAAC"}