@cleocode/adapters 2026.4.0 → 2026.4.2

package/dist/providers/claude-code/hooks.js

@@ -1,279 +0,0 @@
-/**
- * Claude Code Hook Provider
- *
- * Maps Claude Code's native hook events to CAAMP canonical hook events.
- * Claude Code supports 14 of 16 canonical events (all except PreModel, PostModel).
- *
- * Event translation uses CAAMP normalizer APIs:
- * - `toCanonical(nativeName, 'claude-code')` for runtime event name resolution
- * - `getSupportedEvents('claude-code')` to enumerate supported canonical events
- * - `getProviderHookProfile('claude-code')` for the full provider profile
- *
- * A static map derived from CAAMP 1.9.1 hook-mappings.json is maintained as
- * a fallback for environments where CAAMP's runtime resolution is unavailable.
- *
- * @task T164
- * @epic T134
- */
-import { readdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-/** CAAMP provider identifier for Claude Code. */
-const PROVIDER_ID = 'claude-code';
-/**
- * Fallback map from Claude Code native event names to CAAMP canonical names.
- *
- * Derived from `getProviderHookProfile('claude-code').mappings` in CAAMP 1.9.1.
- * Covers all 14 supported events. PreModel and PostModel are not supported
- * by Claude Code and are absent from this map.
- *
- * Used as fallback when CAAMP runtime is unavailable, and as the synchronous
- * implementation of `mapProviderEvent()`.
- */
-const CLAUDE_CODE_EVENT_MAP = {
-    // CAAMP: toNative('SessionStart',      'claude-code') = 'SessionStart'
-    SessionStart: 'SessionStart',
-    // CAAMP: toNative('SessionEnd',        'claude-code') = 'SessionEnd'
-    SessionEnd: 'SessionEnd',
-    // CAAMP: toNative('PromptSubmit',      'claude-code') = 'UserPromptSubmit'
-    UserPromptSubmit: 'PromptSubmit',
-    // CAAMP: toNative('ResponseComplete',  'claude-code') = 'Stop'
-    Stop: 'ResponseComplete',
-    // CAAMP: toNative('PreToolUse',        'claude-code') = 'PreToolUse'
-    PreToolUse: 'PreToolUse',
-    // CAAMP: toNative('PostToolUse',       'claude-code') = 'PostToolUse'
-    PostToolUse: 'PostToolUse',
-    // CAAMP: toNative('PostToolUseFailure','claude-code') = 'PostToolUseFailure'
-    PostToolUseFailure: 'PostToolUseFailure',
-    // CAAMP: toNative('PermissionRequest', 'claude-code') = 'PermissionRequest'
-    PermissionRequest: 'PermissionRequest',
-    // CAAMP: toNative('SubagentStart',     'claude-code') = 'SubagentStart'
-    SubagentStart: 'SubagentStart',
-    // CAAMP: toNative('SubagentStop',      'claude-code') = 'SubagentStop'
-    SubagentStop: 'SubagentStop',
-    // CAAMP: toNative('PreCompact',        'claude-code') = 'PreCompact'
-    PreCompact: 'PreCompact',
-    // CAAMP: toNative('PostCompact',       'claude-code') = 'PostCompact'
-    PostCompact: 'PostCompact',
-    // CAAMP: toNative('Notification',      'claude-code') = 'Notification'
-    Notification: 'Notification',
-    // CAAMP: toNative('ConfigChange',      'claude-code') = 'ConfigChange'
-    ConfigChange: 'ConfigChange',
-};
-/**
- * Hook provider for Claude Code.
- *
- * Claude Code registers hooks via its global config at `~/.claude/settings.json`.
- * Supported handler types: command, http, prompt, agent.
- *
- * Event mapping is based on `getProviderHookProfile('claude-code')` from
- * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
- * `getProviderProfile`) call CAAMP directly when available.
- *
- * Since hooks are registered through the config system (managed by the install
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
- * state without performing filesystem operations.
- *
- * @task T164
- * @epic T134
- */
-export class ClaudeCodeHookProvider {
-    registered = false;
-    /**
-     * Map a Claude Code native event name to a CAAMP canonical hook event name.
-     *
-     * Looks up the native event name in the map derived from
-     * `getProviderHookProfile('claude-code').mappings` (CAAMP 1.9.1).
-     * Returns null for unrecognised events (e.g. PreModel, PostModel which
-     * Claude Code does not support).
-     *
-     * @param providerEvent - Claude Code native event (e.g. "UserPromptSubmit", "Stop")
-     * @returns CAAMP canonical event name, or null if unmapped
-     * @task T164
-     */
-    mapProviderEvent(providerEvent) {
-        return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
-    }
-    /**
-     * Register native hooks for a project.
-     *
-     * For Claude Code, hooks are registered via the config system
-     * (`~/.claude/settings.json`), managed by the install provider.
-     * This method marks hooks as registered without performing filesystem operations.
-     *
-     * Iterating supported events is handled at install time using
-     * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
-     *
-     * @param _projectDir - Project directory (unused; Claude Code uses global config)
-     * @task T164
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * Unregister native hooks.
-     *
-     * For Claude Code, this is a no-op since hooks are managed through the config
-     * system. Unregistration happens via the install provider's uninstall method.
-     *
-     * @task T164
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the native→canonical event mapping for introspection and debugging.
-     *
-     * Returns the map derived from `getProviderHookProfile('claude-code').mappings`
-     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
-     * names via live CAAMP APIs.
-     *
-     * @returns Immutable record of native event name → canonical event name
-     */
-    getEventMap() {
-        return { ...CLAUDE_CODE_EVENT_MAP };
-    }
-    /**
-     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
-     *
-     * Calls `getSupportedEvents('claude-code')` from the CAAMP normalizer to
-     * get the authoritative list. Claude Code supports 14 of 16 canonical events
-     * (PreModel and PostModel are not supported). Falls back to the values of
-     * the static event map when CAAMP is unavailable at runtime.
-     *
-     * @returns Array of CAAMP canonical event names supported by Claude Code
-     * @task T164
-     */
-    async getSupportedCanonicalEvents() {
-        try {
-            const { getSupportedEvents } = await import('@cleocode/caamp');
-            return getSupportedEvents(PROVIDER_ID);
-        }
-        catch {
-            return [...new Set(Object.values(CLAUDE_CODE_EVENT_MAP))];
-        }
-    }
-    /**
-     * Retrieve the full provider hook profile from CAAMP.
-     *
-     * Calls `getProviderHookProfile('claude-code')` from the CAAMP normalizer to
-     * get the complete profile: hook system type (`config`), config path
-     * (`~/.claude/settings.json`), handler types, and all event mappings.
-     * Returns null when CAAMP is unavailable at runtime.
-     *
-     * @returns Provider hook profile or null if CAAMP is unavailable
-     * @task T164
-     */
-    async getProviderProfile() {
-        try {
-            const { getProviderHookProfile } = await import('@cleocode/caamp');
-            return getProviderHookProfile(PROVIDER_ID) ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Translate a CAAMP canonical event to its Claude Code native name via CAAMP.
-     *
-     * Calls `toNative(canonical, 'claude-code')` from the CAAMP normalizer.
-     * Returns null for unsupported events (PreModel, PostModel) or when
-     * CAAMP is unavailable.
-     *
-     * @param canonical - CAAMP canonical event name (e.g. "PromptSubmit")
-     * @returns Claude Code native event name or null
-     * @task T164
-     */
-    async toNativeEvent(canonical) {
-        try {
-            const { toNative } = await import('@cleocode/caamp');
-            return toNative(canonical, PROVIDER_ID);
-        }
-        catch {
-            // Invert the static map as fallback
-            const entry = Object.entries(CLAUDE_CODE_EVENT_MAP).find(([, v]) => v === canonical);
-            return entry?.[0] ?? null;
-        }
-    }
-    /**
-     * Extract a plain-text transcript from Claude Code session JSONL files.
-     *
-     * Reads the most recent .jsonl file under `~/.claude/projects/` and
-     * extracts user/assistant turn text into a flat string for brain
-     * observation extraction.
-     *
-     * Returns null when no session data is found or on any read error.
-     *
-     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
-     * @param _projectDir - Project directory (unused; Claude Code uses global paths)
-     * @task T144 @epic T134
-     */
-    async getTranscript(_sessionId, _projectDir) {
-        try {
-            const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '/root';
-            const projectsDir = join(homeDir, '.claude', 'projects');
-            // Find all JSONL files across project subdirectories
-            let allFiles = [];
-            try {
-                const projectDirs = await readdir(projectsDir, { withFileTypes: true });
-                for (const entry of projectDirs) {
-                    if (!entry.isDirectory())
-                        continue;
-                    const subDir = join(projectsDir, entry.name);
-                    try {
-                        const files = await readdir(subDir);
-                        for (const file of files) {
-                            if (!file.endsWith('.jsonl'))
-                                continue;
-                            const filePath = join(subDir, file);
-                            // Use file path modification heuristic (filename usually includes timestamp)
-                            allFiles.push({ path: filePath, mtime: 0 });
-                        }
-                    }
-                    catch {
-                        // Skip unreadable subdirectories
-                    }
-                }
-            }
-            catch {
-                return null;
-            }
-            if (allFiles.length === 0)
-                return null;
-            // Sort by path descending (timestamps in filenames sort naturally)
-            allFiles = allFiles.sort((a, b) => b.path.localeCompare(a.path));
-            const mostRecent = allFiles[0];
-            if (!mostRecent)
-                return null;
-            const raw = await readFile(mostRecent.path, 'utf-8');
-            const lines = raw.split('\n').filter((l) => l.trim());
-            const turns = [];
-            for (const line of lines) {
-                try {
-                    const entry = JSON.parse(line);
-                    const role = entry.role;
-                    const content = entry.content;
-                    if (role === 'assistant' && typeof content === 'string') {
-                        turns.push(`assistant: ${content}`);
-                    }
-                    else if (role === 'user' && typeof content === 'string') {
-                        turns.push(`user: ${content}`);
-                    }
-                }
-                catch {
-                    // Skip malformed lines
-                }
-            }
-            return turns.length > 0 ? turns.join('\n') : null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/claude-code/hooks.js.map

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

package/dist/providers/claude-code/index.js

@@ -1,26 +0,0 @@
-/**
- * Claude Code provider adapter.
- *
- * CLEO provider adapter for Anthropic Claude Code CLI.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T5240
- */
-import { ClaudeCodeAdapter } from './adapter.js';
-export { ClaudeCodeAdapter } from './adapter.js';
-export { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
-export { ClaudeCodeHookProvider } from './hooks.js';
-export { ClaudeCodeInstallProvider } from './install.js';
-export { ClaudeCodePathProvider } from './paths.js';
-export { ClaudeCodeSpawnProvider } from './spawn.js';
-export { checkStatuslineIntegration, getSetupInstructions, getStatuslineConfig, } from './statusline.js';
-export { ClaudeCodeTransportProvider } from './transport.js';
-export default ClaudeCodeAdapter;
-/**
- * Factory function for creating adapter instances.
- * Used by AdapterManager's dynamic import fallback.
- */
-export function createAdapter() {
-    return new ClaudeCodeAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/claude-code/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/claude-code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,eAAe,iBAAiB,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

package/dist/providers/claude-code/install.js

@@ -1,234 +0,0 @@
-/**
- * Claude Code Install Provider
- *
- * Handles CLEO installation into Claude Code environments:
- * - Registers CLEO MCP server in .mcp.json
- * - Ensures CLAUDE.md has CLEO @-references
- * - Manages plugin registration in ~/.claude/settings.json
- *
- * Migrated from src/core/install/claude-plugin.ts
- *
- * @task T5240
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/** Lines that should appear in CLAUDE.md to reference CLEO. */
-const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
-/** MCP server registration key used in .mcp.json. */
-const MCP_SERVER_KEY = 'cleo';
-/**
- * Install provider for Claude Code.
- *
- * Manages CLEO's integration with Claude Code by:
- * 1. Registering the CLEO MCP server in the project's .mcp.json
- * 2. Ensuring CLAUDE.md contains @-references to CLEO instruction files
- * 3. Registering the brain observation plugin in ~/.claude/settings.json
- */
-export class ClaudeCodeInstallProvider {
-    installedProjectDir = null;
-    /**
-     * Install CLEO into a Claude Code project.
-     *
-     * @param options - Installation options including project directory and MCP server path
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir, mcpServerPath } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        let mcpRegistered = false;
-        const details = {};
-        // Step 1: Register MCP server in .mcp.json
-        if (mcpServerPath) {
-            mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-            if (mcpRegistered) {
-                details.mcpConfigPath = join(projectDir, '.mcp.json');
-            }
-        }
-        // Step 2: Ensure CLAUDE.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'CLAUDE.md');
-        }
-        // Step 3: Register plugin in ~/.claude/settings.json
-        const pluginResult = this.registerPlugin();
-        if (pluginResult) {
-            details.plugin = pluginResult;
-        }
-        this.installedProjectDir = projectDir;
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            mcpRegistered,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current Claude Code project.
-     *
-     * Removes the MCP server registration from .mcp.json.
-     * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
-     */
-    async uninstall() {
-        if (!this.installedProjectDir)
-            return;
-        const mcpPath = join(this.installedProjectDir, '.mcp.json');
-        if (existsSync(mcpPath)) {
-            try {
-                const raw = readFileSync(mcpPath, 'utf-8');
-                const config = JSON.parse(raw);
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    delete mcpServers[MCP_SERVER_KEY];
-                    writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-                }
-            }
-            catch {
-                // Ignore errors during uninstall
-            }
-        }
-        this.installedProjectDir = null;
-    }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for:
-     * 1. MCP server registered in .mcp.json
-     * 2. Plugin enabled in ~/.claude/settings.json
-     *
-     * Returns true if either condition is met (partial install counts).
-     */
-    async isInstalled() {
-        // Check ~/.claude/settings.json for plugin registration
-        const settingsPath = join(homedir(), '.claude', 'settings.json');
-        if (existsSync(settingsPath)) {
-            try {
-                const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-                const plugins = settings.enabledPlugins;
-                if (plugins && plugins['cleo@cleocode'] === true) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        // Check current directory for .mcp.json with cleo server
-        const mcpPath = join(process.cwd(), '.mcp.json');
-        if (existsSync(mcpPath)) {
-            try {
-                const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * Ensure CLAUDE.md contains @-references to CLEO instruction files.
-     *
-     * Creates CLAUDE.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    /**
-     * Register the CLEO MCP server in .mcp.json.
-     *
-     * @returns true if registration was performed or updated
-     */
-    registerMcpServer(projectDir, mcpServerPath) {
-        const mcpPath = join(projectDir, '.mcp.json');
-        let config = {};
-        if (existsSync(mcpPath)) {
-            try {
-                config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
-            }
-            catch {
-                // Start fresh on parse error
-            }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY] = {
-            command: 'node',
-            args: [mcpServerPath],
-        };
-        writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-        return true;
-    }
-    /**
-     * Update CLAUDE.md with CLEO @-references.
-     *
-     * @returns true if the file was created or modified
-     */
-    updateInstructionFile(projectDir) {
-        const claudeMdPath = join(projectDir, 'CLAUDE.md');
-        let content = '';
-        let existed = false;
-        if (existsSync(claudeMdPath)) {
-            content = readFileSync(claudeMdPath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            // Append missing references
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            // Create new CLAUDE.md with references
-            content = refsBlock + '\n';
-        }
-        writeFileSync(claudeMdPath, content, 'utf-8');
-        return true;
-    }
-    /**
-     * Register the CLEO brain plugin in ~/.claude/settings.json.
-     *
-     * @returns Description of what was registered, or null if no change needed
-     */
-    registerPlugin() {
-        const home = homedir();
-        const settingsPath = join(home, '.claude', 'settings.json');
-        let settings = {};
-        if (existsSync(settingsPath)) {
-            try {
-                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-            }
-            catch {
-                // Start fresh
-            }
-        }
-        const enabledPlugins = settings.enabledPlugins ?? {};
-        const pluginKey = 'cleo@cleocode';
-        if (enabledPlugins[pluginKey] === true) {
-            return null;
-        }
-        // Disable old claude-mem if present
-        if (enabledPlugins['claude-mem@thedotmack'] === true) {
-            enabledPlugins['claude-mem@thedotmack'] = false;
-        }
-        enabledPlugins[pluginKey] = true;
-        settings.enabledPlugins = enabledPlugins;
-        mkdirSync(join(home, '.claude'), { recursive: true });
-        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
-        return `Enabled ${pluginKey} in ~/.claude/settings.json`;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/claude-code/install.js.map

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

package/dist/providers/claude-code/paths.js

@@ -1,33 +0,0 @@
-/**
- * Claude Code path provider.
- *
- * Implements AdapterPathProvider with Claude Code-specific directory locations.
- *
- * @task T5240
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-/**
- * Path provider for Anthropic Claude Code CLI.
- *
- * Resolves Claude Code's standard directory layout:
- * - Config dir: ~/.claude (or CLAUDE_HOME)
- * - Settings: ~/.claude/settings.json (or CLAUDE_SETTINGS)
- * - Agents: ~/.claude/agents
- * - Memory DB: ~/.claude-mem/claude-mem.db (or CLAUDE_MEM_DB)
- */
-export class ClaudeCodePathProvider {
-    getProviderDir() {
-        return process.env['CLAUDE_HOME'] ?? join(homedir(), '.claude');
-    }
-    getSettingsPath() {
-        return process.env['CLAUDE_SETTINGS'] ?? join(this.getProviderDir(), 'settings.json');
-    }
-    getAgentInstallDir() {
-        return join(this.getProviderDir(), 'agents');
-    }
-    getMemoryDbPath() {
-        return process.env['CLAUDE_MEM_DB'] ?? join(homedir(), '.claude-mem', 'claude-mem.db');
-    }
-}
-//# sourceMappingURL=paths.js.map

package/dist/providers/claude-code/paths.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/providers/claude-code/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,cAAc;QACZ,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;IACxF,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IACzF,CAAC;CACF"}