ghcralph 0.1.0

package/dist/core/verification-hooks.js

@@ -0,0 +1,268 @@
+/**
+ * Verification Hooks
+ *
+ * Implements objective exit criteria for the Ralph loop.
+ * The original Ralph pattern requires external, objective verification
+ * (tests pass, build succeeds) rather than trusting the AI to say "I'm done".
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { debug, info, warn } from '../utils/index.js';
+const execAsync = promisify(exec);
+/**
+ * Default hooks based on common project patterns
+ */
+export function detectDefaultHooks(_cwd) {
+    const hooks = [];
+    // These will be populated asynchronously, so this returns a starting point
+    // The actual detection happens in VerificationManager.initialize()
+    return hooks;
+}
+/**
+ * Verification Manager
+ *
+ * Runs objective verification hooks after each iteration to determine
+ * if the task is actually complete (not just AI-declared complete).
+ */
+export class VerificationManager {
+    config;
+    detectedHooks = [];
+    initialized = false;
+    constructor(config = {}) {
+        this.config = {
+            cwd: config.cwd ?? process.cwd(),
+            hooks: config.hooks ?? [],
+            stopOnFirstFailure: config.stopOnFirstFailure ?? true,
+        };
+    }
+    /**
+     * Initialize by detecting available verification hooks
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        const cwd = this.config.cwd;
+        // Detect npm scripts
+        try {
+            const packageJsonPath = path.join(cwd, 'package.json');
+            const content = await fs.readFile(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            if (pkg.scripts) {
+                // Check for test script
+                if (pkg.scripts['test']) {
+                    this.detectedHooks.push({
+                        type: 'test',
+                        command: 'npm test',
+                        name: 'npm test',
+                        required: true,
+                        timeoutMs: 120000, // 2 minutes
+                    });
+                }
+                // Check for build script
+                if (pkg.scripts['build']) {
+                    this.detectedHooks.push({
+                        type: 'build',
+                        command: 'npm run build',
+                        name: 'npm build',
+                        required: true,
+                        timeoutMs: 120000,
+                    });
+                }
+                // Check for lint script
+                if (pkg.scripts['lint']) {
+                    this.detectedHooks.push({
+                        type: 'lint',
+                        command: 'npm run lint',
+                        name: 'npm lint',
+                        required: false, // Lint failures shouldn't block completion
+                        timeoutMs: 60000,
+                    });
+                }
+            }
+        }
+        catch {
+            debug('No package.json found or unable to parse');
+        }
+        // Detect Makefile
+        try {
+            await fs.access(path.join(cwd, 'Makefile'));
+            // Check for common targets
+            const makefileContent = await fs.readFile(path.join(cwd, 'Makefile'), 'utf-8');
+            if (makefileContent.includes('test:')) {
+                this.detectedHooks.push({
+                    type: 'test',
+                    command: 'make test',
+                    name: 'make test',
+                    required: true,
+                    timeoutMs: 120000,
+                });
+            }
+            if (makefileContent.includes('build:')) {
+                this.detectedHooks.push({
+                    type: 'build',
+                    command: 'make build',
+                    name: 'make build',
+                    required: true,
+                    timeoutMs: 120000,
+                });
+            }
+        }
+        catch {
+            debug('No Makefile found');
+        }
+        // Detect pytest
+        try {
+            await fs.access(path.join(cwd, 'pytest.ini'));
+            this.detectedHooks.push({
+                type: 'test',
+                command: 'pytest',
+                name: 'pytest',
+                required: true,
+                timeoutMs: 120000,
+            });
+        }
+        catch {
+            // Also check for pyproject.toml with pytest
+            try {
+                const pyprojectPath = path.join(cwd, 'pyproject.toml');
+                const content = await fs.readFile(pyprojectPath, 'utf-8');
+                if (content.includes('[tool.pytest')) {
+                    this.detectedHooks.push({
+                        type: 'test',
+                        command: 'pytest',
+                        name: 'pytest',
+                        required: true,
+                        timeoutMs: 120000,
+                    });
+                }
+            }
+            catch {
+                debug('No pytest configuration found');
+            }
+        }
+        this.initialized = true;
+        debug(`Detected ${this.detectedHooks.length} verification hooks`);
+    }
+    /**
+     * Get all configured hooks (explicit + detected)
+     */
+    getHooks() {
+        return [...this.config.hooks, ...this.detectedHooks];
+    }
+    /**
+     * Add a custom hook
+     */
+    addHook(hook) {
+        this.config.hooks.push(hook);
+    }
+    /**
+     * Run a single verification hook
+     */
+    async runHook(hook) {
+        const startTime = Date.now();
+        const name = hook.name ?? hook.command;
+        info(`Running verification: ${name}`);
+        try {
+            const { stdout, stderr } = await execAsync(hook.command, {
+                cwd: this.config.cwd,
+                timeout: hook.timeoutMs,
+                maxBuffer: 5 * 1024 * 1024, // 5MB
+            });
+            const durationMs = Date.now() - startTime;
+            const output = stdout + (stderr ? `\nSTDERR:\n${stderr}` : '');
+            info(`✓ ${name} passed (${durationMs}ms)`);
+            return {
+                passed: true,
+                hookType: hook.type,
+                message: `${name} passed`,
+                output: output.trim(),
+                durationMs,
+            };
+        }
+        catch (err) {
+            const durationMs = Date.now() - startTime;
+            const execError = err;
+            const output = (execError.stdout ?? '') + (execError.stderr ? `\nSTDERR:\n${execError.stderr}` : '');
+            const message = execError.killed
+                ? `${name} timed out after ${hook.timeoutMs}ms`
+                : `${name} failed`;
+            warn(`✗ ${message}`);
+            const result = {
+                passed: false,
+                hookType: hook.type,
+                message,
+                output: output.trim(),
+                durationMs,
+            };
+            if (execError.message) {
+                result.error = execError.message;
+            }
+            return result;
+        }
+    }
+    /**
+     * Run all verification hooks
+     */
+    async runAll() {
+        await this.initialize();
+        const hooks = this.getHooks();
+        if (hooks.length === 0) {
+            debug('No verification hooks configured');
+            return [];
+        }
+        const results = [];
+        for (const hook of hooks) {
+            const result = await this.runHook(hook);
+            results.push(result);
+            // Stop on first failure if configured
+            if (!result.passed && hook.required && this.config.stopOnFirstFailure) {
+                debug('Stopping verification on first required failure');
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Check if all required hooks passed
+     */
+    allRequiredPassed(results) {
+        const hooks = this.getHooks();
+        const requiredHooks = hooks.filter((h) => h.required);
+        if (requiredHooks.length === 0) {
+            return true; // No required hooks = passes by default
+        }
+        // Check that all required hook types have at least one passing result
+        for (const hook of requiredHooks) {
+            const matchingResults = results.filter((r) => r.hookType === hook.type && (hook.name ? r.message.includes(hook.name) : true));
+            if (matchingResults.length === 0 || !matchingResults.some((r) => r.passed)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get a summary of verification results
+     */
+    getSummary(results) {
+        if (results.length === 0) {
+            return 'No verification hooks ran';
+        }
+        const passed = results.filter((r) => r.passed).length;
+        const failed = results.filter((r) => !r.passed).length;
+        const lines = [`Verification: ${passed} passed, ${failed} failed`];
+        for (const result of results) {
+            const icon = result.passed ? '✓' : '✗';
+            lines.push(`  ${icon} ${result.message} (${result.durationMs}ms)`);
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Create a verification manager with custom configuration
+ */
+export function createVerificationManager(config) {
+    return new VerificationManager(config);
+}
+//# sourceMappingURL=verification-hooks.js.map

package/dist/core/verification-hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GitHub Copilot Ralph CLI - Entry Point
+ *
+ * A cross-platform CLI for running autonomous agentic coding loops
+ * using the Ralph Wiggum pattern with GitHub Copilot.
+ *
+ * Original concept by Geoffrey Huntley (https://ghuntley.com/ralph/)
+ * This implementation by Raphael Pothin (https://github.com/rpothin)
+ */
+export declare const VERSION: string;
+export declare const NAME = "ghcralph";
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,eAAO,MAAM,OAAO,QAAc,CAAC;AACnC,eAAO,MAAM,IAAI,aAAa,CAAC;AAG/B,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * GitHub Copilot Ralph CLI - Entry Point
+ *
+ * A cross-platform CLI for running autonomous agentic coding loops
+ * using the Ralph Wiggum pattern with GitHub Copilot.
+ *
+ * Original concept by Geoffrey Huntley (https://ghuntley.com/ralph/)
+ * This implementation by Raphael Pothin (https://github.com/rpothin)
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+export const VERSION = pkg.version;
+export const NAME = 'ghcralph';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;AAE3G,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC"}

package/dist/integrations/auth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GitHub Authentication
+ *
+ * Handles authentication with GitHub for Copilot access
+ */
+/**
+ * Authentication result
+ */
+export interface AuthResult {
+    /** Whether authentication succeeded */
+    authenticated: boolean;
+    /** Authentication token if available */
+    token?: string;
+    /** Authentication method used */
+    method?: 'gh-cli' | 'env-token' | 'none';
+    /** Error message if authentication failed */
+    error?: string;
+}
+/**
+ * Get GitHub authentication using available methods
+ * Priority: 1. GitHub CLI, 2. Environment variable
+ */
+export declare function getGitHubAuth(): AuthResult;
+/**
+ * Check if GitHub authentication is available
+ */
+export declare function isAuthenticated(): boolean;
+//# sourceMappingURL=auth.d.ts.map

package/dist/integrations/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/integrations/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACzC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8CD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAoB1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/integrations/auth.js

@@ -0,0 +1,76 @@
+/**
+ * GitHub Authentication
+ *
+ * Handles authentication with GitHub for Copilot access
+ */
+import { execSync } from 'node:child_process';
+import { debug, warn } from '../utils/index.js';
+/**
+ * Try to get authentication from the GitHub CLI
+ */
+function tryGhCliAuth() {
+    try {
+        // Check if gh is available and authenticated
+        const token = execSync('gh auth token', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (token) {
+            debug('Authenticated via GitHub CLI');
+            return {
+                authenticated: true,
+                token,
+                method: 'gh-cli',
+            };
+        }
+    }
+    catch {
+        debug('GitHub CLI authentication not available');
+    }
+    return { authenticated: false };
+}
+/**
+ * Try to get authentication from environment variable
+ */
+function tryEnvAuth() {
+    const token = process.env['GITHUB_TOKEN'] ?? process.env['GH_TOKEN'] ?? process.env['COPILOT_CLI_USAGE_TOKEN'];
+    if (token) {
+        debug('Authenticated via environment token');
+        return {
+            authenticated: true,
+            token,
+            method: 'env-token',
+        };
+    }
+    return { authenticated: false };
+}
+/**
+ * Get GitHub authentication using available methods
+ * Priority: 1. GitHub CLI, 2. Environment variable
+ */
+export function getGitHubAuth() {
+    // Try GitHub CLI first
+    const ghCliResult = tryGhCliAuth();
+    if (ghCliResult.authenticated) {
+        return ghCliResult;
+    }
+    // Try environment variable
+    const envResult = tryEnvAuth();
+    if (envResult.authenticated) {
+        return envResult;
+    }
+    // No authentication available
+    warn('No GitHub authentication found');
+    return {
+        authenticated: false,
+        method: 'none',
+        error: 'No GitHub authentication available. Run "gh auth login" or set GITHUB_TOKEN.',
+    };
+}
+/**
+ * Check if GitHub authentication is available
+ */
+export function isAuthenticated() {
+    return getGitHubAuth().authenticated;
+}
+//# sourceMappingURL=auth.js.map

package/dist/integrations/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/integrations/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAgBhD;;GAEG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,6CAA6C;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACtC,OAAO;gBACL,aAAa,EAAE,IAAI;gBACnB,KAAK;gBACL,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAE/G,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7C,OAAO;YACL,aAAa,EAAE,IAAI;YACnB,KAAK;YACL,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,uBAAuB;IACvB,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;IACnC,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACvC,OAAO;QACL,aAAa,EAAE,KAAK;QACpB,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,8EAA8E;KACtF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,EAAE,CAAC,aAAa,CAAC;AACvC,CAAC"}

package/dist/integrations/copilot-agent.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Copilot Agent
+ *
+ * Integration with GitHub Copilot for AI agent capabilities
+ * Uses the @github/copilot-sdk for actual Copilot API access
+ */
+import { type TokenUsage } from './tokens.js';
+/**
+ * Available Copilot models
+ */
+export type CopilotModel = 'gpt-4' | 'gpt-4.1' | 'gpt-4-turbo' | 'gpt-5' | 'claude-sonnet-4.5' | string;
+/**
+ * Copilot agent configuration
+ */
+export interface CopilotAgentConfig {
+    /** Model to use for completions */
+    model: CopilotModel;
+    /** Maximum tokens per request */
+    maxTokensPerRequest: number;
+    /** Number of retries on failure */
+    maxRetries: number;
+    /** Delay between retries in ms */
+    retryDelayMs: number;
+    /** Working directory for file operations */
+    cwd: string;
+}
+/**
+ * Execution result from the agent
+ */
+export interface ExecutionResult {
+    /** Whether the execution succeeded */
+    success: boolean;
+    /** Response content */
+    content?: string;
+    /** Token usage for this request */
+    tokenUsage?: TokenUsage;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Error types for Copilot API
+ */
+export declare class CopilotError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    constructor(message: string, code: string, retryable?: boolean);
+}
+/**
+ * CopilotAgent class for interacting with GitHub Copilot
+ */
+export declare class CopilotAgent {
+    private config;
+    private tokenTracker;
+    private authResult;
+    private initialized;
+    private client;
+    private session;
+    constructor(config?: Partial<CopilotAgentConfig>);
+    /**
+     * Initialize the agent session
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Check if the agent is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Execute a prompt and get a response
+     */
+    execute(prompt: string): Promise<ExecutionResult>;
+    /**
+     * Execute with retry logic using Copilot SDK
+     */
+    private executeWithRetry;
+    /**
+     * Cleanup resources
+     */
+    destroy(): Promise<void>;
+    /**
+     * Get total token usage
+     */
+    getTokenUsage(): TokenUsage;
+    /**
+     * Reset token tracking
+     */
+    resetTokenUsage(): void;
+    /**
+     * Check if token budget is exceeded
+     */
+    isTokenBudgetExceeded(maxTokens: number): boolean;
+    /**
+     * Get the current model
+     */
+    getModel(): CopilotModel;
+    /**
+     * Set the model
+     */
+    setModel(model: CopilotModel): void;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): CopilotAgentConfig;
+}
+//# sourceMappingURL=copilot-agent.d.ts.map

package/dist/integrations/copilot-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-agent.d.ts","sourceRoot":"","sources":["../../src/integrations/copilot-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;CACb;AAaD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAe;CAK7C;AASD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,OAAO,CAA+B;gBAElC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAKpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAsCpC;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAkCvD;;OAEG;YACW,gBAAgB;IAqD9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;IACH,aAAa,IAAI,UAAU;IAI3B;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKnC;;OAEG;IACH,SAAS,IAAI,kBAAkB;CAGhC"}