lettactl 0.2.0 → 0.3.0

package/dist/lib/storage-backend.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Storage backend interface for lettactl
+ * Allows reading content from various sources (filesystem, cloud storage, etc.)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupabaseStorageBackend = exports.FileSystemBackend = exports.StorageBackendManager = void 0;
+/**
+ * Storage backend manager that routes requests to appropriate backends
+ */
+class StorageBackendManager {
+    constructor(options = {}) {
+        this.backends = [];
+        // Always include filesystem backend
+        this.backends.push(new FileSystemBackend());
+        // Store Supabase backend separately since it has different interface
+        this.supabaseBackend = options.supabaseBackend;
+    }
+    async readContent(uri) {
+        const backend = this.backends.find(b => b.canHandle(uri));
+        if (!backend) {
+            throw new Error(`No backend available for URI: ${uri}`);
+        }
+        return backend.readContent(uri);
+    }
+    async listFiles(pattern) {
+        const backend = this.backends.find(b => b.canHandle(pattern));
+        if (!backend) {
+            throw new Error(`No backend available for pattern: ${pattern}`);
+        }
+        return backend.listFiles(pattern);
+    }
+    /**
+     * Convert bucket config to URI for backend routing
+     */
+    async readFromBucket(config) {
+        // Validate bucket config structure
+        this.validateBucketConfig(config);
+        if (config.provider === 'supabase') {
+            if (!this.supabaseBackend) {
+                throw new Error('Supabase backend not configured');
+            }
+            return this.supabaseBackend.readFromBucket(config.bucket, config.path);
+        }
+        // Check for common typos
+        const provider = String(config.provider).toLowerCase();
+        if (provider.includes('supab') || provider.includes('suapb')) {
+            throw new Error(`Provider '${config.provider}' not recognized. Did you mean 'supabase'?`);
+        }
+        // TODO: Add s3, gcs support
+        throw new Error(`Provider '${config.provider}' not yet supported. Supported: supabase. Coming soon: s3, gcs`);
+    }
+    validateBucketConfig(config) {
+        if (!config || typeof config !== 'object') {
+            throw new Error('Invalid from_bucket configuration. Expected object with provider, bucket, and path fields.\n' +
+                'Example:\n' +
+                'from_bucket:\n' +
+                '  provider: supabase\n' +
+                '  bucket: my-bucket\n' +
+                '  path: file.md');
+        }
+        const requiredFields = ['provider', 'bucket', 'path'];
+        const missing = requiredFields.filter(field => !(field in config));
+        if (missing.length > 0) {
+            throw new Error(`Missing required fields in from_bucket config: ${missing.join(', ')}\n` +
+                'Required fields: provider, bucket, path\n' +
+                'Example:\n' +
+                'from_bucket:\n' +
+                '  provider: supabase\n' +
+                '  bucket: my-bucket\n' +
+                '  path: file.md');
+        }
+        // Check for empty/null values
+        const emptyFields = requiredFields.filter(field => {
+            const value = config[field];
+            return value === null || value === undefined || value === '' || (typeof value === 'string' && value.trim() === '');
+        });
+        if (emptyFields.length > 0) {
+            throw new Error(`Empty values not allowed in from_bucket config: ${emptyFields.join(', ')}\n` +
+                'All fields must have non-empty values.\n' +
+                'Example:\n' +
+                'from_bucket:\n' +
+                '  provider: supabase\n' +
+                '  bucket: my-bucket\n' +
+                '  path: file.md');
+        }
+    }
+}
+exports.StorageBackendManager = StorageBackendManager;
+/**
+ * File system storage backend (existing behavior)
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const glob_1 = require("glob");
+class FileSystemBackend {
+    constructor(basePath = '') {
+        this.basePath = basePath;
+    }
+    canHandle(uri) {
+        return !uri.includes('://') || uri.startsWith('file://');
+    }
+    async readContent(uri) {
+        const filePath = this.resolvePath(uri);
+        return fs.readFileSync(filePath, 'utf8');
+    }
+    async listFiles(pattern) {
+        const resolvedPattern = this.resolvePath(pattern);
+        return (0, glob_1.globSync)(resolvedPattern);
+    }
+    resolvePath(uri) {
+        const cleanPath = uri.replace('file://', '');
+        if (path.isAbsolute(cleanPath))
+            return cleanPath;
+        return path.resolve(this.basePath, cleanPath);
+    }
+}
+exports.FileSystemBackend = FileSystemBackend;
+/**
+ * Supabase storage backend for cloud file access
+ */
+const supabase_js_1 = require("@supabase/supabase-js");
+const storage_error_handler_1 = require("./storage-error-handler");
+class SupabaseStorageBackend {
+    constructor() {
+        this.validateEnvironment();
+        // Use generic environment variables for standalone library
+        this.supabase = (0, supabase_js_1.createClient)(process.env.SUPABASE_URL, process.env.SUPABASE_ANON_KEY, {
+            auth: { persistSession: false }
+        });
+    }
+    validateEnvironment() {
+        const requiredVars = ['SUPABASE_URL', 'SUPABASE_ANON_KEY'];
+        const missing = [];
+        for (const envVar of requiredVars) {
+            if (!process.env[envVar]) {
+                missing.push(envVar);
+            }
+        }
+        if (missing.length > 0) {
+            throw new Error(`Missing required environment variables for Supabase: ${missing.join(', ')}\n\n` +
+                'Set them with:\n' +
+                missing.map(v => `export ${v}=<your_value>`).join('\n') +
+                '\n\nOr add them to your .env file.');
+        }
+        // Validate URL format
+        const url = process.env.SUPABASE_URL;
+        try {
+            const parsed = new URL(url);
+            if (!parsed.protocol.startsWith('https')) {
+                throw new Error(`SUPABASE_URL must use HTTPS protocol, got: ${parsed.protocol}`);
+            }
+            if (!url.includes('supabase.co') && !url.includes('localhost')) {
+                console.warn(`Warning: SUPABASE_URL doesn't appear to be a standard Supabase URL: ${url}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('HTTPS')) {
+                throw error; // Re-throw HTTPS-specific error
+            }
+            throw new Error(`Invalid SUPABASE_URL format: ${url}\n` +
+                'Expected format: https://your-project.supabase.co');
+        }
+    }
+    async readFromBucket(bucket, filePath) {
+        try {
+            // Check file metadata first to detect empty files efficiently
+            const pathParts = filePath.split('/');
+            const fileName = pathParts.pop();
+            const folder = pathParts.join('/') || '';
+            const { data: listData, error: listError } = await this.supabase.storage
+                .from(bucket)
+                .list(folder, {
+                search: fileName,
+                limit: 1
+            });
+            if (!listError && listData) {
+                const fileInfo = listData.find((f) => f.name === fileName);
+                if (fileInfo && fileInfo.metadata?.size) {
+                    const size = fileInfo.metadata.size;
+                    if (size <= 40) {
+                        console.warn(`Warning: File '${filePath}' in bucket '${bucket}' is very small (${size} bytes). Check file has meaningful content.`);
+                    }
+                    else if (size > 50 * 1024 * 1024) { // 50MB
+                        console.warn(`Warning: File '${filePath}' in bucket '${bucket}' is very large (${Math.round(size / 1024 / 1024 * 100) / 100}MB). This may cause memory issues or timeouts.`);
+                    }
+                }
+            }
+            const { data, error } = await this.supabase.storage
+                .from(bucket)
+                .download(filePath);
+            if (error) {
+                storage_error_handler_1.StorageErrorHandler.handleProviderError(error, {
+                    provider: 'supabase',
+                    operation: 'download',
+                    bucket,
+                    filePath
+                });
+            }
+            if (!data) {
+                storage_error_handler_1.StorageErrorHandler.handleProviderError({ message: 'No data returned from download' }, { provider: 'supabase', operation: 'download', bucket, filePath });
+            }
+            return await data.text();
+        }
+        catch (error) {
+            // Re-throw our custom errors, handle unexpected ones through error handler
+            if (error.message.includes('Failed to download')) {
+                throw error;
+            }
+            storage_error_handler_1.StorageErrorHandler.handleProviderError(error, {
+                provider: 'supabase',
+                operation: 'download',
+                bucket,
+                filePath
+            });
+        }
+    }
+    async listFiles(bucket, pathPrefix = '') {
+        try {
+            const { data, error } = await this.supabase.storage
+                .from(bucket)
+                .list(pathPrefix, {
+                limit: 1000,
+                sortBy: { column: 'updated_at', order: 'desc' }
+            });
+            if (error) {
+                storage_error_handler_1.StorageErrorHandler.handleProviderError(error, {
+                    provider: 'supabase',
+                    operation: 'list',
+                    bucket,
+                    filePath: pathPrefix
+                });
+            }
+            return data?.map((file) => pathPrefix ? `${pathPrefix}/${file.name}` : file.name) || [];
+        }
+        catch (error) {
+            storage_error_handler_1.StorageErrorHandler.handleProviderError(error, {
+                provider: 'supabase',
+                operation: 'list',
+                bucket,
+                filePath: pathPrefix
+            });
+        }
+    }
+}
+exports.SupabaseStorageBackend = SupabaseStorageBackend;
+//# sourceMappingURL=storage-backend.js.map

package/dist/lib/storage-backend.js.map

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

package/dist/lib/storage-error-handler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Centralized error handling for storage backends
+ * Provides consistent error messages and handling across different cloud providers
+ */
+export interface StorageErrorContext {
+    provider: string;
+    operation: string;
+    bucket?: string;
+    filePath?: string;
+    pattern?: string;
+}
+export declare class StorageErrorHandler {
+    /**
+     * Handle HTTP status-based errors with provider-specific context
+     */
+    static handleHttpError(error: any, context: StorageErrorContext, statusCode?: number): never;
+    /**
+     * Handle provider-specific errors with fallback to generic handling
+     */
+    static handleProviderError(error: any, context: StorageErrorContext): never;
+    /**
+     * Handle Supabase-specific error patterns
+     */
+    private static handleSupabaseError;
+    /**
+     * Handle AWS S3-specific error patterns
+     * TODO: Implement when S3 backend is added
+     */
+    private static handleS3Error;
+    /**
+     * Handle Google Cloud Storage-specific error patterns
+     * TODO: Implement when GCS backend is added
+     */
+    private static handleGCSError;
+    /**
+     * Generic error handling for unknown or unexpected errors
+     */
+    private static handleGenericError;
+    /**
+     * Wrap async storage operations with consistent error handling
+     */
+    static wrapStorageOperation<T>(operation: () => Promise<T>, context: StorageErrorContext): Promise<T>;
+}
+//# sourceMappingURL=storage-error-handler.d.ts.map

package/dist/lib/storage-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/storage-error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAE9B;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,mBAAmB,EAC5B,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK;IAwDR;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE,mBAAmB,GAC3B,KAAK;IAeR;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA6ClC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAM5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAK7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA4BjC;;OAEG;WACU,oBAAoB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC;CAOd"}

package/dist/lib/storage-error-handler.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Centralized error handling for storage backends
+ * Provides consistent error messages and handling across different cloud providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageErrorHandler = void 0;
+class StorageErrorHandler {
+    /**
+     * Handle HTTP status-based errors with provider-specific context
+     */
+    static handleHttpError(error, context, statusCode) {
+        const { provider, operation, bucket, filePath } = context;
+        const resource = bucket && filePath ? `${bucket}/${filePath}` : bucket || filePath || 'resource';
+        let errorMessage = `Failed to ${operation} ${resource} (${provider})`;
+        const status = statusCode || error.status || error.originalError?.status;
+        switch (status) {
+            case 400:
+                if (provider.toLowerCase() === 'supabase') {
+                    // Check if error indicates bucket doesn't exist
+                    if (error.message && (error.message.includes('bucket') || error.message.includes('not found'))) {
+                        errorMessage += `: Bucket '${bucket}' not found. Check: 1) bucket name is spelled correctly, 2) bucket exists in your Supabase project, 3) you're connected to the right project.`;
+                    }
+                    else {
+                        errorMessage += `: Bad request - this could be: 1) bucket '${bucket}' doesn't exist, 2) file '${filePath}' doesn't exist, 3) bucket is private (needs RLS policy or make bucket public), 4) wrong RLS policy configuration, 5) invalid file path '${filePath}', 6) malformed request, or 7) something else (Supabase error messages aren't clear here). Check: bucket exists, file exists, is public or has proper RLS, and file path is correct.`;
+                    }
+                }
+                else {
+                    errorMessage += `: Bad request - this could be: 1) bucket '${bucket}' doesn't exist, 2) invalid file path '${filePath}', or 3) malformed request. Check bucket exists and path is correct.`;
+                }
+                break;
+            case 401:
+                errorMessage += `: Unauthorized. Please check your ${provider} credentials.`;
+                break;
+            case 403:
+                errorMessage += `: Access denied. Please check your ${provider} credentials and bucket permissions.`;
+                break;
+            case 404:
+                if (filePath) {
+                    errorMessage += `: File not found. Please check that '${filePath}' exists in the '${bucket}' bucket.`;
+                }
+                else {
+                    errorMessage += `: Resource not found. Please check the bucket or path exists.`;
+                }
+                break;
+            case 429:
+                errorMessage += `: Rate limit exceeded. Please try again later.`;
+                break;
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                errorMessage += `: ${provider} service outage or maintenance (HTTP ${status}). This is a server-side issue. Please try again in a few minutes or check ${provider} status page.`;
+                break;
+            default:
+                if (status >= 500 && status < 600) {
+                    errorMessage += `: ${provider} server error (HTTP ${status}). Please try again or contact ${provider} support.`;
+                }
+                else if (status) {
+                    errorMessage += `: HTTP ${status} error. Check ${provider} Storage configuration.`;
+                }
+                else {
+                    errorMessage += `: Unknown error. Check ${provider} Storage configuration and network connectivity.`;
+                }
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * Handle provider-specific errors with fallback to generic handling
+     */
+    static handleProviderError(error, context) {
+        const { provider } = context;
+        switch (provider.toLowerCase()) {
+            case 'supabase':
+                return this.handleSupabaseError(error, context);
+            case 's3':
+                return this.handleS3Error(error, context);
+            case 'gcs':
+                return this.handleGCSError(error, context);
+            default:
+                return this.handleGenericError(error, context);
+        }
+    }
+    /**
+     * Handle Supabase-specific error patterns
+     */
+    static handleSupabaseError(error, context) {
+        // Handle StorageUnknownError - check status to differentiate bucket vs auth issues
+        if (error.__isStorageError && error.name === 'StorageUnknownError') {
+            const status = error.originalError?.status;
+            if (status === 400) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    `Bucket '${context.bucket}' doesn't exist. Check: 1) bucket name is spelled correctly, ` +
+                    `2) bucket exists in your Supabase project, 3) you're connected to the right project.`);
+            }
+            else if (!error.originalError || Object.keys(error.originalError).length === 0) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    'Authentication error. Please check your SUPABASE_ANON_KEY is correct and not expired. ' +
+                    'Get a new one from Supabase Dashboard > Settings > API.');
+            }
+        }
+        // Handle Supabase StorageError with originalError
+        if (error.__isStorageError && error.originalError && error.originalError.status) {
+            return this.handleHttpError(error, context, error.originalError.status);
+        }
+        // Handle direct Supabase error messages
+        if (error.message) {
+            if (error.message.includes('Object not found')) {
+                context.operation = 'download';
+                return this.handleHttpError(error, context, 404);
+            }
+            if (error.message.includes('Bucket not found') || error.message.includes('The resource you requested could not be found')) {
+                throw new Error(`Failed to ${context.operation} ${context.bucket}/${context.filePath} (supabase): ` +
+                    `Bucket '${context.bucket}' doesn't exist. Check: 1) bucket name is spelled correctly, ` +
+                    `2) bucket exists in your Supabase project, 3) you're connected to the right project.`);
+            }
+        }
+        // Fallback to generic handling
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Handle AWS S3-specific error patterns
+     * TODO: Implement when S3 backend is added
+     */
+    static handleS3Error(error, context) {
+        // S3-specific error handling will go here
+        // e.g., NoSuchBucket, NoSuchKey, AccessDenied, etc.
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Handle Google Cloud Storage-specific error patterns
+     * TODO: Implement when GCS backend is added
+     */
+    static handleGCSError(error, context) {
+        // GCS-specific error handling will go here
+        return this.handleGenericError(error, context);
+    }
+    /**
+     * Generic error handling for unknown or unexpected errors
+     */
+    static handleGenericError(error, context) {
+        const { provider, operation, bucket, filePath } = context;
+        const resource = bucket && filePath ? `${bucket}/${filePath}` : bucket || filePath || 'resource';
+        // Handle SSL/certificate issues common in corporate environments
+        if (error.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE' ||
+            error.code === 'CERT_UNTRUSTED' ||
+            error.code === 'SELF_SIGNED_CERT_IN_CHAIN' ||
+            error.message?.includes('certificate') ||
+            error.message?.includes('SSL') ||
+            error.message?.includes('TLS')) {
+            throw new Error(`SSL/Certificate error connecting to ${provider}: ${error.message}. ` +
+                `If you're on a corporate network, try: 1) disconnect/reconnect VPN, 2) check with IT about certificate issues, 3) try from a different network.`);
+        }
+        let errorMessage = `${provider} storage error while trying to ${operation} ${resource}`;
+        if (error.message) {
+            errorMessage += `: ${error.message}`;
+        }
+        else {
+            errorMessage += `: ${JSON.stringify(error)}`;
+        }
+        throw new Error(errorMessage);
+    }
+    /**
+     * Wrap async storage operations with consistent error handling
+     */
+    static async wrapStorageOperation(operation, context) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            this.handleProviderError(error, context);
+        }
+    }
+}
+exports.StorageErrorHandler = StorageErrorHandler;
+//# sourceMappingURL=storage-error-handler.js.map

package/dist/lib/storage-error-handler.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lettactl",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "kubectl-style CLI for managing Letta AI agent fleets",
   "main": "dist/index.js",
   "bin": {
@@ -44,10 +44,13 @@
   ],
   "dependencies": {
     "@letta-ai/letta-client": "^1.3.2",
+    "@supabase/supabase-js": "^2.86.2",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.2",
-    "js-yaml": "^4.1.1"
+    "glob": "^13.0.0",
+    "js-yaml": "^4.1.1",
+    "ora": "^9.0.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",