claudia-orchestrator 0.1.0

package/dist/services/file-system-service.js

@@ -0,0 +1,348 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { existsSync, constants } from 'fs';
+import ignore from 'ignore';
+import { CUIError } from '../types/index.js';
+import { createLogger } from './logger.js';
+const execAsync = promisify(exec);
+/**
+ * Service for secure file system operations
+ */
+export class FileSystemService {
+    logger;
+    maxFileSize = 10 * 1024 * 1024; // 10MB default
+    allowedBasePaths = []; // Empty means all paths allowed
+    constructor(maxFileSize, allowedBasePaths) {
+        this.logger = createLogger('FileSystemService');
+        if (maxFileSize !== undefined) {
+            this.maxFileSize = maxFileSize;
+        }
+        if (allowedBasePaths) {
+            this.allowedBasePaths = allowedBasePaths.map(p => path.normalize(p));
+        }
+    }
+    /**
+     * List directory contents with security checks
+     */
+    async listDirectory(requestedPath, recursive = false, respectGitignore = false) {
+        this.logger.debug('List directory requested', { requestedPath, recursive, respectGitignore });
+        try {
+            // Validate and normalize path
+            const safePath = await this.validatePath(requestedPath);
+            // Check if path exists and is a directory
+            const stats = await fs.stat(safePath);
+            if (!stats.isDirectory()) {
+                throw new CUIError('NOT_A_DIRECTORY', `Path is not a directory: ${requestedPath}`, 400);
+            }
+            // Initialize gitignore if requested
+            let ig = null;
+            if (respectGitignore) {
+                ig = await this.loadGitignore(safePath);
+            }
+            // Get entries
+            const entries = recursive
+                ? await this.listDirectoryRecursive(safePath, safePath, ig)
+                : await this.listDirectoryFlat(safePath, ig);
+            // Sort entries: directories first, then by name
+            entries.sort((a, b) => {
+                if (a.type !== b.type) {
+                    return a.type === 'directory' ? -1 : 1;
+                }
+                return a.name.localeCompare(b.name);
+            });
+            this.logger.debug('Directory listed successfully', {
+                path: safePath,
+                entryCount: entries.length,
+                recursive,
+                respectGitignore
+            });
+            return {
+                path: safePath,
+                entries,
+                total: entries.length
+            };
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            const errorCode = error.code;
+            if (errorCode === 'ENOENT') {
+                throw new CUIError('PATH_NOT_FOUND', `Path not found: ${requestedPath}`, 404);
+            }
+            else if (errorCode === 'EACCES') {
+                throw new CUIError('ACCESS_DENIED', `Access denied to path: ${requestedPath}`, 403);
+            }
+            this.logger.error('Error listing directory', error, { requestedPath });
+            throw new CUIError('LIST_DIRECTORY_FAILED', `Failed to list directory: ${error}`, 500);
+        }
+    }
+    /**
+     * Read file contents with security checks
+     */
+    async readFile(requestedPath) {
+        this.logger.debug('Read file requested', { requestedPath });
+        try {
+            // Validate and normalize path
+            const safePath = await this.validatePath(requestedPath);
+            // Check if path exists and is a file
+            const stats = await fs.stat(safePath);
+            if (!stats.isFile()) {
+                throw new CUIError('NOT_A_FILE', `Path is not a file: ${requestedPath}`, 400);
+            }
+            // Check file size
+            if (stats.size > this.maxFileSize) {
+                throw new CUIError('FILE_TOO_LARGE', `File size (${stats.size} bytes) exceeds maximum allowed size (${this.maxFileSize} bytes)`, 400);
+            }
+            // Read file content
+            const content = await fs.readFile(safePath, 'utf-8');
+            // Check if content is valid UTF-8 text
+            if (!this.isValidUtf8(content)) {
+                throw new CUIError('BINARY_FILE', 'File appears to be binary or not valid UTF-8', 400);
+            }
+            this.logger.debug('File read successfully', {
+                path: safePath,
+                size: stats.size
+            });
+            return {
+                path: safePath,
+                content,
+                size: stats.size,
+                lastModified: stats.mtime.toISOString(),
+                encoding: 'utf-8'
+            };
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            const errorCode = error.code;
+            if (errorCode === 'ENOENT') {
+                throw new CUIError('FILE_NOT_FOUND', `File not found: ${requestedPath}`, 404);
+            }
+            else if (errorCode === 'EACCES') {
+                throw new CUIError('ACCESS_DENIED', `Access denied to file: ${requestedPath}`, 403);
+            }
+            this.logger.error('Error reading file', error, { requestedPath });
+            throw new CUIError('READ_FILE_FAILED', `Failed to read file: ${error}`, 500);
+        }
+    }
+    /**
+     * Validate and normalize a path to prevent path traversal attacks
+     */
+    async validatePath(requestedPath) {
+        // Require absolute paths
+        if (!path.isAbsolute(requestedPath)) {
+            throw new CUIError('INVALID_PATH', 'Path must be absolute', 400);
+        }
+        // Check for path traversal attempts before normalization
+        if (requestedPath.includes('..')) {
+            this.logger.warn('Path traversal attempt detected', {
+                requestedPath
+            });
+            throw new CUIError('PATH_TRAVERSAL_DETECTED', 'Invalid path: path traversal detected', 400);
+        }
+        // Normalize the path to resolve . segments and clean up
+        const normalizedPath = path.normalize(requestedPath);
+        // Check against allowed base paths if configured
+        if (this.allowedBasePaths.length > 0) {
+            const isAllowed = this.allowedBasePaths.some(basePath => normalizedPath.startsWith(basePath));
+            if (!isAllowed) {
+                this.logger.warn('Path outside allowed directories', {
+                    requestedPath,
+                    normalizedPath,
+                    allowedBasePaths: this.allowedBasePaths
+                });
+                throw new CUIError('PATH_NOT_ALLOWED', 'Path is outside allowed directories', 403);
+            }
+        }
+        // Additional security checks
+        const segments = normalizedPath.split(path.sep);
+        for (const segment of segments) {
+            if (!segment)
+                continue;
+            // Check for hidden files/directories
+            if (segment.startsWith('.')) {
+                this.logger.warn('Hidden file/directory detected', {
+                    requestedPath,
+                    segment
+                });
+                throw new CUIError('INVALID_PATH', 'Path contains hidden files/directories', 400);
+            }
+            // Check for null bytes
+            if (segment.includes('\u0000')) {
+                this.logger.warn('Null byte detected in path', {
+                    requestedPath,
+                    segment
+                });
+                throw new CUIError('INVALID_PATH', 'Path contains null bytes', 400);
+            }
+            // Check for invalid characters
+            if (/[<>:|?*]/.test(segment)) {
+                this.logger.warn('Invalid characters detected in path', {
+                    requestedPath,
+                    segment
+                });
+                throw new CUIError('INVALID_PATH', 'Path contains invalid characters', 400);
+            }
+        }
+        this.logger.debug('Path validated successfully', {
+            requestedPath,
+            normalizedPath
+        });
+        return normalizedPath;
+    }
+    /**
+     * Check if content appears to be valid UTF-8 text
+     */
+    isValidUtf8(content) {
+        // Check for null bytes - common binary file indicator
+        if (content.includes('\u0000')) {
+            return false;
+        }
+        // Check for control characters (excluding tab, newline, and carriage return)
+        for (let i = 0; i < content.length; i++) {
+            const charCode = content.charCodeAt(i);
+            // Allow tab (9), newline (10), and carriage return (13)
+            // Reject other control characters (1-8, 11-12, 14-31)
+            if ((charCode >= 1 && charCode <= 8) ||
+                (charCode >= 11 && charCode <= 12) ||
+                (charCode >= 14 && charCode <= 31)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * List directory contents without recursion
+     */
+    async listDirectoryFlat(dirPath, ig) {
+        const dirents = await fs.readdir(dirPath, { withFileTypes: true });
+        const entries = [];
+        for (const dirent of dirents) {
+            // Check gitignore BEFORE any expensive operations
+            if (ig && ig.ignores(dirent.name)) {
+                continue;
+            }
+            const fullPath = path.join(dirPath, dirent.name);
+            const stats = await fs.stat(fullPath);
+            entries.push({
+                name: dirent.name,
+                type: dirent.isDirectory() ? 'directory' : 'file',
+                size: dirent.isFile() ? stats.size : undefined,
+                lastModified: stats.mtime.toISOString()
+            });
+        }
+        return entries;
+    }
+    /**
+     * List directory contents recursively
+     */
+    async listDirectoryRecursive(dirPath, basePath, ig) {
+        const entries = [];
+        async function traverse(currentPath) {
+            const dirents = await fs.readdir(currentPath, { withFileTypes: true });
+            for (const dirent of dirents) {
+                const fullPath = path.join(currentPath, dirent.name);
+                const relativePath = path.relative(basePath, fullPath);
+                // Check gitignore BEFORE any expensive operations
+                if (ig && ig.ignores(relativePath)) {
+                    // Skip this entry entirely - don't stat, don't recurse into directories
+                    continue;
+                }
+                const stats = await fs.stat(fullPath);
+                entries.push({
+                    name: relativePath,
+                    type: dirent.isDirectory() ? 'directory' : 'file',
+                    size: dirent.isFile() ? stats.size : undefined,
+                    lastModified: stats.mtime.toISOString()
+                });
+                // Recurse into subdirectories (already checked it's not ignored)
+                if (dirent.isDirectory()) {
+                    await traverse(fullPath);
+                }
+            }
+        }
+        await traverse(dirPath);
+        return entries;
+    }
+    /**
+     * Load gitignore patterns from a directory and its parents
+     */
+    async loadGitignore(dirPath) {
+        const ig = ignore();
+        // Load .gitignore from the directory
+        try {
+            const gitignorePath = path.join(dirPath, '.gitignore');
+            const content = await fs.readFile(gitignorePath, 'utf-8');
+            ig.add(content);
+            this.logger.debug('Loaded .gitignore', { path: gitignorePath });
+        }
+        catch (error) {
+            // .gitignore doesn't exist or can't be read - that's fine
+            const errorCode = error.code;
+            if (errorCode !== 'ENOENT') {
+                this.logger.debug('Error reading .gitignore', { error, path: dirPath });
+            }
+        }
+        // Always ignore .git directory
+        ig.add('.git');
+        return ig;
+    }
+    /**
+     * Check if a directory is a git repository
+     */
+    async isGitRepository(dirPath) {
+        try {
+            await execAsync('git rev-parse --git-dir', { cwd: dirPath });
+            return true;
+        }
+        catch (error) {
+            this.logger.debug('Directory is not a git repository', { dirPath, error });
+            return false;
+        }
+    }
+    /**
+     * Get current git HEAD commit hash
+     */
+    async getCurrentGitHead(dirPath) {
+        try {
+            const { stdout } = await execAsync('git rev-parse HEAD', { cwd: dirPath });
+            return stdout.trim();
+        }
+        catch (error) {
+            this.logger.debug('Failed to get git HEAD', { dirPath, error });
+            return null;
+        }
+    }
+    /**
+     * Validate that an executable exists and has executable permissions
+     */
+    async validateExecutable(executablePath) {
+        this.logger.debug('Validating executable', { executablePath });
+        try {
+            // Check if file exists
+            if (!existsSync(executablePath)) {
+                throw new CUIError('EXECUTABLE_NOT_FOUND', `Executable not found: ${executablePath}`, 404);
+            }
+            // Check if file is executable
+            try {
+                await fs.access(executablePath, constants.X_OK);
+            }
+            catch (_error) {
+                throw new CUIError('NOT_EXECUTABLE', `File exists but is not executable: ${executablePath}`, 403);
+            }
+            this.logger.debug('Executable validation successful', { executablePath });
+        }
+        catch (error) {
+            if (error instanceof CUIError) {
+                throw error;
+            }
+            this.logger.error('Error validating executable', error, { executablePath });
+            throw new CUIError('EXECUTABLE_VALIDATION_FAILED', `Failed to validate executable: ${error}`, 500);
+        }
+    }
+}
+//# sourceMappingURL=file-system-service.js.map

package/dist/services/file-system-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-service.js","sourceRoot":"","sources":["../../src/services/file-system-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAS;IACf,WAAW,GAAW,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;IACvD,gBAAgB,GAAa,EAAE,CAAC,CAAC,gCAAgC;IAEzE,YAAY,WAAoB,EAAE,gBAA2B;QAC3D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAChD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QACjC,CAAC;QACD,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,aAAqB,EACrB,YAAqB,KAAK,EAC1B,mBAA4B,KAAK;QAEjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAE9F,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAExD,0CAA0C;YAC1C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,4BAA4B,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YAC1F,CAAC;YAED,oCAAoC;YACpC,IAAI,EAAE,GAAqC,IAAI,CAAC;YAChD,IAAI,gBAAgB,EAAE,CAAC;gBACrB,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;YAED,cAAc;YACd,MAAM,OAAO,GAAsB,SAAS;gBAC1C,CAAC,CAAC,MAAM,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;gBAC3D,CAAC,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAE/C,gDAAgD;YAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACpB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;oBACtB,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,CAAC;gBACD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE;gBACjD,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,SAAS;gBACT,gBAAgB;aACjB,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,SAAS,GAAI,KAA+B,CAAC,IAAI,CAAC;YACxD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YAChF,CAAC;iBAAM,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,0BAA0B,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YACtF,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;YACvE,MAAM,IAAI,QAAQ,CAAC,uBAAuB,EAAE,6BAA6B,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,aAAqB;QAClC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;YAExD,qCAAqC;YACrC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpB,MAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,uBAAuB,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YAChF,CAAC;YAED,kBAAkB;YAClB,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBAClC,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,cAAc,KAAK,CAAC,IAAI,yCAAyC,IAAI,CAAC,WAAW,SAAS,EAC1F,GAAG,CACJ,CAAC;YACJ,CAAC;YAED,oBAAoB;YACpB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,uCAAuC;YACvC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,8CAA8C,EAAE,GAAG,CAAC,CAAC;YACzF,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBAC1C,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO;gBACP,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;gBACvC,QAAQ,EAAE,OAAO;aAClB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,SAAS,GAAI,KAA+B,CAAC,IAAI,CAAC;YACxD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YAChF,CAAC;iBAAM,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,0BAA0B,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;YACtF,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;YAClE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,aAAqB;QAC9C,yBAAyB;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,uBAAuB,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC;QAED,yDAAyD;QACzD,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAClD,aAAa;aACd,CAAC,CAAC;YACH,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9F,CAAC;QAED,wDAAwD;QACxD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAErD,iDAAiD;QACjD,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACtD,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CACpC,CAAC;YAEF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;oBACnD,aAAa;oBACb,cAAc;oBACd,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;iBACxC,CAAC,CAAC;gBACH,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,EAAE,GAAG,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,qCAAqC;YACrC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;oBACjD,aAAa;oBACb,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,wCAAwC,EAAE,GAAG,CAAC,CAAC;YACpF,CAAC;YAED,uBAAuB;YACvB,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE;oBAC7C,aAAa;oBACb,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,0BAA0B,EAAE,GAAG,CAAC,CAAC;YACtE,CAAC;YAED,+BAA+B;YAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;oBACtD,aAAa;oBACb,OAAO;iBACR,CAAC,CAAC;gBACH,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,kCAAkC,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE;YAC/C,aAAa;YACb,cAAc;SACf,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,OAAe;QACjC,sDAAsD;QACtD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,6EAA6E;QAC7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACvC,wDAAwD;YACxD,sDAAsD;YACtD,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,CAAC;gBAChC,CAAC,QAAQ,IAAI,EAAE,IAAI,QAAQ,IAAI,EAAE,CAAC;gBAClC,CAAC,QAAQ,IAAI,EAAE,IAAI,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,OAAe,EACf,EAAoC;QAEpC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,kDAAkD;YAClD,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;gBACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC9C,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;aACxC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,sBAAsB,CAClC,OAAe,EACf,QAAgB,EAChB,EAAoC;QAEpC,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,UAAU,QAAQ,CAAC,WAAmB;YACzC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAEvD,kDAAkD;gBAClD,IAAI,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBACnC,wEAAwE;oBACxE,SAAS;gBACX,CAAC;gBAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;oBACjD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;oBAC9C,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;iBACxC,CAAC,CAAC;gBAEH,iEAAiE;gBACjE,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzB,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,OAAe;QACzC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAEpB,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC1D,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0DAA0D;YAC1D,MAAM,SAAS,GAAI,KAA+B,CAAC,IAAI,CAAC;YACxD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3E,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,cAAsB;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,uBAAuB;YACvB,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,QAAQ,CAChB,sBAAsB,EACtB,yBAAyB,cAAc,EAAE,EACzC,GAAG,CACJ,CAAC;YACJ,CAAC;YAED,8BAA8B;YAC9B,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,sCAAsC,cAAc,EAAE,EACtD,GAAG,CACJ,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;YAC5E,MAAM,IAAI,QAAQ,CAChB,8BAA8B,EAC9B,kCAAkC,KAAK,EAAE,EACzC,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/services/gemini-service.d.ts

@@ -0,0 +1,72 @@
+export interface GeminiHealthResponse {
+    status: 'healthy' | 'unhealthy';
+    message: string;
+    apiKeyValid: boolean;
+}
+export interface GeminiTranscribeRequest {
+    audio: string;
+    mimeType: string;
+}
+export interface GeminiTranscribeResponse {
+    text: string;
+}
+export interface GeminiSummarizeRequest {
+    text: string;
+}
+export interface GeminiSummarizeResponse {
+    title: string;
+    keypoints: string[];
+}
+export interface GeminiSessionNameResponse {
+    name: string;
+}
+export interface GeminiImageResponse {
+    imageData: string;
+    mimeType: string;
+}
+export declare class GeminiService {
+    private logger;
+    private genAI;
+    private model;
+    constructor();
+    initialize(): Promise<void>;
+    checkHealth(): Promise<GeminiHealthResponse>;
+    transcribe(audio: string, mimeType: string): Promise<GeminiTranscribeResponse>;
+    summarize(text: string): Promise<GeminiSummarizeResponse>;
+    generateSessionName(conversationText: string): Promise<GeminiSessionNameResponse>;
+    /**
+     * Generate structured session insights for display
+     */
+    generateSessionInsights(conversationText: string): Promise<{
+        purposes: string[];
+        milestones: Array<{
+            label: string;
+            status: 'done' | 'current' | 'pending';
+        }>;
+        recentActions: string[];
+    }>;
+    /**
+     * Map session theme to a neon glow color for visual differentiation.
+     * This creates instant visual grouping - all debugging sessions are amber,
+     * all implementing sessions are green, etc.
+     */
+    private getColorForTheme;
+    /**
+     * Create a black canvas PNG to use as base for image editing.
+     * Using inpainting on a black canvas ensures consistent black backgrounds.
+     */
+    private createBlackCanvas;
+    /**
+     * Generate an abstract visual identity image for a session.
+     * Uses image editing on a black canvas to ensure consistent black backgrounds,
+     * with color-mood mapping for instant visual differentiation between session types.
+     */
+    generateSessionImage(sessionContext: {
+        mission: string;
+        project?: string;
+        theme?: string;
+        workTypes?: string[];
+    }): Promise<GeminiImageResponse>;
+}
+export declare const geminiService: GeminiService;
+//# sourceMappingURL=gemini-service.d.ts.map

package/dist/services/gemini-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-service.d.ts","sourceRoot":"","sources":["../../src/services/gemini-service.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAS;;IAOhB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA4C5C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAwC9E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgEzD,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA2DvF;;OAEG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;SAAE,CAAC,CAAC;QAC7E,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IA+EF;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;OAGG;YACW,iBAAiB;IAY/B;;;;OAIG;IACG,oBAAoB,CAAC,cAAc,EAAE;QACzC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsFjC;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}