red64-cli 0.1.0

package/dist/services/CacheService.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cache service for offline download caching
+ * Requirements: 6.5, 6.6
+ */
+/**
+ * Cache entry metadata
+ */
+export interface CacheEntry {
+    readonly repo: string;
+    readonly version: string;
+    readonly path: string;
+    readonly cachedAt: string;
+    readonly size: number;
+}
+/**
+ * Cache service configuration
+ */
+export interface CacheServiceConfig {
+    readonly cacheDir?: string;
+}
+/**
+ * Cache service interface
+ * Requirements: 6.5-6.8
+ */
+export interface CacheService {
+    /**
+     * Get cache directory path (platform-specific)
+     */
+    getCacheDir(): string;
+    /**
+     * Check if valid cache entry exists for version
+     */
+    has(repo: string, version: string): Promise<boolean>;
+    /**
+     * Get cached tarball path
+     * @throws CacheError if entry does not exist
+     */
+    get(repo: string, version: string): Promise<CacheEntry>;
+    /**
+     * Store tarball in cache
+     */
+    set(repo: string, version: string, tarballPath: string): Promise<CacheEntry>;
+    /**
+     * Clear cache entries older than maxAge
+     */
+    prune(maxAgeMs: number): Promise<number>;
+    /**
+     * Clear all cache entries
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Create cache service
+ * Task 1.1, 1.2: Cache service factory with platform detection and entry management
+ */
+export declare function createCacheService(config?: CacheServiceConfig): CacheService;
+//# sourceMappingURL=CacheService.d.ts.map

package/dist/services/CacheService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheService.d.ts","sourceRoot":"","sources":["../../src/services/CacheService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7E;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAsGD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,YAAY,CAiIhF"}

package/dist/services/CacheService.js

@@ -0,0 +1,208 @@
+/**
+ * Cache service for offline download caching
+ * Requirements: 6.5, 6.6
+ */
+import { mkdir, readFile, writeFile, rm, access, copyFile, stat } from 'node:fs/promises';
+import { homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Get platform-specific cache directory
+ * Task 1.1: Platform-specific cache directory resolution
+ */
+function getPlatformCacheDir() {
+    const currentPlatform = process.platform;
+    try {
+        const home = homedir();
+        switch (currentPlatform) {
+            case 'darwin':
+                // macOS: ~/Library/Caches/red64
+                return join(home, 'Library', 'Caches', 'red64');
+            case 'linux':
+                // Linux: $XDG_CACHE_HOME/red64 or ~/.cache/red64
+                const xdgCacheHome = process.env.XDG_CACHE_HOME;
+                if (xdgCacheHome) {
+                    return join(xdgCacheHome, 'red64');
+                }
+                return join(home, '.cache', 'red64');
+            case 'win32':
+                // Windows: %LOCALAPPDATA%/red64
+                const localAppData = process.env.LOCALAPPDATA;
+                if (localAppData) {
+                    return join(localAppData, 'red64');
+                }
+                return join(home, 'AppData', 'Local', 'red64');
+            default:
+                // Unknown platform: use home-based cache
+                return join(home, '.cache', 'red64');
+        }
+    }
+    catch {
+        // Fallback to temp directory when home cannot be determined
+        return join(tmpdir(), 'red64-cache');
+    }
+}
+/**
+ * Get cache metadata file path
+ */
+function getCacheMetaPath(cacheDir) {
+    return join(cacheDir, 'cache.json');
+}
+/**
+ * Generate tarball filename from repo and version
+ */
+function getTarballFilename(repo, version) {
+    // Convert owner/repo to owner-repo for filename
+    const safeRepo = repo.replace('/', '-');
+    return `${safeRepo}-${version}.tar.gz`;
+}
+/**
+ * Load cache metadata
+ */
+async function loadMetadata(cacheDir) {
+    const metaPath = getCacheMetaPath(cacheDir);
+    try {
+        const content = await readFile(metaPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return { entries: [] };
+    }
+}
+/**
+ * Save cache metadata
+ */
+async function saveMetadata(cacheDir, metadata) {
+    const metaPath = getCacheMetaPath(cacheDir);
+    await mkdir(cacheDir, { recursive: true });
+    await writeFile(metaPath, JSON.stringify(metadata, null, 2), 'utf-8');
+}
+/**
+ * Find entry in metadata
+ */
+function findEntry(metadata, repo, version) {
+    return metadata.entries.find(entry => entry.repo === repo && entry.version === version);
+}
+/**
+ * Check if file exists
+ */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create cache service
+ * Task 1.1, 1.2: Cache service factory with platform detection and entry management
+ */
+export function createCacheService(config = {}) {
+    const cacheDir = config.cacheDir ?? getPlatformCacheDir();
+    return {
+        getCacheDir() {
+            return cacheDir;
+        },
+        async has(repo, version) {
+            const metadata = await loadMetadata(cacheDir);
+            const entry = findEntry(metadata, repo, version);
+            if (!entry) {
+                return false;
+            }
+            // Verify the file actually exists
+            return fileExists(entry.path);
+        },
+        async get(repo, version) {
+            const metadata = await loadMetadata(cacheDir);
+            const entry = findEntry(metadata, repo, version);
+            if (!entry) {
+                throw new Error('Cache entry not found');
+            }
+            // Verify the file exists
+            const exists = await fileExists(entry.path);
+            if (!exists) {
+                throw new Error('Cache entry not found');
+            }
+            return entry;
+        },
+        async set(repo, version, tarballPath) {
+            // Ensure cache directory exists
+            await mkdir(cacheDir, { recursive: true });
+            // Get file stats
+            const stats = await stat(tarballPath);
+            const size = stats.size;
+            // Determine destination path
+            const filename = getTarballFilename(repo, version);
+            const destPath = join(cacheDir, filename);
+            // Copy tarball to cache directory (if not already there)
+            if (tarballPath !== destPath) {
+                await copyFile(tarballPath, destPath);
+            }
+            // Create entry
+            const entry = {
+                repo,
+                version,
+                path: destPath,
+                cachedAt: new Date().toISOString(),
+                size
+            };
+            // Update metadata
+            const metadata = await loadMetadata(cacheDir);
+            const existingIndex = metadata.entries.findIndex(e => e.repo === repo && e.version === version);
+            if (existingIndex >= 0) {
+                // Update existing entry
+                metadata.entries[existingIndex] = entry;
+            }
+            else {
+                // Add new entry
+                metadata.entries.push(entry);
+            }
+            await saveMetadata(cacheDir, metadata);
+            return entry;
+        },
+        async prune(maxAgeMs) {
+            const metadata = await loadMetadata(cacheDir);
+            const now = Date.now();
+            const cutoff = now - maxAgeMs;
+            let removedCount = 0;
+            const remainingEntries = [];
+            for (const entry of metadata.entries) {
+                const cachedTime = new Date(entry.cachedAt).getTime();
+                if (cachedTime < cutoff) {
+                    // Remove old entry
+                    try {
+                        await rm(entry.path, { force: true });
+                    }
+                    catch {
+                        // Ignore removal errors
+                    }
+                    removedCount++;
+                }
+                else {
+                    remainingEntries.push(entry);
+                }
+            }
+            // Update metadata with remaining entries
+            metadata.entries = remainingEntries;
+            await saveMetadata(cacheDir, metadata);
+            return removedCount;
+        },
+        async clear() {
+            const metadata = await loadMetadata(cacheDir);
+            // Remove all cached files
+            for (const entry of metadata.entries) {
+                try {
+                    await rm(entry.path, { force: true });
+                }
+                catch {
+                    // Ignore removal errors
+                }
+            }
+            // Reset metadata
+            metadata.entries = [];
+            await saveMetadata(cacheDir, metadata);
+        }
+    };
+}
+//# sourceMappingURL=CacheService.js.map

package/dist/services/CacheService.js.map

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

package/dist/services/ClaudeErrorDetector.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Claude CLI Error Detection Service
+ * Parses stdout/stderr from Claude CLI to identify specific error conditions
+ */
+/**
+ * Error codes for Claude CLI-specific failures
+ */
+export type ClaudeErrorCode = 'CREDIT_EXHAUSTED' | 'RATE_LIMITED' | 'AUTH_FAILED' | 'MODEL_UNAVAILABLE' | 'CONTEXT_EXCEEDED' | 'NETWORK_ERROR' | 'PERMISSION_DENIED' | 'UNKNOWN';
+/**
+ * Parsed Claude error with actionable information
+ */
+export interface ClaudeError {
+    readonly code: ClaudeErrorCode;
+    readonly message: string;
+    readonly recoverable: boolean;
+    readonly suggestion: string;
+    readonly retryAfterMs?: number;
+}
+/**
+ * Claude Error Detector Service
+ */
+export interface ClaudeErrorDetectorService {
+    /**
+     * Parse stdout and stderr to detect Claude-specific errors
+     * @returns ClaudeError if a known error pattern is detected, null otherwise
+     */
+    detect(stdout: string, stderr: string): ClaudeError | null;
+    /**
+     * Check if error is fatal (non-recoverable)
+     */
+    isFatal(error: ClaudeError): boolean;
+    /**
+     * Check if error warrants automatic retry
+     */
+    shouldRetry(error: ClaudeError): boolean;
+    /**
+     * Get user-friendly error message
+     */
+    formatErrorMessage(error: ClaudeError): string;
+}
+/**
+ * Create Claude error detector service
+ */
+export declare function createClaudeErrorDetector(): ClaudeErrorDetectorService;
+//# sourceMappingURL=ClaudeErrorDetector.d.ts.map

package/dist/services/ClaudeErrorDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeErrorDetector.d.ts","sourceRoot":"","sources":["../../src/services/ClaudeErrorDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAoKD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAErC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAEzC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,0BAA0B,CA0CtE"}

package/dist/services/ClaudeErrorDetector.js

@@ -0,0 +1,207 @@
+/**
+ * Claude CLI Error Detection Service
+ * Parses stdout/stderr from Claude CLI to identify specific error conditions
+ */
+/**
+ * Error detection patterns
+ * Order matters: more specific patterns should come first
+ */
+const ERROR_PATTERNS = [
+    // Credit/billing errors
+    {
+        pattern: /credit balance is too low/i,
+        code: 'CREDIT_EXHAUSTED',
+        recoverable: false,
+        suggestion: 'Add credits at console.anthropic.com/settings/billing'
+    },
+    {
+        pattern: /insufficient credits/i,
+        code: 'CREDIT_EXHAUSTED',
+        recoverable: false,
+        suggestion: 'Add credits at console.anthropic.com/settings/billing'
+    },
+    {
+        pattern: /billing.*(?:issue|error|problem)/i,
+        code: 'CREDIT_EXHAUSTED',
+        recoverable: false,
+        suggestion: 'Check your billing status at console.anthropic.com/settings/billing'
+    },
+    // Rate limiting
+    {
+        pattern: /rate limit exceeded/i,
+        code: 'RATE_LIMITED',
+        recoverable: true,
+        suggestion: 'Wait a moment and retry, or reduce concurrent requests'
+    },
+    {
+        pattern: /too many requests/i,
+        code: 'RATE_LIMITED',
+        recoverable: true,
+        suggestion: 'Wait a moment and retry'
+    },
+    {
+        pattern: /retry.after.*?(\d+)/i,
+        code: 'RATE_LIMITED',
+        recoverable: true,
+        suggestion: 'Waiting for rate limit to reset...',
+        extractRetryAfter: (match) => {
+            const seconds = parseInt(match[1], 10);
+            return isNaN(seconds) ? undefined : seconds * 1000;
+        }
+    },
+    // Authentication errors
+    {
+        pattern: /invalid.*api.?key/i,
+        code: 'AUTH_FAILED',
+        recoverable: false,
+        suggestion: 'Check your ANTHROPIC_API_KEY environment variable or Claude config'
+    },
+    {
+        pattern: /authentication.*(?:failed|error|invalid)/i,
+        code: 'AUTH_FAILED',
+        recoverable: false,
+        suggestion: 'Verify your API key is correct and active'
+    },
+    {
+        pattern: /unauthorized/i,
+        code: 'AUTH_FAILED',
+        recoverable: false,
+        suggestion: 'Your API key may be invalid or revoked'
+    },
+    {
+        pattern: /api.?key.*(?:missing|not found|required)/i,
+        code: 'AUTH_FAILED',
+        recoverable: false,
+        suggestion: 'Set ANTHROPIC_API_KEY environment variable or configure Claude CLI'
+    },
+    // Model availability
+    {
+        pattern: /model.*(?:not available|unavailable|overloaded)/i,
+        code: 'MODEL_UNAVAILABLE',
+        recoverable: true,
+        suggestion: 'The model is temporarily unavailable. Try again in a few minutes.'
+    },
+    {
+        pattern: /service.*(?:unavailable|overloaded)/i,
+        code: 'MODEL_UNAVAILABLE',
+        recoverable: true,
+        suggestion: 'Anthropic API is temporarily overloaded. Try again shortly.'
+    },
+    {
+        pattern: /503|504|502/,
+        code: 'MODEL_UNAVAILABLE',
+        recoverable: true,
+        suggestion: 'Service temporarily unavailable. Will retry automatically.'
+    },
+    // Context length
+    {
+        pattern: /context.*(?:length|limit).*exceeded/i,
+        code: 'CONTEXT_EXCEEDED',
+        recoverable: false,
+        suggestion: 'Reduce prompt size or split into smaller tasks'
+    },
+    {
+        pattern: /maximum.*tokens.*exceeded/i,
+        code: 'CONTEXT_EXCEEDED',
+        recoverable: false,
+        suggestion: 'The request is too large. Try breaking it into smaller parts.'
+    },
+    {
+        pattern: /prompt.*too.*(?:long|large)/i,
+        code: 'CONTEXT_EXCEEDED',
+        recoverable: false,
+        suggestion: 'Reduce the size of your prompt or context'
+    },
+    // Network errors
+    {
+        pattern: /network.*(?:error|failed|unavailable)/i,
+        code: 'NETWORK_ERROR',
+        recoverable: true,
+        suggestion: 'Check your internet connection and try again'
+    },
+    {
+        pattern: /connection.*(?:refused|reset|timed out)/i,
+        code: 'NETWORK_ERROR',
+        recoverable: true,
+        suggestion: 'Network connection failed. Check your connection and retry.'
+    },
+    {
+        pattern: /ECONNREFUSED|ENOTFOUND|ETIMEDOUT|ECONNRESET/i,
+        code: 'NETWORK_ERROR',
+        recoverable: true,
+        suggestion: 'Network error. Verify internet connectivity.'
+    },
+    {
+        pattern: /fetch.*failed/i,
+        code: 'NETWORK_ERROR',
+        recoverable: true,
+        suggestion: 'Network request failed. Check your connection.'
+    },
+    // Permission/safety
+    {
+        pattern: /(?:content|request).*(?:blocked|refused|rejected)/i,
+        code: 'PERMISSION_DENIED',
+        recoverable: false,
+        suggestion: 'The request was blocked by safety filters'
+    },
+    {
+        pattern: /safety.*(?:filter|check)/i,
+        code: 'PERMISSION_DENIED',
+        recoverable: false,
+        suggestion: 'Content was flagged by safety systems'
+    }
+];
+/**
+ * Create Claude error detector service
+ */
+export function createClaudeErrorDetector() {
+    return {
+        detect(stdout, stderr) {
+            // Combine stdout and stderr for pattern matching
+            // Claude CLI sometimes outputs errors to stdout
+            const combined = `${stdout}\n${stderr}`;
+            for (const errorDef of ERROR_PATTERNS) {
+                const match = combined.match(errorDef.pattern);
+                if (match) {
+                    // Extract the matched text for the error message
+                    const matchedText = match[0];
+                    const retryAfterMs = errorDef.extractRetryAfter?.(match);
+                    return {
+                        code: errorDef.code,
+                        message: matchedText,
+                        recoverable: errorDef.recoverable,
+                        suggestion: errorDef.suggestion,
+                        retryAfterMs
+                    };
+                }
+            }
+            return null;
+        },
+        isFatal(error) {
+            return !error.recoverable;
+        },
+        shouldRetry(error) {
+            // Recoverable errors can be retried
+            // Rate limits should wait for retryAfterMs first
+            return error.recoverable;
+        },
+        formatErrorMessage(error) {
+            const codeLabel = ERROR_CODE_LABELS[error.code] ?? error.code;
+            return `${codeLabel}: ${error.suggestion}`;
+        }
+    };
+}
+/**
+ * Human-readable labels for error codes
+ */
+const ERROR_CODE_LABELS = {
+    CREDIT_EXHAUSTED: 'Insufficient Credits',
+    RATE_LIMITED: 'Rate Limited',
+    AUTH_FAILED: 'Authentication Failed',
+    MODEL_UNAVAILABLE: 'Service Unavailable',
+    CONTEXT_EXCEEDED: 'Context Too Large',
+    NETWORK_ERROR: 'Network Error',
+    PERMISSION_DENIED: 'Request Blocked',
+    UNKNOWN: 'Unknown Error'
+};
+//# sourceMappingURL=ClaudeErrorDetector.js.map

package/dist/services/ClaudeErrorDetector.js.map

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

package/dist/services/ClaudeHealthCheck.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Claude API Health Check Service
+ * Verifies API connectivity and account status before starting flows
+ */
+import { type ClaudeError } from './ClaudeErrorDetector.js';
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    readonly healthy: boolean;
+    readonly error?: ClaudeError;
+    readonly message: string;
+    readonly durationMs: number;
+}
+/**
+ * Health check options
+ */
+export interface HealthCheckOptions {
+    readonly tier?: string;
+    readonly sandbox?: boolean;
+    readonly timeoutMs?: number;
+}
+/**
+ * Claude Health Check Service Interface
+ */
+export interface ClaudeHealthCheckService {
+    /**
+     * Run a quick health check to verify API is ready
+     * Sends a minimal prompt to Claude CLI and checks for errors
+     */
+    check(options?: HealthCheckOptions): Promise<HealthCheckResult>;
+}
+/**
+ * Create Claude health check service
+ */
+export declare function createClaudeHealthCheck(): ClaudeHealthCheckService;
+//# sourceMappingURL=ClaudeHealthCheck.d.ts.map

package/dist/services/ClaudeHealthCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeHealthCheck.d.ts","sourceRoot":"","sources":["../../src/services/ClaudeHealthCheck.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAqDD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,wBAAwB,CA4JlE"}