Add comprehensive logging for image processing

- Add detailed logs for image cache operations (save/load/clear)
- Add logs for image conversion process with file sizes
- Add logs for Cursor API payload with image metadata
- Add logs for task creation with image attachment details
- Add file size and TTL information in cache operations
- Better visibility into image processing pipeline

Author: Hormold

src/agent.ts

@@ -137,10 +137,21 @@ function createToolsWithContext(context: AgentContext): ToolSet {
 
           // Get images from cache
           const images = getImagesFromCache(context.userId, context.chatId);
+          console.log(`📸 Found ${images.length} images in cache for user ${context.userId} in chat ${context.chatId}`);
+          
+          if (images.length > 0) {
+            console.log(`📸 Images details:`, images.map(img => ({
+              uuid: img.uuid,
+              dimensions: `${img.dimension.width}x${img.dimension.height}`,
+              dataSize: `${Math.round(img.data.length / 1024)}KB`
+            })));
+          }
 
           // Create fresh CursorApi instance and start the task
           const cursorApi = new CursorApi({ cookies });
+          console.log(`🚀 Starting Cursor task with ${images.length} images attached`);
           const result = await cursorApi.startSimpleComposer(repoUrl, taskDescription, branch, model, images.length > 0 ? images : undefined);
+          console.log(`✅ Cursor task started successfully: ${result.composer.bcId}`);
 
           // Update context with validated instance
           context.cursorApi = cursorApi;
@@ -156,6 +167,7 @@ function createToolsWithContext(context: AgentContext): ToolSet {
           });
 
           // Clear images from cache after successful task creation
+          console.log(`🧹 Clearing ${images.length} images from cache after successful task creation`);
           clearImagesFromCache(context.userId, context.chatId);
 
           return {

src/bot.ts

@@ -339,11 +339,14 @@ bot.on('message:photo', async (ctx) => {
     const photoBuffer = Buffer.from(await response.arrayBuffer());
 
     // Convert to Cursor format
+    console.log(`📸 Converting Telegram photo ${photo.file_id} to Cursor format`);
     const cursorImage = await convertTelegramImageToCursorFormat(photoBuffer, photo.file_id);
+    console.log(`📸 Converted image: ${cursorImage.dimension.width}x${cursorImage.dimension.height}, ${Math.round(cursorImage.data.length / 1024)}KB`);
 
     // Get existing images from cache and add new one
     const existingImages = getImagesFromCache(ctx.from!.id, ctx.chat!.id);
     const allImages = [...existingImages, cursorImage];
+    console.log(`📸 Total images in cache: ${allImages.length} (${existingImages.length} existing + 1 new)`);
 
     // Save to cache
     saveImagesToCache(ctx.from!.id, ctx.chat!.id, allImages);

src/cursor-api.ts

@@ -196,6 +196,19 @@ export class CursorApi {
   async startBackgroundComposer(
     request: StartBackgroundComposerRequest
   ): Promise<StartBackgroundComposerResponse> {
+    // Log payload info (without actual image data to avoid spam)
+    const payloadInfo = {
+      bcId: request.bcId,
+      repoUrl: request.repoUrl,
+      conversationHistory: request.conversationHistory?.map(msg => ({
+        text: msg.text.substring(0, 100) + (msg.text.length > 100 ? '...' : ''),
+        type: msg.type,
+        hasImages: !!msg.images,
+        imageCount: msg.images?.length || 0
+      }))
+    };
+    console.log(`📤 Sending request to Cursor API:`, payloadInfo);
+    
     return this.request<StartBackgroundComposerResponse>(
       '/api/auth/startBackgroundComposerFromSnapshot',
       {
@@ -353,8 +366,15 @@ export class CursorApi {
     modelName: SupportedModel | string = SupportedModel.CLAUDE_4_SONNET_THINKING,
     images?: ConversationImage[]
   ): Promise<StartBackgroundComposerResponse> {
+    console.log(`🔧 Creating Cursor config with ${images?.length || 0} images`);
     const config = this.createBaseComposerConfig(repoUrl, task, branch, modelName, images);
 
+    // Log the conversation history to see if images are included
+    if (config.conversationHistory && config.conversationHistory.length > 0) {
+      const firstMessage = config.conversationHistory[0];
+      console.log(`📝 First message has ${firstMessage.images?.length || 0} images attached`);
+    }
+    
     return this.startBackgroundComposer(config as StartBackgroundComposerRequest);
   }
 

src/image-cache.ts

@@ -61,8 +61,11 @@ export function saveImagesToCache(userId: number, chatId: number, images: Conver
       timestamp: Date.now()
     };
 
+    const jsonSize = JSON.stringify(cacheData).length;
+    console.log(`📸 Saving ${images.length} images to cache file ${filePath} (${Math.round(jsonSize / 1024)}KB)`);
+    
     fs.writeFileSync(filePath, JSON.stringify(cacheData, null, 2));
-    console.log(`Saved ${images.length} images to cache for user ${userId} in chat ${chatId}`);
+    console.log(`📸 Successfully saved ${images.length} images to cache for user ${userId} in chat ${chatId}`);
   } catch (error) {
     console.error('Error saving images to cache:', error);
   }
@@ -75,20 +78,28 @@ export function getImagesFromCache(userId: number, chatId: number): Conversation
 
   try {
     if (!fs.existsSync(filePath)) {
+      console.log(`📸 No cache file found for user ${userId} in chat ${chatId}`);
       return [];
     }
 
     const stats = fs.statSync(filePath);
     const now = Date.now();
+    const age = now - stats.mtime.getTime();
+    
+    console.log(`📸 Cache file age: ${Math.round(age / 1000)}s (TTL: ${CACHE_TTL / 1000}s)`);
 
     // Check if expired
-    if (now - stats.mtime.getTime() > CACHE_TTL) {
+    if (age > CACHE_TTL) {
+      console.log(`📸 Cache expired, removing file`);
       fs.unlinkSync(filePath);
       return [];
     }
 
     const cacheData = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-    return cacheData.images || [];
+    const images = cacheData.images || [];
+    console.log(`📸 Successfully loaded ${images.length} images from cache`);
+    
+    return images;
   } catch (error) {
     console.error('Error reading images from cache:', error);
     return [];
@@ -102,8 +113,14 @@ export function clearImagesFromCache(userId: number, chatId: number) {
 
   try {
     if (fs.existsSync(filePath)) {
+      const stats = fs.statSync(filePath);
+      const fileSize = Math.round(stats.size / 1024);
+      console.log(`📸 Clearing cache file ${filePath} (${fileSize}KB)`);
+      
       fs.unlinkSync(filePath);
-      console.log(`Cleared image cache for user ${userId} in chat ${chatId}`);
+      console.log(`📸 Successfully cleared image cache for user ${userId} in chat ${chatId}`);
+    } else {
+      console.log(`📸 No cache file to clear for user ${userId} in chat ${chatId}`);
     }
   } catch (error) {
     console.error('Error clearing images from cache:', error);

src/utils.ts

@@ -123,19 +123,24 @@ export async function convertTelegramImageToCursorFormat(
   fileBuffer: Buffer,
   telegramFileId: string
 ): Promise<ConversationImage> {
+  console.log(`📸 Converting ${fileBuffer.length} bytes image to PNG format`);
+  
   // Convert image to PNG and get dimensions
   const pngBuffer = await sharp(fileBuffer)
     .png()
     .toBuffer();
 
   const metadata = await sharp(pngBuffer).metadata();
+  console.log(`📸 PNG conversion complete: ${metadata.width}x${metadata.height}, ${pngBuffer.length} bytes`);
+  
+  const uuid = `tg-${telegramFileId}-${Date.now()}`;
 
   return {
     data: pngBuffer.toString('base64'),
     dimension: {
       width: metadata.width || 0,
       height: metadata.height || 0,
     },
-    uuid: `tg-${telegramFileId}-${Date.now()}`,
+    uuid,
   };
 }