@cleocode/adapters 2026.4.57 → 2026.4.59

package/dist/providers/gemini-cli/install.js

@@ -0,0 +1,124 @@
+/**
+ * Gemini CLI Install Provider
+ *
+ * Handles CLEO installation into Gemini CLI environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T161
+ * @epic T134
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Lines that should appear in AGENTS.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Install provider for Gemini CLI.
+ *
+ * Manages CLEO's integration with Gemini CLI by:
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; Gemini CLI
+ * does not have an MCP or plugin registration mechanism.
+ *
+ * @task T161
+ * @epic T134
+ */
+export class GeminiCliInstallProvider {
+    /**
+     * Install CLEO into a Gemini CLI environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T161
+     */
+    async install(options) {
+        const { projectDir } = options;
+        const installedAt = new Date().toISOString();
+        let instructionFileUpdated = false;
+        const details = {};
+        // Step 1: Ensure AGENTS.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'AGENTS.md');
+        }
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the Gemini CLI environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T161
+     */
+    async uninstall() {
+        // No-op: no MCP registration to remove
+    }
+    /**
+     * Check whether CLEO is installed in the Gemini CLI environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T161
+     */
+    async isInstalled() {
+        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
+        if (existsSync(agentsMdPath)) {
+            try {
+                const content = readFileSync(agentsMdPath, 'utf-8');
+                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        return false;
+    }
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T161
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFile(projectDir);
+    }
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const agentsMdPath = join(projectDir, 'AGENTS.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(agentsMdPath)) {
+            content = readFileSync(agentsMdPath, '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) {
+            const separator = content.endsWith('\n') ? '' : '\n';
+            content = content + separator + refsBlock + '\n';
+        }
+        else {
+            content = refsBlock + '\n';
+        }
+        writeFileSync(agentsMdPath, content, 'utf-8');
+        return true;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/providers/gemini-cli/install.js.map

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

package/dist/providers/kimi/adapter.js

@@ -0,0 +1,145 @@
+/**
+ * Kimi Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Moonshot AI Kimi.
+ * Provides install-only capabilities for CLEO integration.
+ * Kimi has no native hook system; integration is via instruction files.
+ *
+ * @task T163
+ * @epic T134
+ */
+import { exec } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { KimiHookProvider } from './hooks.js';
+import { KimiInstallProvider } from './install.js';
+const execAsync = promisify(exec);
+/**
+ * CLEO provider adapter for Moonshot AI Kimi.
+ *
+ * Bridges CLEO's adapter system with Kimi's integration surface:
+ * - Hooks: No-op (Kimi has no native hook system)
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * Kimi has no native hook or event system, so all hook-related capabilities
+ * are disabled. The adapter is install-only, managing AGENTS.md references
+ * for CLEO instruction injection.
+ *
+ * @task T163
+ * @epic T134
+ */
+export class KimiAdapter {
+    /** Unique provider identifier. */
+    id = 'kimi';
+    /** Human-readable provider name. */
+    name = 'Kimi';
+    /** Adapter version string. */
+    version = '1.0.0';
+    /** Declared capabilities for this provider. */
+    capabilities = {
+        supportsHooks: false,
+        supportedHookEvents: [],
+        supportsSpawn: false,
+        supportsInstall: true,
+        supportsInstructionFiles: false,
+        supportsContextMonitor: false,
+        supportsStatusline: false,
+        supportsProviderPaths: false,
+        supportsTransport: false,
+        supportsTaskSync: false,
+    };
+    /** Hook provider (no-op since Kimi has no event system). */
+    hooks;
+    /** Install provider for managing instruction files. */
+    install;
+    /** Project directory this adapter was initialized with, or null. */
+    projectDir = null;
+    /** Whether {@link initialize} has been called. */
+    initialized = false;
+    constructor() {
+        this.hooks = new KimiHookProvider();
+        this.install = new KimiInstallProvider();
+    }
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T163
+     */
+    async initialize(projectDir) {
+        this.projectDir = projectDir;
+        this.initialized = true;
+    }
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Releases tracked state. No hooks to unregister since Kimi
+     * has no native hook system.
+     * @task T163
+     */
+    async dispose() {
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify Kimi is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Kimi CLI binary is available in PATH
+     * 3. ~/.kimi/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T163
+     */
+    async healthCheck() {
+        const details = {};
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        // Check Kimi CLI availability
+        let cliAvailable = false;
+        try {
+            const { stdout } = await execAsync('which kimi');
+            cliAvailable = stdout.trim().length > 0;
+            details.cliPath = stdout.trim();
+        }
+        catch {
+            details.cliAvailable = false;
+        }
+        // Check for Kimi config directory
+        const kimiConfigDir = join(homedir(), '.kimi');
+        const configExists = existsSync(kimiConfigDir);
+        details.configDirExists = configExists;
+        // Healthy if CLI is available (primary requirement)
+        const healthy = cliAvailable;
+        details.cliAvailable = cliAvailable;
+        return {
+            healthy,
+            provider: this.id,
+            details,
+        };
+    }
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T163
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T163
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/kimi/adapter.js.map

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

package/dist/providers/kimi/hooks.js

@@ -0,0 +1,79 @@
+/**
+ * Kimi Hook Provider
+ *
+ * Kimi has no native hook system (hookSystem is "none").
+ * This provider implements the minimal AdapterHookProvider interface
+ * with a no-op mapProviderEvent that always returns null.
+ *
+ * @task T163
+ * @epic T134
+ */
+/**
+ * Hook provider for Kimi.
+ *
+ * Kimi does not expose a native hook or event system.
+ * All hook-related methods are no-ops; mapProviderEvent always
+ * returns null since there are no events to map.
+ *
+ * @remarks
+ * Since Kimi has no hookable events, the event map is empty and
+ * `mapProviderEvent` always returns null. Registration state is tracked
+ * purely for interface compliance with {@link AdapterHookProvider}.
+ *
+ * @task T163
+ * @epic T134
+ */
+export class KimiHookProvider {
+    /** Whether hooks have been registered (always a no-op for Kimi). */
+    registered = false;
+    /**
+     * Map a Kimi native event name to a CAAMP hook event name.
+     *
+     * Kimi has no hook system, so this always returns null.
+     *
+     * @param _providerEvent - Unused; Kimi emits no hookable events
+     * @returns Always null
+     * @task T163
+     */
+    mapProviderEvent(_providerEvent) {
+        return null;
+    }
+    /**
+     * Register native hooks for a project.
+     *
+     * Kimi has no hook system. This method is a no-op and only
+     * tracks registration state for interface compliance.
+     *
+     * @param _projectDir - Project directory (unused)
+     * @task T163
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * Unregister native hooks.
+     *
+     * Kimi has no hook system. This method is a no-op.
+     * @task T163
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T163
+     */
+    isRegistered() {
+        return this.registered;
+    }
+    /**
+     * Get the full event mapping for introspection/debugging.
+     *
+     * Returns an empty map since Kimi has no hookable events.
+     * @task T163
+     */
+    getEventMap() {
+        return {};
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/providers/kimi/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/kimi/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,gBAAgB;IAC3B,oEAAoE;IAC5D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,cAAsB;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/providers/kimi/index.js

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ *
+ * CLEO provider adapter for Moonshot AI Kimi.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T163
+ * @epic T134
+ */
+import { KimiAdapter } from './adapter.js';
+export { KimiAdapter } from './adapter.js';
+export { KimiHookProvider } from './hooks.js';
+export { KimiInstallProvider } from './install.js';
+export default KimiAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the kimi
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link KimiAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/kimi';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ *
+ * @task T163
+ */
+export function createAdapter() {
+    return new KimiAdapter();
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/kimi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/kimi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAe,WAAW,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC"}

package/dist/providers/kimi/install.js

@@ -0,0 +1,124 @@
+/**
+ * Kimi Install Provider
+ *
+ * Handles CLEO installation into Kimi environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T163
+ * @epic T134
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Lines that should appear in AGENTS.md to reference CLEO. */
+const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
+/**
+ * Install provider for Kimi.
+ *
+ * Manages CLEO's integration with Kimi by:
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; Kimi does
+ * not have an MCP or plugin registration mechanism.
+ *
+ * @task T163
+ * @epic T134
+ */
+export class KimiInstallProvider {
+    /**
+     * Install CLEO into a Kimi environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T163
+     */
+    async install(options) {
+        const { projectDir } = options;
+        const installedAt = new Date().toISOString();
+        let instructionFileUpdated = false;
+        const details = {};
+        // Step 1: Ensure AGENTS.md has @-references
+        instructionFileUpdated = this.updateInstructionFile(projectDir);
+        if (instructionFileUpdated) {
+            details.instructionFile = join(projectDir, 'AGENTS.md');
+        }
+        return {
+            success: true,
+            installedAt,
+            instructionFileUpdated,
+            details,
+        };
+    }
+    /**
+     * Uninstall CLEO from the Kimi environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T163
+     */
+    async uninstall() {
+        // No-op: no MCP registration to remove
+    }
+    /**
+     * Check whether CLEO is installed in the Kimi environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T163
+     */
+    async isInstalled() {
+        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
+        if (existsSync(agentsMdPath)) {
+            try {
+                const content = readFileSync(agentsMdPath, 'utf-8');
+                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
+                    return true;
+                }
+            }
+            catch {
+                // Fall through
+            }
+        }
+        return false;
+    }
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T163
+     */
+    async ensureInstructionReferences(projectDir) {
+        this.updateInstructionFile(projectDir);
+    }
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    updateInstructionFile(projectDir) {
+        const agentsMdPath = join(projectDir, 'AGENTS.md');
+        let content = '';
+        let existed = false;
+        if (existsSync(agentsMdPath)) {
+            content = readFileSync(agentsMdPath, '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) {
+            const separator = content.endsWith('\n') ? '' : '\n';
+            content = content + separator + refsBlock + '\n';
+        }
+        else {
+            content = refsBlock + '\n';
+        }
+        writeFileSync(agentsMdPath, content, 'utf-8');
+        return true;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/providers/kimi/install.js.map

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

package/dist/providers/openai-sdk/adapter.js

@@ -0,0 +1,120 @@
+/**
+ * OpenAI Agents SDK Adapter.
+ *
+ * Main `CLEOProviderAdapter` implementation for the OpenAI Agents SDK.
+ * Provides spawn and install capabilities. Hooks are not supported (the
+ * SDK does not expose a CLI hook system equivalent to Claude Code's).
+ *
+ * @task T582
+ */
+import { OpenAiSdkInstallProvider } from './install.js';
+import { OpenAiSdkSpawnProvider } from './spawn.js';
+/**
+ * CLEO provider adapter for the OpenAI Agents SDK.
+ *
+ * Bridges CLEO's adapter system with the `@openai/agents` SDK:
+ * - Spawn: Launches agents via the SDK runner with handoff topology
+ * - Install: Manages AGENTS.md @-references and .openai/ config directory
+ * - Tracing: Default-on conduit span persistence via `CleoConduitTraceProcessor`
+ *
+ * @remarks
+ * This adapter is the only CLEO provider with first-class handoff support.
+ * Team Lead → Worker topology is declared in `SpawnContext.options.handoffs`
+ * and wired directly to SDK `Agent.handoffs`. The SDK handles routing
+ * internally without any CLEO glue code.
+ *
+ * This is also the only provider supporting 100+ LLMs via the Vercel AI SDK
+ * bridge (capability flag: `supportsMultiModel`).
+ */
+export class OpenAiSdkAdapter {
+    /** Unique provider identifier. */
+    id = 'openai-sdk';
+    /** Human-readable provider name. */
+    name = 'OpenAI Agents SDK';
+    /** Adapter version string. */
+    version = '1.0.0';
+    /** Declared capabilities for this provider. */
+    capabilities = {
+        supportsHooks: false,
+        // The SDK does not expose CLI lifecycle hooks equivalent to Claude Code.
+        supportedHookEvents: [],
+        supportsSpawn: true,
+        supportsInstall: true,
+        supportsInstructionFiles: true,
+        instructionFilePattern: 'AGENTS.md',
+        supportsContextMonitor: false,
+        supportsStatusline: false,
+        supportsProviderPaths: false,
+        supportsTransport: false,
+        supportsTaskSync: false,
+    };
+    /** Spawn provider for SDK-backed agent runs with handoff topology. */
+    spawn;
+    /** Install provider for AGENTS.md and .openai/ config directory management. */
+    install;
+    /** Project directory this adapter was initialized with, or null. */
+    projectDir = null;
+    /** Whether {@link initialize} has been called. */
+    initialized = false;
+    constructor() {
+        this.spawn = new OpenAiSdkSpawnProvider();
+        this.install = new OpenAiSdkInstallProvider();
+    }
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project.
+     */
+    async initialize(projectDir) {
+        this.projectDir = projectDir;
+        this.initialized = true;
+    }
+    /**
+     * Dispose the adapter and release all resources.
+     */
+    async dispose() {
+        this.initialized = false;
+        this.projectDir = null;
+    }
+    /**
+     * Run a health check to verify the OpenAI SDK is usable.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. `OPENAI_API_KEY` is set in the environment
+     *
+     * @returns Health status with details about each check.
+     */
+    async healthCheck() {
+        if (!this.initialized) {
+            return {
+                healthy: false,
+                provider: this.id,
+                details: { error: 'Adapter not initialized' },
+            };
+        }
+        const apiKeyPresent = typeof process.env.OPENAI_API_KEY === 'string' && process.env.OPENAI_API_KEY.length > 0;
+        return {
+            healthy: apiKeyPresent,
+            provider: this.id,
+            details: {
+                apiKeyPresent,
+                projectDir: this.projectDir,
+                sdkVersion: '0.8.3',
+            },
+        };
+    }
+    /**
+     * Check whether the adapter has been initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the project directory this adapter was initialized with.
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/openai-sdk/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/openai-sdk/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,kCAAkC;IACzB,EAAE,GAAG,YAAY,CAAC;IAC3B,oCAAoC;IAC3B,IAAI,GAAG,mBAAmB,CAAC;IACpC,8BAA8B;IACrB,OAAO,GAAG,OAAO,CAAC;IAE3B,+CAA+C;IAC/C,YAAY,GAAwB;QAClC,aAAa,EAAE,KAAK;QACpB,yEAAyE;QACzE,mBAAmB,EAAE,EAAE;QACvB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,wBAAwB,EAAE,IAAI;QAC9B,sBAAsB,EAAE,WAAW;QACnC,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,KAAK;QACzB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;KACxB,CAAC;IAEF,sEAAsE;IACtE,KAAK,CAAyB;IAC9B,+EAA+E;IAC/E,OAAO,CAA2B;IAElC,oEAAoE;IAC5D,UAAU,GAAkB,IAAI,CAAC;IACzC,kDAAkD;IAC1C,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GACjB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAE1F,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,OAAO,EAAE;gBACP,aAAa;gBACb,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,UAAU,EAAE,OAAO;aACpB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}