sylas-edge-worker 0.2.21

package/dist/GitService.js

@@ -0,0 +1,432 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join, resolve as pathResolve } from "node:path";
+import { createLogger } from "sylas-core";
+import { WorktreeIncludeService } from "./WorktreeIncludeService.js";
+/**
+ * Service responsible for Git worktree operations
+ */
+export class GitService {
+    logger;
+    worktreeIncludeService;
+    constructor(logger) {
+        this.logger = logger ?? createLogger({ component: "GitService" });
+        this.worktreeIncludeService = new WorktreeIncludeService(this.logger);
+    }
+    /**
+     * Check if a branch exists locally or remotely
+     */
+    async branchExists(branchName, repoPath) {
+        try {
+            // Check if branch exists locally
+            execSync(`git rev-parse --verify "${branchName}"`, {
+                cwd: repoPath,
+                stdio: "pipe",
+            });
+            return true;
+        }
+        catch {
+            // Branch doesn't exist locally, check remote
+            try {
+                const remoteOutput = execSync(`git ls-remote --heads origin "${branchName}"`, {
+                    cwd: repoPath,
+                    stdio: "pipe",
+                });
+                // Check if output is non-empty (branch actually exists on remote)
+                return remoteOutput && remoteOutput.toString().trim().length > 0;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /**
+     * Sanitize branch name by removing backticks to prevent command injection
+     */
+    sanitizeBranchName(name) {
+        return name ? name.replace(/`/g, "") : name;
+    }
+    /**
+     * Resolve mutable Git metadata directories for a repository/worktree.
+     * This includes linked worktree metadata paths (for example
+     * `.git/worktrees/<name>/FETCH_HEAD`) that must be writable by sandboxes.
+     */
+    getGitMetadataDirectories(workingDirectory) {
+        const resolvedDirectories = new Set();
+        const revParse = (flag) => {
+            try {
+                const output = execSync(`git rev-parse ${flag}`, {
+                    cwd: workingDirectory,
+                    encoding: "utf8",
+                    stdio: "pipe",
+                }).trim();
+                return output ? pathResolve(workingDirectory, output) : null;
+            }
+            catch {
+                return null;
+            }
+        };
+        const gitDir = revParse("--git-dir");
+        if (gitDir) {
+            resolvedDirectories.add(gitDir);
+        }
+        const gitCommonDir = revParse("--git-common-dir");
+        if (gitCommonDir) {
+            resolvedDirectories.add(gitCommonDir);
+        }
+        return [...resolvedDirectories];
+    }
+    /**
+     * Run a setup script with proper error handling and logging
+     */
+    async runSetupScript(scriptPath, scriptType, workspacePath, issue) {
+        // Expand ~ to home directory
+        const expandedPath = scriptPath.replace(/^~/, homedir());
+        // Check if script exists
+        if (!existsSync(expandedPath)) {
+            this.logger.warn(`⚠️  ${scriptType === "global" ? "Global" : "Repository"} setup script not found: ${scriptPath}`);
+            return;
+        }
+        // Check if script is executable (Unix only)
+        if (process.platform !== "win32") {
+            try {
+                const stats = statSync(expandedPath);
+                // Check if file has execute permission for the owner
+                if (!(stats.mode & 0o100)) {
+                    this.logger.warn(`⚠️  ${scriptType === "global" ? "Global" : "Repository"} setup script is not executable: ${scriptPath}`);
+                    this.logger.warn(`   Run: chmod +x "${expandedPath}"`);
+                    return;
+                }
+            }
+            catch (error) {
+                this.logger.warn(`⚠️  Cannot check permissions for ${scriptType} setup script: ${error.message}`);
+                return;
+            }
+        }
+        const scriptName = basename(expandedPath);
+        this.logger.info(`ℹ️  Running ${scriptType} setup script: ${scriptName}`);
+        try {
+            // Determine the command based on the script extension and platform
+            let command;
+            const isWindows = process.platform === "win32";
+            if (scriptPath.endsWith(".ps1")) {
+                command = `powershell -ExecutionPolicy Bypass -File "${expandedPath}"`;
+            }
+            else if (scriptPath.endsWith(".cmd") || scriptPath.endsWith(".bat")) {
+                command = `"${expandedPath}"`;
+            }
+            else if (isWindows) {
+                // On Windows, try to run with bash if available (Git Bash/WSL)
+                command = `bash "${expandedPath}"`;
+            }
+            else {
+                // On Unix, run directly with bash
+                command = `bash "${expandedPath}"`;
+            }
+            execSync(command, {
+                cwd: workspacePath,
+                stdio: "inherit",
+                env: {
+                    ...process.env,
+                    LINEAR_ISSUE_ID: issue.id,
+                    LINEAR_ISSUE_IDENTIFIER: issue.identifier,
+                    LINEAR_ISSUE_TITLE: issue.title || "",
+                },
+                timeout: 5 * 60 * 1000, // 5 minute timeout
+            });
+            this.logger.info(`✅ ${scriptType === "global" ? "Global" : "Repository"} setup script completed successfully`);
+        }
+        catch (error) {
+            const errorMessage = error.signal === "SIGTERM"
+                ? "Script execution timed out (exceeded 5 minutes)"
+                : error.message;
+            this.logger.error(`❌ ${scriptType === "global" ? "Global" : "Repository"} setup script failed: ${errorMessage}`);
+            // Log stderr if available
+            if (error.stderr) {
+                this.logger.error("   stderr:", error.stderr.toString());
+            }
+            // Continue execution despite setup script failure
+            this.logger.info(`   Continuing with worktree creation...`);
+        }
+    }
+    /**
+     * Find an existing worktree by its checked-out branch name.
+     * Parses `git worktree list --porcelain` output and returns the worktree path
+     * if a worktree is found with the given branch checked out, or null otherwise.
+     */
+    findWorktreeByBranch(branchName, repoPath) {
+        try {
+            const output = execSync("git worktree list --porcelain", {
+                cwd: repoPath,
+                encoding: "utf-8",
+            });
+            const blocks = output.split("\n\n");
+            for (const block of blocks) {
+                const lines = block.split("\n");
+                let worktreePath = null;
+                let branchRef = null;
+                for (const line of lines) {
+                    if (line.startsWith("worktree ")) {
+                        worktreePath = line.slice("worktree ".length);
+                    }
+                    else if (line.startsWith("branch ")) {
+                        branchRef = line.slice("branch refs/heads/".length);
+                    }
+                }
+                if (worktreePath && branchRef === branchName) {
+                    return worktreePath;
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Create a git worktree for an issue
+     */
+    async createGitWorktree(issue, repository, globalSetupScript) {
+        try {
+            // Verify this is a git repository
+            try {
+                execSync("git rev-parse --git-dir", {
+                    cwd: repository.repositoryPath,
+                    stdio: "pipe",
+                });
+            }
+            catch (_e) {
+                this.logger.error(`${repository.repositoryPath} is not a git repository`);
+                throw new Error("Not a git repository");
+            }
+            // Use Linear's preferred branch name, or generate one if not available
+            const rawBranchName = issue.branchName ||
+                `${issue.identifier}-${issue.title
+                    ?.toLowerCase()
+                    .replace(/\s+/g, "-")
+                    .substring(0, 30)}`;
+            const branchName = this.sanitizeBranchName(rawBranchName);
+            const workspacePath = join(repository.workspaceBaseDir, issue.identifier);
+            // Ensure workspace directory exists
+            mkdirSync(repository.workspaceBaseDir, { recursive: true });
+            // Check if worktree already exists
+            try {
+                const worktrees = execSync("git worktree list --porcelain", {
+                    cwd: repository.repositoryPath,
+                    encoding: "utf-8",
+                });
+                if (worktrees.includes(workspacePath)) {
+                    this.logger.info(`Worktree already exists at ${workspacePath}, using existing`);
+                    return {
+                        path: workspacePath,
+                        isGitWorktree: true,
+                    };
+                }
+            }
+            catch (_e) {
+                // git worktree command failed, continue with creation
+            }
+            // Check if branch already exists
+            let createBranch = true;
+            try {
+                execSync(`git rev-parse --verify "${branchName}"`, {
+                    cwd: repository.repositoryPath,
+                    stdio: "pipe",
+                });
+                createBranch = false;
+            }
+            catch (_e) {
+                // Branch doesn't exist, we'll create it
+            }
+            // If the branch already exists, check if it's already checked out in another worktree
+            if (!createBranch) {
+                const existingWorktreePath = this.findWorktreeByBranch(branchName, repository.repositoryPath);
+                if (existingWorktreePath && existingWorktreePath !== workspacePath) {
+                    this.logger.info(`Branch "${branchName}" is already checked out in worktree at ${existingWorktreePath}, reusing existing worktree`);
+                    return {
+                        path: existingWorktreePath,
+                        isGitWorktree: true,
+                    };
+                }
+            }
+            // Determine base branch for this issue
+            let baseBranch = repository.baseBranch;
+            // Check if issue has a parent
+            try {
+                const parent = await issue.parent;
+                if (parent) {
+                    this.logger.info(`Issue ${issue.identifier} has parent: ${parent.identifier}`);
+                    // Get parent's branch name
+                    const parentRawBranchName = parent.branchName ||
+                        `${parent.identifier}-${parent.title
+                            ?.toLowerCase()
+                            .replace(/\s+/g, "-")
+                            .substring(0, 30)}`;
+                    const parentBranchName = this.sanitizeBranchName(parentRawBranchName);
+                    // Check if parent branch exists
+                    const parentBranchExists = await this.branchExists(parentBranchName, repository.repositoryPath);
+                    if (parentBranchExists) {
+                        baseBranch = parentBranchName;
+                        this.logger.info(`Using parent issue branch '${parentBranchName}' as base for sub-issue ${issue.identifier}`);
+                    }
+                    else {
+                        this.logger.info(`Parent branch '${parentBranchName}' not found, using default base branch '${repository.baseBranch}'`);
+                    }
+                }
+            }
+            catch (_error) {
+                // Parent field might not exist or couldn't be fetched, use default base branch
+                this.logger.info(`No parent issue found for ${issue.identifier}, using default base branch '${repository.baseBranch}'`);
+            }
+            // Fetch latest changes from remote
+            this.logger.debug("Fetching latest changes from remote...");
+            let hasRemote = true;
+            try {
+                execSync("git fetch origin", {
+                    cwd: repository.repositoryPath,
+                    stdio: "pipe",
+                });
+            }
+            catch (e) {
+                this.logger.warn("Warning: git fetch failed, proceeding with local branch:", e.message);
+                hasRemote = false;
+            }
+            // Create the worktree - use determined base branch
+            let worktreeCmd;
+            if (createBranch) {
+                if (hasRemote) {
+                    // Check if the base branch exists remotely
+                    let useRemoteBranch = false;
+                    try {
+                        const remoteOutput = execSync(`git ls-remote --heads origin "${baseBranch}"`, {
+                            cwd: repository.repositoryPath,
+                            stdio: "pipe",
+                        });
+                        // Check if output is non-empty (branch actually exists on remote)
+                        useRemoteBranch =
+                            remoteOutput && remoteOutput.toString().trim().length > 0;
+                        if (!useRemoteBranch) {
+                            this.logger.info(`Base branch '${baseBranch}' not found on remote, checking locally...`);
+                        }
+                    }
+                    catch {
+                        // Base branch doesn't exist remotely, use local or fall back to default
+                        this.logger.info(`Base branch '${baseBranch}' not found on remote, checking locally...`);
+                    }
+                    if (useRemoteBranch) {
+                        // Use remote version of base branch with --track to set upstream
+                        const remoteBranch = `origin/${baseBranch}`;
+                        this.logger.info(`Creating git worktree at ${workspacePath} from ${remoteBranch} (tracking ${baseBranch})`);
+                        worktreeCmd = `git worktree add --track -b "${branchName}" "${workspacePath}" "${remoteBranch}"`;
+                    }
+                    else {
+                        // Check if base branch exists locally
+                        try {
+                            execSync(`git rev-parse --verify "${baseBranch}"`, {
+                                cwd: repository.repositoryPath,
+                                stdio: "pipe",
+                            });
+                            // Use local base branch (can't track since remote doesn't have it)
+                            this.logger.info(`Creating git worktree at ${workspacePath} from local ${baseBranch}`);
+                            worktreeCmd = `git worktree add -b "${branchName}" "${workspacePath}" "${baseBranch}"`;
+                        }
+                        catch {
+                            // Base branch doesn't exist locally either, fall back to remote default with --track
+                            this.logger.info(`Base branch '${baseBranch}' not found locally, falling back to remote ${repository.baseBranch} (tracking ${repository.baseBranch})`);
+                            const defaultRemoteBranch = `origin/${repository.baseBranch}`;
+                            worktreeCmd = `git worktree add --track -b "${branchName}" "${workspacePath}" "${defaultRemoteBranch}"`;
+                        }
+                    }
+                }
+                else {
+                    // No remote, use local branch (no tracking since no remote)
+                    this.logger.info(`Creating git worktree at ${workspacePath} from local ${baseBranch}`);
+                    worktreeCmd = `git worktree add -b "${branchName}" "${workspacePath}" "${baseBranch}"`;
+                }
+            }
+            else {
+                // Branch already exists, just check it out
+                this.logger.info(`Creating git worktree at ${workspacePath} with existing branch ${branchName}`);
+                worktreeCmd = `git worktree add "${workspacePath}" "${branchName}"`;
+            }
+            execSync(worktreeCmd, {
+                cwd: repository.repositoryPath,
+                stdio: "pipe",
+            });
+            // Copy files specified in .worktreeinclude that are also in .gitignore
+            // This runs before setup scripts so they can access these files
+            await this.worktreeIncludeService.copyIgnoredFiles(repository.repositoryPath, workspacePath);
+            // First, run the global setup script if configured
+            if (globalSetupScript) {
+                await this.runSetupScript(globalSetupScript, "global", workspacePath, issue);
+            }
+            // Then, check for repository setup scripts (cross-platform)
+            const isWindows = process.platform === "win32";
+            const setupScripts = [
+                {
+                    file: "sylas-setup.sh",
+                    platform: "unix",
+                },
+                {
+                    file: "sylas-setup.ps1",
+                    platform: "windows",
+                },
+                {
+                    file: "sylas-setup.cmd",
+                    platform: "windows",
+                },
+                {
+                    file: "sylas-setup.bat",
+                    platform: "windows",
+                },
+            ];
+            // Find the first available setup script for the current platform
+            const availableScript = setupScripts.find((script) => {
+                const scriptPath = join(repository.repositoryPath, script.file);
+                const isCompatible = isWindows
+                    ? script.platform === "windows"
+                    : script.platform === "unix";
+                return existsSync(scriptPath) && isCompatible;
+            });
+            // Fallback: on Windows, try bash if no Windows scripts found (for Git Bash/WSL users)
+            const fallbackScript = !availableScript && isWindows
+                ? setupScripts.find((script) => {
+                    const scriptPath = join(repository.repositoryPath, script.file);
+                    return script.platform === "unix" && existsSync(scriptPath);
+                })
+                : null;
+            const scriptToRun = availableScript || fallbackScript;
+            if (scriptToRun) {
+                const scriptPath = join(repository.repositoryPath, scriptToRun.file);
+                await this.runSetupScript(scriptPath, "repository", workspacePath, issue);
+            }
+            return {
+                path: workspacePath,
+                isGitWorktree: true,
+            };
+        }
+        catch (error) {
+            const errorMessage = error.message;
+            this.logger.error("Failed to create git worktree:", errorMessage);
+            // Check if the error is "branch already checked out in another worktree"
+            // Git error format: "fatal: 'branch-name' is already used by worktree at '/path/to/worktree'"
+            const worktreeMatch = errorMessage.match(/already used by worktree at '([^']+)'/);
+            if (worktreeMatch?.[1] && existsSync(worktreeMatch[1])) {
+                this.logger.info(`Reusing existing worktree at ${worktreeMatch[1]} (branch already checked out)`);
+                return {
+                    path: worktreeMatch[1],
+                    isGitWorktree: true,
+                };
+            }
+            // Fall back to regular directory if git worktree fails
+            const fallbackPath = join(repository.workspaceBaseDir, issue.identifier);
+            mkdirSync(fallbackPath, { recursive: true });
+            return {
+                path: fallbackPath,
+                isGitWorktree: false,
+            };
+        }
+    }
+}
+//# sourceMappingURL=GitService.js.map

package/dist/GitService.js.map

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

package/dist/GlobalSessionRegistry.d.ts

@@ -0,0 +1,142 @@
+/**
+ * GlobalSessionRegistry - Centralized session storage across all repositories
+ *
+ * This is Phase 1 of the CYPACK-724 architectural refactor.
+ * Replaces per-repository session storage in AgentSessionManager with a global registry
+ * that enables cross-repository session lookups (e.g., parent orchestrator in Repo A
+ * creating child issues in Repo B).
+ */
+import { EventEmitter } from "node:events";
+import type { SerializedSylasAgentSession, SerializedSylasAgentSessionEntry, SylasAgentSession, SylasAgentSessionEntry } from "sylas-core";
+/**
+ * Serialization format for GlobalSessionRegistry state
+ * Version 3.0 to distinguish from previous per-repository format (v2.0)
+ */
+export interface SerializedGlobalRegistryState {
+    version: "3.0";
+    sessions: Record<string, SerializedSylasAgentSession>;
+    entries: Record<string, SerializedSylasAgentSessionEntry[]>;
+    childToParentMap: Record<string, string>;
+}
+/**
+ * Events emitted by GlobalSessionRegistry
+ */
+export interface GlobalSessionRegistryEvents {
+    sessionCreated: (session: SylasAgentSession) => void;
+    sessionUpdated: (sessionId: string, session: SylasAgentSession, updates: Partial<SylasAgentSession>) => void;
+    sessionCompleted: (sessionId: string, session: SylasAgentSession) => void;
+}
+/**
+ * GlobalSessionRegistry centralizes all session storage across repositories.
+ *
+ * Responsibilities:
+ * - Store ALL SylasAgentSession objects (all repos)
+ * - Store ALL SylasAgentSessionEntry arrays (all repos)
+ * - Maintain parent-child session relationships
+ * - Emit lifecycle events for session changes
+ * - Support serialization/deserialization for persistence
+ * - Provide cleanup for old sessions
+ */
+export declare class GlobalSessionRegistry extends EventEmitter {
+    /**
+     * All sessions keyed by session id
+     */
+    private sessions;
+    /**
+     * All entries keyed by session id
+     */
+    private entries;
+    /**
+     * Child session ID → parent session ID mapping
+     * Enables orchestrator workflows where parent (Repo A) creates child (Repo B)
+     */
+    private childToParentMap;
+    /**
+     * Create a new session in the registry
+     * @param session The session to create
+     * @throws Error if session with same ID already exists
+     */
+    createSession(session: SylasAgentSession): void;
+    /**
+     * Get a session by ID
+     * @param sessionId The session id
+     * @returns The session or undefined if not found
+     */
+    getSession(sessionId: string): SylasAgentSession | undefined;
+    /**
+     * Update a session with partial data
+     * @param sessionId The session id
+     * @param updates Partial session data to merge
+     * @throws Error if session doesn't exist
+     */
+    updateSession(sessionId: string, updates: Partial<SylasAgentSession>): void;
+    /**
+     * Delete a session and its entries
+     * @param sessionId The session id
+     */
+    deleteSession(sessionId: string): void;
+    /**
+     * Get all sessions
+     * @returns Array of all sessions
+     */
+    getAllSessions(): SylasAgentSession[];
+    /**
+     * Add an entry to a session's conversation history
+     * @param sessionId The session id
+     * @param entry The entry to add
+     * @throws Error if session doesn't exist
+     */
+    addEntry(sessionId: string, entry: SylasAgentSessionEntry): void;
+    /**
+     * Get all entries for a session
+     * @param sessionId The session id
+     * @returns Array of entries (empty if session has no entries or doesn't exist)
+     */
+    getEntries(sessionId: string): SylasAgentSessionEntry[];
+    /**
+     * Update an entry in a session's conversation history
+     * @param sessionId The session id
+     * @param entryIndex The index of the entry to update (0-based)
+     * @param updates Partial entry data to merge
+     * @throws Error if session doesn't exist or index out of bounds
+     */
+    updateEntry(sessionId: string, entryIndex: number, updates: Partial<SylasAgentSessionEntry>): void;
+    /**
+     * Set parent session for a child session (orchestrator workflow)
+     * @param childSessionId The child's session id
+     * @param parentSessionId The parent's session id
+     */
+    setParentSession(childSessionId: string, parentSessionId: string): void;
+    /**
+     * Get parent session ID for a child session
+     * @param childSessionId The child's session id
+     * @returns The parent session ID or undefined if not found
+     */
+    getParentSessionId(childSessionId: string): string | undefined;
+    /**
+     * Get all child session IDs for a parent session
+     * @param parentSessionId The parent's session id
+     * @returns Array of child session IDs
+     */
+    getChildSessionIds(parentSessionId: string): string[];
+    /**
+     * Serialize the registry state for persistence
+     * Excludes non-serializable data like agentRunner instances
+     * @returns Serialized state
+     */
+    serializeState(): SerializedGlobalRegistryState;
+    /**
+     * Restore the registry state from serialized data
+     * Clears existing state before restoring
+     * @param state Serialized state to restore
+     */
+    restoreState(state: SerializedGlobalRegistryState): void;
+    /**
+     * Clean up old sessions based on age
+     * Removes sessions where updatedAt is older than maxAgeMs
+     * @param maxAgeMs Maximum age in milliseconds (sessions older than this are removed)
+     * @returns Number of sessions removed
+     */
+    cleanup(maxAgeMs: number): number;
+}
+//# sourceMappingURL=GlobalSessionRegistry.d.ts.map

package/dist/GlobalSessionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalSessionRegistry.d.ts","sourceRoot":"","sources":["../src/GlobalSessionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACX,2BAA2B,EAC3B,gCAAgC,EAChC,iBAAiB,EACjB,sBAAsB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,KAAK,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC5D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,cAAc,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAC/B,IAAI,CAAC;IACV,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC1E;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACtD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAA6C;IAE7D;;OAEG;IACH,OAAO,CAAC,OAAO,CAAoD;IAEnE;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAW/C;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI5D;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAsB3E;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IActC;;;OAGG;IACH,cAAc,IAAI,iBAAiB,EAAE;IAIrC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAgBhE;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIvD;;;;;;OAMG;IACH,WAAW,CACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACtC,IAAI;IA6BP;;;;OAIG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAIvE;;;;OAIG;IACH,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9D;;;;OAIG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAWrD;;;;OAIG;IACH,cAAc,IAAI,6BAA6B;IA0B/C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,6BAA6B,GAAG,IAAI;IAsBxD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAejC"}