crewly 1.5.22 → 1.6.1

package/dist/cli/backend/src/services/settings/settings.service.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Settings Management Service
+ *
+ * Handles persistence and validation of Crewly application settings.
+ * Settings are stored in ~/.crewly/settings.json.
+ *
+ * @module services/settings/settings.service
+ */
+import { CrewlySettings, UpdateSettingsInput, SettingsValidationResult, ApiKeyProvider, ApiKeyResolutionContext } from '../../types/settings.types.js';
+/**
+ * Error thrown when settings validation fails
+ */
+export declare class SettingsValidationError extends Error {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+/**
+ * Error thrown when settings file cannot be read or parsed
+ */
+export declare class SettingsFileError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Service for managing Crewly application settings
+ *
+ * Settings are stored in ~/.crewly/settings.json by default.
+ * Default values are used when no settings file exists.
+ *
+ * @example
+ * ```typescript
+ * const service = getSettingsService();
+ *
+ * // Get current settings
+ * const settings = await service.getSettings();
+ *
+ * // Update settings
+ * await service.updateSettings({
+ *   general: { verboseLogging: true },
+ * });
+ *
+ * // Reset to defaults
+ * await service.resetSettings();
+ * ```
+ */
+export declare class SettingsService {
+    private readonly settingsDir;
+    private readonly settingsFile;
+    private settingsCache;
+    /**
+     * Create a new SettingsService instance
+     *
+     * @param options - Configuration options
+     * @param options.settingsDir - Directory for settings file
+     */
+    constructor(options?: {
+        settingsDir?: string;
+    });
+    /**
+     * Get current settings, loading from file if not cached
+     *
+     * If settings file doesn't exist or is invalid, returns default settings.
+     *
+     * @returns Current settings
+     */
+    getSettings(): Promise<CrewlySettings>;
+    /**
+     * Update settings with partial input
+     *
+     * Merges the input with current settings and validates before saving.
+     *
+     * @param input - Partial settings to update
+     * @returns Updated settings
+     * @throws {SettingsValidationError} If validation fails
+     */
+    updateSettings(input: UpdateSettingsInput): Promise<CrewlySettings>;
+    /**
+     * Reset all settings to defaults
+     *
+     * @returns Default settings
+     */
+    resetSettings(): Promise<CrewlySettings>;
+    /**
+     * Reset a specific settings section to defaults
+     *
+     * @param section - The section to reset ('general', 'chat', or 'skills')
+     * @returns Updated settings
+     */
+    resetSection(section: keyof CrewlySettings): Promise<CrewlySettings>;
+    /**
+     * Validate settings input without saving
+     *
+     * Useful for form validation before submission.
+     *
+     * @param input - Settings to validate
+     * @returns Validation result
+     */
+    validateSettingsInput(input: UpdateSettingsInput): Promise<SettingsValidationResult>;
+    /**
+     * Export settings to a file
+     *
+     * @param exportPath - Path to export file
+     */
+    exportSettings(exportPath: string): Promise<void>;
+    /**
+     * Import settings from a file
+     *
+     * Validates imported settings before saving.
+     *
+     * @param importPath - Path to import file
+     * @returns Imported settings
+     * @throws {SettingsValidationError} If imported settings are invalid
+     * @throws {SettingsFileError} If file cannot be read or parsed
+     */
+    importSettings(importPath: string): Promise<CrewlySettings>;
+    /**
+     * Resolve an API key through the override chain: skill → runtime → global → env var
+     *
+     * @param provider - The API key provider (gemini, anthropic, openai)
+     * @param context - Optional context with runtime and/or skill for override resolution
+     * @returns The resolved API key or undefined if not configured anywhere
+     */
+    getApiKey(provider: ApiKeyProvider, context?: ApiKeyResolutionContext): Promise<string | undefined>;
+    /**
+     * Clear the settings cache
+     *
+     * Forces the next getSettings call to reload from disk.
+     */
+    clearCache(): void;
+    /**
+     * Get the path to the settings file
+     *
+     * @returns Absolute path to settings.json
+     */
+    getSettingsFilePath(): string;
+    /**
+     * Check if a settings file exists
+     *
+     * @returns True if settings file exists
+     */
+    hasSettingsFile(): Promise<boolean>;
+    /**
+     * Migrate legacy settings format to current format
+     *
+     * Converts old claudeCodeCommand/claudeCodeInitScript fields
+     * to the new runtimeCommands map.
+     *
+     * @param loaded - Partially loaded settings from disk
+     */
+    private migrateSettings;
+    /**
+     * Save settings to disk
+     *
+     * @param settings - Settings to save
+     */
+    private saveSettings;
+}
+/**
+ * Get the singleton SettingsService instance
+ *
+ * @returns The SettingsService instance
+ */
+export declare function getSettingsService(): SettingsService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetSettingsService(): void;
+//# sourceMappingURL=settings.service.d.ts.map

package/dist/cli/backend/src/services/settings/settings.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/settings/settings.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EAKxB,cAAc,EACd,uBAAuB,EAExB,MAAM,+BAA+B,CAAC;AAOvC;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;gBAErB,MAAM,EAAE,MAAM,EAAE;CAK7B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aACG,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,aAAa,CAA+B;IAEpD;;;;;OAKG;gBACS,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAM9C;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAe5C;;;;;;;;OAQG;IACG,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAczE;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAO9C;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAc1E;;;;;;;OAOG;IACG,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAM1F;;;;OAIG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;;;;;;;;OASG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6BjE;;;;;;OAMG;IACG,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKzG;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAazC;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;OAIG;YACW,YAAY;CAI3B;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/cli/backend/src/services/settings/settings.service.js

@@ -0,0 +1,312 @@
+/**
+ * Settings Management Service
+ *
+ * Handles persistence and validation of Crewly application settings.
+ * Settings are stored in ~/.crewly/settings.json.
+ *
+ * @module services/settings/settings.service
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { getDefaultSettings, validateSettings, mergeSettings, resolveApiKey, } from '../../types/settings.types.js';
+import { atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+// ============================================================================
+// Custom Error Classes
+// ============================================================================
+/**
+ * Error thrown when settings validation fails
+ */
+export class SettingsValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Settings validation failed: ${errors.join(', ')}`);
+        this.name = 'SettingsValidationError';
+        this.errors = errors;
+    }
+}
+/**
+ * Error thrown when settings file cannot be read or parsed
+ */
+export class SettingsFileError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'SettingsFileError';
+    }
+}
+// ============================================================================
+// SettingsService Class
+// ============================================================================
+/**
+ * Service for managing Crewly application settings
+ *
+ * Settings are stored in ~/.crewly/settings.json by default.
+ * Default values are used when no settings file exists.
+ *
+ * @example
+ * ```typescript
+ * const service = getSettingsService();
+ *
+ * // Get current settings
+ * const settings = await service.getSettings();
+ *
+ * // Update settings
+ * await service.updateSettings({
+ *   general: { verboseLogging: true },
+ * });
+ *
+ * // Reset to defaults
+ * await service.resetSettings();
+ * ```
+ */
+export class SettingsService {
+    settingsDir;
+    settingsFile;
+    settingsCache = null;
+    /**
+     * Create a new SettingsService instance
+     *
+     * @param options - Configuration options
+     * @param options.settingsDir - Directory for settings file
+     */
+    constructor(options) {
+        this.settingsDir = options?.settingsDir ??
+            path.join(process.env.HOME || '~', '.crewly');
+        this.settingsFile = path.join(this.settingsDir, 'settings.json');
+    }
+    /**
+     * Get current settings, loading from file if not cached
+     *
+     * If settings file doesn't exist or is invalid, returns default settings.
+     *
+     * @returns Current settings
+     */
+    async getSettings() {
+        if (this.settingsCache) {
+            return this.settingsCache;
+        }
+        const loaded = await safeReadJson(this.settingsFile, null);
+        if (loaded) {
+            // Migrate legacy claudeCodeCommand/claudeCodeInitScript → runtimeCommands
+            this.migrateSettings(loaded);
+            this.settingsCache = mergeSettings(getDefaultSettings(), loaded);
+            return this.settingsCache;
+        }
+        return getDefaultSettings();
+    }
+    /**
+     * Update settings with partial input
+     *
+     * Merges the input with current settings and validates before saving.
+     *
+     * @param input - Partial settings to update
+     * @returns Updated settings
+     * @throws {SettingsValidationError} If validation fails
+     */
+    async updateSettings(input) {
+        const current = await this.getSettings();
+        const merged = mergeSettings(current, input);
+        const validation = validateSettings(merged);
+        if (!validation.valid) {
+            throw new SettingsValidationError(validation.errors);
+        }
+        await this.saveSettings(merged);
+        this.settingsCache = merged;
+        return merged;
+    }
+    /**
+     * Reset all settings to defaults
+     *
+     * @returns Default settings
+     */
+    async resetSettings() {
+        const defaults = getDefaultSettings();
+        await this.saveSettings(defaults);
+        this.settingsCache = defaults;
+        return defaults;
+    }
+    /**
+     * Reset a specific settings section to defaults
+     *
+     * @param section - The section to reset ('general', 'chat', or 'skills')
+     * @returns Updated settings
+     */
+    async resetSection(section) {
+        const current = await this.getSettings();
+        const defaults = getDefaultSettings();
+        const updated = {
+            ...current,
+            [section]: defaults[section],
+        };
+        await this.saveSettings(updated);
+        this.settingsCache = updated;
+        return updated;
+    }
+    /**
+     * Validate settings input without saving
+     *
+     * Useful for form validation before submission.
+     *
+     * @param input - Settings to validate
+     * @returns Validation result
+     */
+    async validateSettingsInput(input) {
+        const current = await this.getSettings();
+        const merged = mergeSettings(current, input);
+        return validateSettings(merged);
+    }
+    /**
+     * Export settings to a file
+     *
+     * @param exportPath - Path to export file
+     */
+    async exportSettings(exportPath) {
+        const settings = await this.getSettings();
+        await atomicWriteJson(exportPath, settings);
+    }
+    /**
+     * Import settings from a file
+     *
+     * Validates imported settings before saving.
+     *
+     * @param importPath - Path to import file
+     * @returns Imported settings
+     * @throws {SettingsValidationError} If imported settings are invalid
+     * @throws {SettingsFileError} If file cannot be read or parsed
+     */
+    async importSettings(importPath) {
+        let content;
+        try {
+            content = await fs.readFile(importPath, 'utf-8');
+        }
+        catch (err) {
+            throw new SettingsFileError(`Failed to read settings file: ${importPath}`, err);
+        }
+        let imported;
+        try {
+            imported = JSON.parse(content);
+        }
+        catch (err) {
+            throw new SettingsFileError('Failed to parse settings file: invalid JSON', err);
+        }
+        // Merge with defaults to fill in missing properties
+        const defaults = getDefaultSettings();
+        const merged = mergeSettings(defaults, imported);
+        const validation = validateSettings(merged);
+        if (!validation.valid) {
+            throw new SettingsValidationError(validation.errors);
+        }
+        await this.saveSettings(merged);
+        this.settingsCache = merged;
+        return merged;
+    }
+    /**
+     * Resolve an API key through the override chain: skill → runtime → global → env var
+     *
+     * @param provider - The API key provider (gemini, anthropic, openai)
+     * @param context - Optional context with runtime and/or skill for override resolution
+     * @returns The resolved API key or undefined if not configured anywhere
+     */
+    async getApiKey(provider, context) {
+        const settings = await this.getSettings();
+        return resolveApiKey(provider, settings.apiKeys, context);
+    }
+    /**
+     * Clear the settings cache
+     *
+     * Forces the next getSettings call to reload from disk.
+     */
+    clearCache() {
+        this.settingsCache = null;
+    }
+    /**
+     * Get the path to the settings file
+     *
+     * @returns Absolute path to settings.json
+     */
+    getSettingsFilePath() {
+        return this.settingsFile;
+    }
+    /**
+     * Check if a settings file exists
+     *
+     * @returns True if settings file exists
+     */
+    async hasSettingsFile() {
+        try {
+            await fs.access(this.settingsFile);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    /**
+     * Migrate legacy settings format to current format
+     *
+     * Converts old claudeCodeCommand/claudeCodeInitScript fields
+     * to the new runtimeCommands map.
+     *
+     * @param loaded - Partially loaded settings from disk
+     */
+    migrateSettings(loaded) {
+        const general = loaded.general;
+        if (!general)
+            return;
+        const hasLegacyCommand = typeof general['claudeCodeCommand'] === 'string';
+        const hasRuntimeCommands = general['runtimeCommands'] !== undefined;
+        if (hasLegacyCommand && !hasRuntimeCommands) {
+            const defaults = getDefaultSettings();
+            general['runtimeCommands'] = {
+                'claude-code': general['claudeCodeCommand'],
+                'gemini-cli': defaults.general.runtimeCommands['gemini-cli'],
+                'codex-cli': defaults.general.runtimeCommands['codex-cli'],
+                'crewly-agent': defaults.general.runtimeCommands['crewly-agent'],
+            };
+        }
+        // Keep existing users aligned with the current safer Codex default.
+        // Only rewrite when their value is exactly the previous built-in default.
+        const runtimeCommands = general['runtimeCommands'];
+        if (runtimeCommands?.['codex-cli'] === 'codex --full-auto') {
+            runtimeCommands['codex-cli'] = 'codex -a never -s danger-full-access';
+        }
+        // Clean up legacy fields
+        delete general['claudeCodeCommand'];
+        delete general['claudeCodeInitScript'];
+    }
+    /**
+     * Save settings to disk
+     *
+     * @param settings - Settings to save
+     */
+    async saveSettings(settings) {
+        await fs.mkdir(this.settingsDir, { recursive: true });
+        await atomicWriteJson(this.settingsFile, settings);
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+let settingsServiceInstance = null;
+/**
+ * Get the singleton SettingsService instance
+ *
+ * @returns The SettingsService instance
+ */
+export function getSettingsService() {
+    if (!settingsServiceInstance) {
+        settingsServiceInstance = new SettingsService();
+    }
+    return settingsServiceInstance;
+}
+/**
+ * Reset the singleton instance (for testing)
+ */
+export function resetSettingsService() {
+    settingsServiceInstance = null;
+}
+//# sourceMappingURL=settings.service.js.map

package/dist/cli/backend/src/services/settings/settings.service.js.map

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

package/dist/cli/backend/src/services/skill/skill-executor.service.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Skill Executor Service
+ *
+ * Responsible for executing skills including script execution with
+ * environment variable injection, browser automation coordination,
+ * and MCP tool invocation.
+ *
+ * @module services/skill/skill-executor.service
+ */
+import { SkillWithPrompt, SkillExecutionContext, SkillExecutionResult } from '../../types/skill.types.js';
+/**
+ * A secret value captured for a given skill execution. stdout/stderr will
+ * have this value replaced with `<redacted:{label}>` before being returned
+ * to callers (so the agent/LLM never sees raw credential values in output).
+ *
+ * @internal Exported for unit tests.
+ */
+export interface LiveSecret {
+    value: string;
+    label: string;
+}
+/**
+ * Replace all occurrences of any live secret value in `text` with a
+ * `<redacted:{label}>` placeholder.
+ *
+ * @internal Exported for unit tests; not part of the public service API.
+ */
+export declare function redactSecrets(text: string, secrets: LiveSecret[]): string;
+/**
+ * Service for executing skills
+ *
+ * Handles:
+ * - Script execution with environment variable injection
+ * - Browser automation via Claude's Chrome MCP
+ * - MCP tool invocation
+ * - Composite skill orchestration
+ */
+export declare class SkillExecutorService {
+    private readonly defaultTimeoutMs;
+    private readonly logger;
+    /** Lazy-instantiated helpers for credential refresh. */
+    private geminiCliHelper;
+    private getGeminiCliHelper;
+    /**
+     * Execute a skill by ID
+     *
+     * @param skillId - ID of the skill to execute
+     * @param context - Execution context with agent and task information
+     * @returns Execution result with success status and output
+     */
+    executeSkill(skillId: string, context: SkillExecutionContext): Promise<SkillExecutionResult>;
+    /**
+     * Execute a skill with the full skill object
+     *
+     * @param skill - Full skill object with prompt content
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    executeSkillInternal(skill: SkillWithPrompt, context: SkillExecutionContext): Promise<SkillExecutionResult>;
+    /**
+     * Execute a script-based skill
+     *
+     * @param skill - Skill with script configuration
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    private executeScript;
+    /**
+     * Execute browser automation skill
+     *
+     * This returns instructions for Claude to use with the Chrome MCP.
+     * The actual browser automation is performed by Claude using the
+     * mcp__claude-in-chrome__* tools.
+     *
+     * @param skill - Skill with browser configuration
+     * @param context - Execution context
+     * @returns Execution result with browser automation prompt
+     */
+    private executeBrowserAutomation;
+    /**
+     * Execute MCP tool skill
+     *
+     * Returns instructions for invoking the specified MCP tool.
+     *
+     * @param skill - Skill with MCP tool configuration
+     * @param context - Execution context
+     * @returns Execution result with MCP tool invocation prompt
+     */
+    private executeMcpTool;
+    /**
+     * Execute composite skill (sequence of other skills)
+     *
+     * @param skill - Skill with composite configuration
+     * @param context - Execution context
+     * @returns Combined execution result
+     */
+    private executeComposite;
+    /**
+     * Build environment variables for script execution
+     *
+     * @param skill - Skill with environment configuration
+     * @param context - Execution context
+     * @returns Environment variables object
+     */
+    private buildEnvironment;
+    /**
+     * Build environment variables and collect the list of live secret values
+     * that need to be redacted from the child process's output. Used by
+     * `executeScript` to wire up per-execution output redaction.
+     */
+    private buildEnvironmentWithSecrets;
+    /**
+     * For each credential requirement declared on the skill:
+     * - Resolve it to a credential UUID (agent binding → skill default)
+     * - Look up the credential, decrypt the payload
+     * - Verify scopes (OAuth)
+     * - Refresh tokens if near expiry
+     * - Inject values into env vars named `CREWLY_CRED_<SLOT>_*`
+     * - Register secret values for output redaction
+     */
+    private resolveAndInjectCredentials;
+    /**
+     * Slot name to env var prefix. `gmail-drive` → `CREWLY_CRED_GMAIL_DRIVE`.
+     */
+    private credentialEnvPrefix;
+    /**
+     * Parse .env file content into key-value pairs
+     *
+     * @param content - Content of .env file
+     * @returns Parsed environment variables
+     */
+    private parseEnvFile;
+    /**
+     * Get interpreter command and arguments for script execution
+     *
+     * @param interpreter - Script interpreter type
+     * @param scriptPath - Path to the script file
+     * @returns Command and arguments
+     */
+    private getInterpreterCommand;
+    /**
+     * Spawn a process and capture output
+     *
+     * @param command - Command to execute
+     * @param args - Command arguments
+     * @param options - Execution options
+     * @returns Process result with stdout, stderr, and exit code
+     */
+    private spawnProcess;
+    /**
+     * Build browser automation prompt for Claude
+     *
+     * @param config - Browser configuration
+     * @param context - Execution context
+     * @returns Formatted prompt for browser automation
+     */
+    private buildBrowserAutomationPrompt;
+    /**
+     * Build MCP tool invocation prompt
+     *
+     * @param config - MCP tool configuration
+     * @param context - Execution context
+     * @returns Formatted prompt for MCP tool invocation
+     */
+    private buildMcpToolPrompt;
+}
+/**
+ * Get the singleton SkillExecutorService instance
+ *
+ * @returns The SkillExecutorService instance
+ */
+export declare function getSkillExecutorService(): SkillExecutorService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetSkillExecutorService(): void;
+//# sourceMappingURL=skill-executor.service.d.ts.map

package/dist/cli/backend/src/services/skill/skill-executor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/skill/skill-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EAKrB,MAAM,4BAA4B,CAAC;AAuBpC;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAUzE;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsD;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8F;IAErH,wDAAwD;IACxD,OAAO,CAAC,eAAe,CAAyC;IAEhE,OAAO,CAAC,kBAAkB;IAO1B;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiClG;;;;;;OAMG;IACG,oBAAoB,CACxB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAoEhC;;;;;;OAMG;YACW,aAAa;IA0D3B;;;;;;;;;;OAUG;YACW,wBAAwB;IA8BtC;;;;;;;;OAQG;YACW,cAAc;IA8B5B;;;;;;OAMG;YACW,gBAAgB;IA+C9B;;;;;;OAMG;YACW,gBAAgB;IAS9B;;;;OAIG;YACW,2BAA2B;IA4DzC;;;;;;;;OAQG;YACW,2BAA2B;IA2FzC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA4BpB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAmDpB;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAyBpC;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CAiB3B;AAQD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAK9D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}