steroids-api 0.2.7

package/dist/src/providers/gemini.js

@@ -0,0 +1,240 @@
+/**
+ * Gemini Provider
+ * Implementation for Google Gemini CLI
+ */
+import { spawn } from 'node:child_process';
+import { writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BaseAIProvider, } from './interface.js';
+/**
+ * Available Gemini models
+ */
+const GEMINI_MODELS = [
+    {
+        id: 'gemini-pro',
+        name: 'Gemini Pro',
+        recommendedFor: ['coder'],
+        supportsStreaming: true,
+    },
+    {
+        id: 'gemini-ultra',
+        name: 'Gemini Ultra',
+        recommendedFor: ['orchestrator', 'reviewer'],
+        supportsStreaming: true,
+    },
+    {
+        id: 'gemini-flash',
+        name: 'Gemini Flash',
+        recommendedFor: [],
+        supportsStreaming: true,
+    },
+];
+/**
+ * Default models per role
+ */
+const DEFAULT_MODELS = {
+    orchestrator: 'gemini-ultra',
+    coder: 'gemini-pro',
+    reviewer: 'gemini-ultra',
+};
+/**
+ * Default timeout in milliseconds (15 minutes)
+ */
+const DEFAULT_TIMEOUT = 900_000;
+/**
+ * Default invocation template for Gemini CLI
+ * Uses -p flag for non-interactive (headless) mode with prompt from file
+ */
+const DEFAULT_INVOCATION_TEMPLATE = '{cli} -p "$(cat {prompt_file})" -m {model}';
+/**
+ * Gemini AI Provider implementation
+ */
+export class GeminiProvider extends BaseAIProvider {
+    name = 'gemini';
+    displayName = 'Google Gemini';
+    /**
+     * Write prompt to a temporary file
+     */
+    writePromptFile(prompt) {
+        const tempPath = join(tmpdir(), `steroids-gemini-${Date.now()}.txt`);
+        writeFileSync(tempPath, prompt, { mode: 0o600 });
+        return tempPath;
+    }
+    /**
+     * Clean up temporary prompt file
+     */
+    cleanupPromptFile(path) {
+        try {
+            if (existsSync(path)) {
+                unlinkSync(path);
+            }
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+    /**
+     * Get the default invocation template
+     */
+    getDefaultInvocationTemplate() {
+        return DEFAULT_INVOCATION_TEMPLATE;
+    }
+    /**
+     * Invoke Gemini CLI with a prompt
+     */
+    async invoke(prompt, options) {
+        const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        const cwd = options.cwd ?? process.cwd();
+        const streamOutput = options.streamOutput ?? true;
+        const onActivity = options.onActivity;
+        // Apply custom invocation template if provided in options
+        if (options.invocationTemplate) {
+            this.setInvocationTemplate(options.invocationTemplate);
+        }
+        // Write prompt to temp file
+        const promptFile = options.promptFile ?? this.writePromptFile(prompt);
+        const createdTempFile = !options.promptFile;
+        try {
+            return await this.invokeWithFile(promptFile, options.model, timeout, cwd, streamOutput, onActivity);
+        }
+        finally {
+            if (createdTempFile) {
+                this.cleanupPromptFile(promptFile);
+            }
+        }
+    }
+    /**
+     * Invoke Gemini CLI with a prompt file using the invocation template
+     */
+    invokeWithFile(promptFile, model, timeout, cwd, streamOutput, onActivity) {
+        return new Promise((resolve) => {
+            const startTime = Date.now();
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            // Build command from invocation template
+            const command = this.buildCommand(promptFile, model);
+            // Spawn using shell to handle the command template
+            const child = spawn(command, {
+                shell: true,
+                cwd,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                // Force kill after 5 seconds if still running
+                setTimeout(() => {
+                    if (!child.killed) {
+                        child.kill('SIGKILL');
+                    }
+                }, 5000);
+            }, timeout);
+            child.stdout?.on('data', (data) => {
+                const text = data.toString();
+                stdout += text;
+                onActivity?.({ type: 'output', stream: 'stdout', msg: text });
+                if (streamOutput) {
+                    process.stdout.write(text);
+                }
+            });
+            child.stderr?.on('data', (data) => {
+                const text = data.toString();
+                stderr += text;
+                onActivity?.({ type: 'output', stream: 'stderr', msg: text });
+                if (streamOutput) {
+                    process.stderr.write(text);
+                }
+            });
+            child.on('close', (code) => {
+                clearTimeout(timeoutHandle);
+                const duration = Date.now() - startTime;
+                resolve({
+                    success: code === 0 && !timedOut,
+                    exitCode: code ?? 1,
+                    stdout,
+                    stderr,
+                    duration,
+                    timedOut,
+                });
+            });
+            child.on('error', (error) => {
+                clearTimeout(timeoutHandle);
+                const duration = Date.now() - startTime;
+                resolve({
+                    success: false,
+                    exitCode: 1,
+                    stdout,
+                    stderr: error.message,
+                    duration,
+                    timedOut: false,
+                });
+            });
+        });
+    }
+    /**
+     * Check if Gemini CLI is available
+     * Checks for both 'gemini' and 'gcloud' CLIs
+     */
+    async isAvailable() {
+        const cli = this.cliPath ?? 'gemini';
+        // First try the specified or default gemini CLI
+        const geminiAvailable = await this.checkCliAvailable(cli);
+        if (geminiAvailable) {
+            return true;
+        }
+        // Fall back to gcloud if gemini CLI not found
+        if (cli === 'gemini') {
+            return this.checkCliAvailable('gcloud');
+        }
+        return false;
+    }
+    /**
+     * Check if a specific CLI is available
+     */
+    checkCliAvailable(cli) {
+        return new Promise((resolve) => {
+            const child = spawn('which', [cli], {
+                shell: true,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            child.on('close', (code) => {
+                resolve(code === 0);
+            });
+            child.on('error', () => {
+                resolve(false);
+            });
+            // Timeout after 5 seconds
+            setTimeout(() => {
+                child.kill();
+                resolve(false);
+            }, 5000);
+        });
+    }
+    /**
+     * List available model IDs
+     */
+    listModels() {
+        return GEMINI_MODELS.map((m) => m.id);
+    }
+    /**
+     * Get detailed model information
+     */
+    getModelInfo() {
+        return [...GEMINI_MODELS];
+    }
+    /**
+     * Get the default model for a role
+     */
+    getDefaultModel(role) {
+        return DEFAULT_MODELS[role];
+    }
+}
+/**
+ * Create a Gemini provider instance
+ */
+export function createGeminiProvider() {
+    return new GeminiProvider();
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/providers/gemini.js.map

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

package/dist/src/providers/interface.d.ts

@@ -0,0 +1,185 @@
+/**
+ * AI Provider Interface
+ * Defines the contract for AI providers (Claude, Gemini, OpenAI, etc.)
+ */
+/**
+ * Options for invoking an AI provider
+ */
+export interface InvokeOptions {
+    /** Model identifier (e.g., 'claude-sonnet-4', 'gpt-4') */
+    model: string;
+    /** Timeout in milliseconds (default: 900000 = 15 minutes) */
+    timeout?: number;
+    /** Working directory for the invocation */
+    cwd?: string;
+    /** Path to prompt file (alternative to inline prompt) */
+    promptFile?: string;
+    /** Role for this invocation (orchestrator, coder, reviewer) */
+    role?: 'orchestrator' | 'coder' | 'reviewer';
+    /** Custom invocation template (e.g., "claude -p {prompt_file} --model {model}") */
+    invocationTemplate?: string;
+    /** Whether to stream output to stdout/stderr */
+    streamOutput?: boolean;
+    /**
+     * Optional activity callback for live monitoring.
+     * Providers should emit lightweight JSON-serializable events as work progresses.
+     */
+    onActivity?: (activity: InvocationActivity) => void;
+}
+/**
+ * Activity entry emitted during a provider invocation.
+ * Kept intentionally flexible (JSONL logger appends arbitrary fields).
+ */
+export type InvocationActivity = Record<string, unknown> & {
+    type: string;
+};
+/**
+ * Result of an AI provider invocation
+ */
+export interface InvokeResult {
+    /** Whether the invocation succeeded (exit code 0) */
+    success: boolean;
+    /** Exit code from the CLI process */
+    exitCode: number;
+    /** Standard output from the process */
+    stdout: string;
+    /** Standard error from the process */
+    stderr: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Whether the process was killed due to timeout */
+    timedOut: boolean;
+}
+/**
+ * Error types that can be classified from provider output
+ */
+export type ProviderErrorType = 'rate_limit' | 'auth_error' | 'network_error' | 'model_not_found' | 'context_exceeded' | 'subprocess_hung' | 'unknown';
+/**
+ * Classified error from provider invocation
+ */
+export interface ProviderError {
+    /** Type of error */
+    type: ProviderErrorType;
+    /** Human-readable error message */
+    message: string;
+    /** Whether this error is retryable */
+    retryable: boolean;
+    /** Suggested retry delay in milliseconds */
+    retryAfterMs?: number;
+}
+/**
+ * Model information
+ */
+export interface ModelInfo {
+    /** Model identifier used for invocation */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Recommended role for this model */
+    recommendedFor?: ('orchestrator' | 'coder' | 'reviewer')[];
+    /** Whether this model supports streaming */
+    supportsStreaming?: boolean;
+}
+/**
+ * AI Provider interface
+ * All providers must implement this interface
+ */
+export interface IAIProvider {
+    /** Provider name (e.g., 'claude', 'gemini', 'openai') */
+    readonly name: string;
+    /** Human-readable display name */
+    readonly displayName: string;
+    /**
+     * Invoke the provider with a prompt
+     * @param prompt The prompt text to send
+     * @param options Invocation options
+     * @returns Promise resolving to the invocation result
+     */
+    invoke(prompt: string, options: InvokeOptions): Promise<InvokeResult>;
+    /**
+     * Check if this provider is available (CLI installed and accessible)
+     * @returns Promise resolving to true if available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * List available models for this provider
+     * @returns Array of model identifiers
+     */
+    listModels(): string[];
+    /**
+     * Get detailed model information
+     * @returns Array of model info objects
+     */
+    getModelInfo(): ModelInfo[];
+    /**
+     * Get the default model for a role
+     * @param role The role to get default model for
+     * @returns Default model ID or undefined
+     */
+    getDefaultModel(role: 'orchestrator' | 'coder' | 'reviewer'): string | undefined;
+    /**
+     * Classify an error from stderr output
+     * @param exitCode The process exit code
+     * @param stderr The stderr output
+     * @returns Classified error or null if not an error
+     */
+    classifyError(exitCode: number, stderr: string): ProviderError | null;
+    /**
+     * Get the CLI path for this provider
+     * @returns Path to CLI executable or undefined if using default
+     */
+    getCliPath(): string | undefined;
+    /**
+     * Set a custom CLI path
+     * @param path Path to CLI executable
+     */
+    setCliPath(path: string): void;
+    /**
+     * Get the default invocation template
+     * @returns Default template with {prompt_file} and {model} placeholders
+     */
+    getDefaultInvocationTemplate(): string;
+    /**
+     * Set a custom invocation template
+     * @param template Custom template with {prompt_file} and {model} placeholders
+     */
+    setInvocationTemplate(template: string): void;
+    /**
+     * Get the current invocation template
+     * @returns Current template (custom or default)
+     */
+    getInvocationTemplate(): string;
+}
+/**
+ * Base abstract class for AI providers
+ * Provides common functionality
+ */
+export declare abstract class BaseAIProvider implements IAIProvider {
+    abstract readonly name: string;
+    abstract readonly displayName: string;
+    protected cliPath: string | undefined;
+    protected invocationTemplate: string | undefined;
+    abstract invoke(prompt: string, options: InvokeOptions): Promise<InvokeResult>;
+    abstract isAvailable(): Promise<boolean>;
+    abstract listModels(): string[];
+    abstract getModelInfo(): ModelInfo[];
+    abstract getDefaultModel(role: 'orchestrator' | 'coder' | 'reviewer'): string | undefined;
+    abstract getDefaultInvocationTemplate(): string;
+    /**
+     * Classify an error based on exit code and stderr
+     * Subclasses can override for provider-specific error detection
+     */
+    classifyError(exitCode: number, stderr: string): ProviderError | null;
+    getCliPath(): string | undefined;
+    setCliPath(path: string): void;
+    setInvocationTemplate(template: string): void;
+    getInvocationTemplate(): string;
+    /**
+     * Build the command from the invocation template
+     * @param promptFile Path to the prompt file
+     * @param model Model identifier
+     * @returns Command string ready for execution
+     */
+    protected buildCommand(promptFile: string, model: string): string;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/src/providers/interface.d.ts.map

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

package/dist/src/providers/interface.js

@@ -0,0 +1,92 @@
+/**
+ * AI Provider Interface
+ * Defines the contract for AI providers (Claude, Gemini, OpenAI, etc.)
+ */
+/**
+ * Base abstract class for AI providers
+ * Provides common functionality
+ */
+export class BaseAIProvider {
+    cliPath;
+    invocationTemplate;
+    /**
+     * Classify an error based on exit code and stderr
+     * Subclasses can override for provider-specific error detection
+     */
+    classifyError(exitCode, stderr) {
+        if (exitCode === 0) {
+            return null;
+        }
+        const stderrLower = stderr.toLowerCase();
+        if (stderrLower.includes('rate limit') || stderr.includes('429')) {
+            return {
+                type: 'rate_limit',
+                message: 'Rate limit exceeded',
+                retryable: true,
+                retryAfterMs: 60000,
+            };
+        }
+        if (stderrLower.includes('unauthorized') || stderrLower.includes('auth')) {
+            return {
+                type: 'auth_error',
+                message: 'Authentication failed',
+                retryable: false,
+            };
+        }
+        if (stderrLower.includes('connection') || stderrLower.includes('timeout') ||
+            stderrLower.includes('network')) {
+            return {
+                type: 'network_error',
+                message: 'Network error',
+                retryable: true,
+            };
+        }
+        if (stderrLower.includes('model') && stderrLower.includes('not found')) {
+            return {
+                type: 'model_not_found',
+                message: 'Model not found',
+                retryable: false,
+            };
+        }
+        if (stderrLower.includes('context') || stderrLower.includes('token limit') ||
+            stderrLower.includes('too long')) {
+            return {
+                type: 'context_exceeded',
+                message: 'Context limit exceeded',
+                retryable: false,
+            };
+        }
+        return {
+            type: 'unknown',
+            message: stderr.slice(0, 200) || 'Unknown error',
+            retryable: true,
+        };
+    }
+    getCliPath() {
+        return this.cliPath;
+    }
+    setCliPath(path) {
+        this.cliPath = path;
+    }
+    setInvocationTemplate(template) {
+        this.invocationTemplate = template;
+    }
+    getInvocationTemplate() {
+        return this.invocationTemplate ?? this.getDefaultInvocationTemplate();
+    }
+    /**
+     * Build the command from the invocation template
+     * @param promptFile Path to the prompt file
+     * @param model Model identifier
+     * @returns Command string ready for execution
+     */
+    buildCommand(promptFile, model) {
+        const template = this.getInvocationTemplate();
+        const cli = this.cliPath ?? this.name;
+        return template
+            .replace('{cli}', cli)
+            .replace('{prompt_file}', promptFile)
+            .replace('{model}', model);
+    }
+}
+//# sourceMappingURL=interface.js.map

package/dist/src/providers/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../../src/providers/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8KH;;;GAGG;AACH,MAAM,OAAgB,cAAc;IAIxB,OAAO,CAAqB;IAC5B,kBAAkB,CAAqB;IASjD;;;OAGG;IACH,aAAa,CAAC,QAAgB,EAAE,MAAc;QAC5C,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEzC,IAAI,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,qBAAqB;gBAC9B,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,uBAAuB;gBAChC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC;YACrE,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,eAAe;gBACxB,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACvE,OAAO;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,iBAAiB;gBAC1B,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,aAAa,CAAC;YACtE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,wBAAwB;gBACjC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe;YAChD,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,qBAAqB,CAAC,QAAgB;QACpC,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC;IACrC,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,4BAA4B,EAAE,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACO,YAAY,CAAC,UAAkB,EAAE,KAAa;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;QAEtC,OAAO,QAAQ;aACZ,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC;aACpC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/providers/invocation-logger.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Invocation Logger
+ * Logs all LLM invocations for debugging and audit purposes
+ */
+import type { InvocationActivity, InvokeResult } from './interface.js';
+/**
+ * Log entry for an LLM invocation
+ */
+export interface InvocationLogEntry {
+    timestamp: string;
+    role: 'orchestrator' | 'coder' | 'reviewer';
+    provider: string;
+    model: string;
+    taskId?: string;
+    duration: number;
+    exitCode: number;
+    success: boolean;
+    timedOut: boolean;
+    prompt: string;
+    response: string;
+    error?: string;
+}
+/**
+ * Configuration for invocation logging
+ */
+export interface InvocationLoggerConfig {
+    enabled?: boolean;
+    logsDir?: string;
+    retentionDays?: number;
+    includePrompts?: boolean;
+    includeResponses?: boolean;
+}
+/**
+ * Invocation Logger
+ * Logs LLM invocations to disk for debugging and audit
+ */
+export declare class InvocationLogger {
+    private config;
+    constructor(config?: InvocationLoggerConfig);
+    /**
+     * Log an invocation
+     */
+    log(entry: InvocationLogEntry): void;
+    /**
+     * Create log file name
+     */
+    private createLogFileName;
+    /**
+     * Format log entry as text
+     */
+    private formatLogEntry;
+    /**
+     * Ensure logs directory exists
+     */
+    private ensureLogsDirectory;
+    /**
+     * Clean up old logs based on retention policy
+     */
+    private cleanupOldLogs;
+    /**
+     * Get all log files
+     */
+    getAllLogs(): string[];
+    /**
+     * Purge all logs
+     */
+    purgeAll(): void;
+    /**
+     * Get total size of all logs in bytes
+     */
+    getTotalSize(): number;
+}
+/**
+ * Get the global invocation logger
+ */
+export declare function getInvocationLogger(config?: InvocationLoggerConfig): InvocationLogger;
+/**
+ * Set the global invocation logger
+ */
+export declare function setInvocationLogger(logger: InvocationLogger): void;
+/**
+ * Reset the global invocation logger
+ */
+export declare function resetInvocationLogger(): void;
+type InvocationInvokeContext = {
+    onActivity?: (activity: InvocationActivity) => void;
+};
+export declare function logInvocation(prompt: string, invokeOrResult: ((ctx?: InvocationInvokeContext) => Promise<InvokeResult>) | InvokeResult, metadata: {
+    role: 'orchestrator' | 'coder' | 'reviewer';
+    provider: string;
+    model: string;
+    taskId?: string;
+    projectPath?: string;
+    rejectionNumber?: number;
+}): Promise<InvokeResult>;
+export {};
+//# sourceMappingURL=invocation-logger.d.ts.map

package/dist/src/providers/invocation-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-logger.d.ts","sourceRoot":"","sources":["../../../../src/providers/invocation-logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAaD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAmC;gBAErC,MAAM,GAAE,sBAA2B;IAI/C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IA2BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkDtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IA6BtB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,YAAY,IAAI,MAAM;CAevB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,CAKrF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,KAAK,uBAAuB,GAAG;IAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;CAAE,CAAC;AAoBvF,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,uBAAuB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,YAAY,EACzF,QAAQ,EAAE;IACR,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,YAAY,CAAC,CA0JvB"}