@calliopelabs/cli 0.4.6 → 0.6.0

package/dist/diff.js

@@ -0,0 +1,317 @@
+/**
+ * Calliope CLI - Diff Preview System
+ *
+ * Shows diffs before applying file changes, with approve/reject workflow.
+ */
+import * as fs from 'fs';
+// ============================================================================
+// Diff Generation
+// ============================================================================
+/**
+ * Simple line-by-line diff algorithm
+ */
+export function generateDiff(oldContent, newContent, path) {
+    const oldLines = oldContent.split('\n');
+    const newLines = newContent.split('\n');
+    const diffLines = [];
+    let additions = 0;
+    let deletions = 0;
+    // Add header
+    diffLines.push({ type: 'header', content: `--- a/${path}` });
+    diffLines.push({ type: 'header', content: `+++ b/${path}` });
+    // Simple LCS-based diff
+    const lcs = longestCommonSubsequence(oldLines, newLines);
+    let oldIdx = 0;
+    let newIdx = 0;
+    let oldLineNum = 1;
+    let newLineNum = 1;
+    for (const [oldLcsIdx, newLcsIdx] of lcs) {
+        // Add deletions (lines in old but not in LCS)
+        while (oldIdx < oldLcsIdx) {
+            diffLines.push({
+                type: 'remove',
+                content: oldLines[oldIdx],
+                oldLineNum: oldLineNum++,
+            });
+            deletions++;
+            oldIdx++;
+        }
+        // Add additions (lines in new but not in LCS)
+        while (newIdx < newLcsIdx) {
+            diffLines.push({
+                type: 'add',
+                content: newLines[newIdx],
+                newLineNum: newLineNum++,
+            });
+            additions++;
+            newIdx++;
+        }
+        // Add context (matching line)
+        diffLines.push({
+            type: 'context',
+            content: oldLines[oldIdx],
+            oldLineNum: oldLineNum++,
+            newLineNum: newLineNum++,
+        });
+        oldIdx++;
+        newIdx++;
+    }
+    // Remaining deletions
+    while (oldIdx < oldLines.length) {
+        diffLines.push({
+            type: 'remove',
+            content: oldLines[oldIdx],
+            oldLineNum: oldLineNum++,
+        });
+        deletions++;
+        oldIdx++;
+    }
+    // Remaining additions
+    while (newIdx < newLines.length) {
+        diffLines.push({
+            type: 'add',
+            content: newLines[newIdx],
+            newLineNum: newLineNum++,
+        });
+        additions++;
+        newIdx++;
+    }
+    return {
+        path,
+        oldContent,
+        newContent,
+        lines: diffLines,
+        additions,
+        deletions,
+    };
+}
+/**
+ * LCS algorithm for diff
+ */
+function longestCommonSubsequence(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array(m + 1).fill(null).map(() => Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack to find LCS indices
+    const result = [];
+    let i = m, j = n;
+    while (i > 0 && j > 0) {
+        if (a[i - 1] === b[j - 1]) {
+            result.unshift([i - 1, j - 1]);
+            i--;
+            j--;
+        }
+        else if (dp[i - 1][j] > dp[i][j - 1]) {
+            i--;
+        }
+        else {
+            j--;
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Diff Formatting
+// ============================================================================
+// ANSI colors
+const COLORS = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    bgRed: '\x1b[41m',
+    bgGreen: '\x1b[42m',
+};
+/**
+ * Format diff for terminal display
+ */
+export function formatDiff(diff, contextLines = 3) {
+    const lines = [];
+    // Header
+    lines.push(`${COLORS.cyan}${diff.lines[0].content}${COLORS.reset}`);
+    lines.push(`${COLORS.cyan}${diff.lines[1].content}${COLORS.reset}`);
+    lines.push('');
+    // Group consecutive changes with context
+    const chunks = groupDiffChunks(diff.lines.slice(2), contextLines);
+    for (const chunk of chunks) {
+        // Chunk header
+        const startOld = chunk.find(l => l.oldLineNum)?.oldLineNum || 1;
+        const startNew = chunk.find(l => l.newLineNum)?.newLineNum || 1;
+        lines.push(`${COLORS.cyan}@@ -${startOld} +${startNew} @@${COLORS.reset}`);
+        for (const line of chunk) {
+            switch (line.type) {
+                case 'add':
+                    lines.push(`${COLORS.green}+${line.content}${COLORS.reset}`);
+                    break;
+                case 'remove':
+                    lines.push(`${COLORS.red}-${line.content}${COLORS.reset}`);
+                    break;
+                case 'context':
+                    lines.push(`${COLORS.dim} ${line.content}${COLORS.reset}`);
+                    break;
+            }
+        }
+        lines.push('');
+    }
+    // Summary
+    lines.push(`${COLORS.green}+${diff.additions}${COLORS.reset} ${COLORS.red}-${diff.deletions}${COLORS.reset}`);
+    return lines.join('\n');
+}
+/**
+ * Format diff as compact summary
+ */
+export function formatDiffSummary(diff) {
+    return `${diff.path}: ${COLORS.green}+${diff.additions}${COLORS.reset} ${COLORS.red}-${diff.deletions}${COLORS.reset}`;
+}
+/**
+ * Group diff lines into chunks with context
+ */
+function groupDiffChunks(lines, contextLines) {
+    const chunks = [];
+    let currentChunk = [];
+    let contextCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.type === 'context') {
+            contextCount++;
+            // Check if there are changes within contextLines ahead
+            let hasChangesAhead = false;
+            for (let j = i + 1; j < Math.min(i + contextLines + 1, lines.length); j++) {
+                if (lines[j].type !== 'context') {
+                    hasChangesAhead = true;
+                    break;
+                }
+            }
+            if (currentChunk.length > 0 || hasChangesAhead) {
+                if (contextCount <= contextLines * 2) {
+                    currentChunk.push(line);
+                }
+                else if (hasChangesAhead) {
+                    // Start new chunk if changes ahead
+                    if (currentChunk.length > 0) {
+                        chunks.push(currentChunk);
+                        currentChunk = [];
+                    }
+                    currentChunk.push(line);
+                    contextCount = 1;
+                }
+            }
+        }
+        else {
+            // Add or remove line
+            currentChunk.push(line);
+            contextCount = 0;
+        }
+    }
+    if (currentChunk.length > 0) {
+        chunks.push(currentChunk);
+    }
+    return chunks;
+}
+// ============================================================================
+// Pending Changes Management
+// ============================================================================
+let pendingChanges = [];
+/**
+ * Queue a file change for approval
+ */
+export function queueChange(type, path, newContent) {
+    const oldContent = fs.existsSync(path) ? fs.readFileSync(path, 'utf-8') : '';
+    const diff = generateDiff(oldContent, newContent, path);
+    const change = {
+        id: `change_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
+        type,
+        path,
+        oldContent,
+        newContent,
+        diff,
+        approved: null,
+    };
+    pendingChanges.push(change);
+    return change;
+}
+/**
+ * Get all pending changes
+ */
+export function getPendingChanges() {
+    return pendingChanges.filter(c => c.approved === null);
+}
+/**
+ * Approve a change and apply it
+ */
+export function approveChange(id) {
+    const change = pendingChanges.find(c => c.id === id);
+    if (!change)
+        return false;
+    change.approved = true;
+    // Apply the change
+    if (change.type === 'delete') {
+        if (fs.existsSync(change.path)) {
+            fs.unlinkSync(change.path);
+        }
+    }
+    else {
+        fs.writeFileSync(change.path, change.newContent);
+    }
+    return true;
+}
+/**
+ * Reject a change
+ */
+export function rejectChange(id) {
+    const change = pendingChanges.find(c => c.id === id);
+    if (!change)
+        return false;
+    change.approved = false;
+    return true;
+}
+/**
+ * Approve all pending changes
+ */
+export function approveAllChanges() {
+    let count = 0;
+    for (const change of pendingChanges) {
+        if (change.approved === null) {
+            approveChange(change.id);
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Reject all pending changes
+ */
+export function rejectAllChanges() {
+    let count = 0;
+    for (const change of pendingChanges) {
+        if (change.approved === null) {
+            rejectChange(change.id);
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Clear change history
+ */
+export function clearChanges() {
+    pendingChanges = [];
+}
+/**
+ * Get change by ID
+ */
+export function getChange(id) {
+    return pendingChanges.find(c => c.id === id);
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Calliope CLI - Error Handling
+ *
+ * Provides retry logic, error classification, and actionable suggestions.
+ */
+export type ErrorCategory = 'network' | 'rate_limit' | 'auth' | 'invalid_request' | 'server' | 'timeout' | 'unknown';
+export interface ClassifiedError {
+    category: ErrorCategory;
+    message: string;
+    suggestion: string;
+    retryable: boolean;
+    retryAfterMs?: number;
+}
+export interface RetryOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+/**
+ * Classify an error and provide actionable suggestions
+ */
+export declare function classifyError(error: unknown): ClassifiedError;
+/**
+ * Format an error for user display
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Wrap an async function to add retry logic
+ */
+export declare function retryable<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
+/**
+ * Get provider-specific suggestions
+ */
+export declare function getProviderSuggestion(provider: string, error: unknown): string | null;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,YAAY,GACZ,MAAM,GACN,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAkH7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASlD;AAoBD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAmCZ;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC1E,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,YAAiB,GACzB,CAAC,CAEH;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAuBrF"}

package/dist/errors.js

@@ -0,0 +1,199 @@
+/**
+ * Calliope CLI - Error Handling
+ *
+ * Provides retry logic, error classification, and actionable suggestions.
+ */
+// ============================================================================
+// Error Classification
+// ============================================================================
+/**
+ * Classify an error and provide actionable suggestions
+ */
+export function classifyError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const lowerMessage = message.toLowerCase();
+    // Network errors
+    if (lowerMessage.includes('econnrefused') ||
+        lowerMessage.includes('enotfound') ||
+        lowerMessage.includes('network') ||
+        lowerMessage.includes('dns') ||
+        lowerMessage.includes('socket')) {
+        return {
+            category: 'network',
+            message: 'Network connection failed',
+            suggestion: 'Check your internet connection and try again.',
+            retryable: true,
+            retryAfterMs: 2000,
+        };
+    }
+    // Rate limiting
+    if (lowerMessage.includes('rate limit') ||
+        lowerMessage.includes('too many requests') ||
+        lowerMessage.includes('429') ||
+        lowerMessage.includes('quota')) {
+        // Try to extract retry-after from error
+        const retryMatch = message.match(/retry.?after[:\s]+(\d+)/i);
+        const retryAfterMs = retryMatch ? parseInt(retryMatch[1]) * 1000 : 60000;
+        return {
+            category: 'rate_limit',
+            message: 'Rate limit exceeded',
+            suggestion: `Wait ${Math.round(retryAfterMs / 1000)} seconds and try again, or switch providers with /provider.`,
+            retryable: true,
+            retryAfterMs,
+        };
+    }
+    // Authentication errors
+    if (lowerMessage.includes('unauthorized') ||
+        lowerMessage.includes('401') ||
+        lowerMessage.includes('api key') ||
+        lowerMessage.includes('authentication') ||
+        lowerMessage.includes('invalid key') ||
+        lowerMessage.includes('invalid_api_key')) {
+        return {
+            category: 'auth',
+            message: 'Authentication failed',
+            suggestion: 'Check your API key with /config or run `calliope --setup` to reconfigure.',
+            retryable: false,
+        };
+    }
+    // Invalid request errors
+    if (lowerMessage.includes('bad request') ||
+        lowerMessage.includes('400') ||
+        lowerMessage.includes('invalid') ||
+        lowerMessage.includes('malformed')) {
+        return {
+            category: 'invalid_request',
+            message: 'Invalid request',
+            suggestion: 'Try rephrasing your message or use /clear to reset the conversation.',
+            retryable: false,
+        };
+    }
+    // Timeout errors
+    if (lowerMessage.includes('timeout') ||
+        lowerMessage.includes('timed out') ||
+        lowerMessage.includes('etimedout')) {
+        return {
+            category: 'timeout',
+            message: 'Request timed out',
+            suggestion: 'The request took too long. Try a simpler query or check server status.',
+            retryable: true,
+            retryAfterMs: 5000,
+        };
+    }
+    // Server errors
+    if (lowerMessage.includes('500') ||
+        lowerMessage.includes('502') ||
+        lowerMessage.includes('503') ||
+        lowerMessage.includes('504') ||
+        lowerMessage.includes('internal server') ||
+        lowerMessage.includes('service unavailable')) {
+        return {
+            category: 'server',
+            message: 'Server error',
+            suggestion: 'The API server is having issues. Wait a moment and try again, or switch providers.',
+            retryable: true,
+            retryAfterMs: 10000,
+        };
+    }
+    // Unknown error
+    return {
+        category: 'unknown',
+        message: message.length > 100 ? message.substring(0, 100) + '...' : message,
+        suggestion: 'An unexpected error occurred. Try again or use /clear to reset.',
+        retryable: true,
+        retryAfterMs: 3000,
+    };
+}
+/**
+ * Format an error for user display
+ */
+export function formatError(error) {
+    const classified = classifyError(error);
+    let output = `✗ ${classified.message}`;
+    if (classified.suggestion) {
+        output += `\n  💡 ${classified.suggestion}`;
+    }
+    return output;
+}
+// ============================================================================
+// Retry Logic
+// ============================================================================
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+};
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function with retry logic
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    let delay = opts.initialDelayMs;
+    for (let attempt = 1; attempt <= opts.maxRetries + 1; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if we should retry
+            const classified = classifyError(error);
+            if (!classified.retryable || attempt > opts.maxRetries) {
+                throw lastError;
+            }
+            // Use the error's suggested delay if available
+            const retryDelay = classified.retryAfterMs
+                ? Math.min(classified.retryAfterMs, opts.maxDelayMs)
+                : Math.min(delay, opts.maxDelayMs);
+            // Notify about retry
+            if (opts.onRetry) {
+                opts.onRetry(attempt, lastError, retryDelay);
+            }
+            await sleep(retryDelay);
+            // Exponential backoff
+            delay *= opts.backoffMultiplier;
+        }
+    }
+    throw lastError || new Error('Max retries exceeded');
+}
+/**
+ * Wrap an async function to add retry logic
+ */
+export function retryable(fn, options = {}) {
+    return ((...args) => withRetry(() => fn(...args), options));
+}
+// ============================================================================
+// Provider-Specific Error Handling
+// ============================================================================
+/**
+ * Get provider-specific suggestions
+ */
+export function getProviderSuggestion(provider, error) {
+    const classified = classifyError(error);
+    if (classified.category === 'auth') {
+        switch (provider) {
+            case 'anthropic':
+                return 'Get your API key at https://console.anthropic.com/';
+            case 'openai':
+                return 'Get your API key at https://platform.openai.com/api-keys';
+            case 'google':
+                return 'Get your API key at https://aistudio.google.com/apikey';
+            case 'openrouter':
+                return 'Get your API key at https://openrouter.ai/keys';
+            default:
+                return null;
+        }
+    }
+    if (classified.category === 'rate_limit') {
+        return `Try switching to another provider with /provider`;
+    }
+    return null;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/file-watcher.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Calliope CLI - File Watcher
+ *
+ * Watch for file changes and notify the agent.
+ */
+export type WatchEventType = 'add' | 'change' | 'unlink';
+export interface WatchEvent {
+    type: WatchEventType;
+    path: string;
+    relativePath: string;
+    timestamp: Date;
+}
+export interface WatcherOptions {
+    patterns?: string[];
+    ignorePatterns?: string[];
+    debounceMs?: number;
+    recursive?: boolean;
+}
+export type WatchCallback = (event: WatchEvent) => void;
+export declare class FileWatcher {
+    private watchers;
+    private callbacks;
+    private debounceTimers;
+    private options;
+    private baseDir;
+    private running;
+    constructor(baseDir: string, options?: WatcherOptions);
+    /**
+     * Start watching
+     */
+    start(): void;
+    /**
+     * Stop watching
+     */
+    stop(): void;
+    /**
+     * Add event listener
+     */
+    on(callback: WatchCallback): void;
+    /**
+     * Remove event listener
+     */
+    off(callback: WatchCallback): void;
+    /**
+     * Watch a directory
+     */
+    private watchDirectory;
+    /**
+     * Check if path should be ignored
+     */
+    private shouldIgnore;
+    /**
+     * Simple pattern matching
+     */
+    private matchPattern;
+    /**
+     * Debounce file events
+     */
+    private debounceEvent;
+    /**
+     * Emit event to callbacks
+     */
+    private emitEvent;
+}
+/**
+ * Get or create global file watcher
+ */
+export declare function getWatcher(baseDir?: string): FileWatcher;
+/**
+ * Start global file watcher
+ */
+export declare function startWatching(baseDir: string, options?: WatcherOptions): FileWatcher;
+/**
+ * Stop global file watcher
+ */
+export declare function stopWatching(): void;
+export interface AggregatedChanges {
+    added: string[];
+    changed: string[];
+    deleted: string[];
+    summary: string;
+}
+/**
+ * Aggregate watch events over a time period
+ */
+export declare function createChangeAggregator(watcher: FileWatcher, windowMs?: number): {
+    getChanges: () => AggregatedChanges;
+    clear: () => void;
+    destroy: () => void;
+};
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../src/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAuBxD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAUzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIjC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAOlC;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,SAAS;CA0BlB;AAQD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAKxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAOpF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAMD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,QAAQ,SAAO,GACd;IACD,UAAU,EAAE,MAAM,iBAAiB,CAAC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA0DA"}