crewly 1.2.3 → 1.2.4

package/dist/backend/backend/src/services/cloud/cloud-file.service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Cloud File Service
+ *
+ * Handles file uploads for cloud AI employee tasks.
+ * MVP implementation: local file storage under ~/.crewly/cloud/uploads/.
+ * Future: migrate to DigitalOcean Spaces (S3-compatible).
+ *
+ * Files are organized by userId to enforce tenant isolation.
+ *
+ * @module services/cloud/cloud-file.service
+ */
+/** Cloud file service configuration. */
+export declare const CLOUD_FILE_CONSTANTS: {
+    /** Upload directory under ~/.crewly/ */
+    readonly UPLOAD_DIR: "cloud/uploads";
+    /** Maximum file size in bytes (20 MB) */
+    readonly MAX_FILE_SIZE: number;
+    /** Allowed MIME types for upload */
+    readonly ALLOWED_MIME_TYPES: readonly string[];
+    /** Allowed file extensions */
+    readonly ALLOWED_EXTENSIONS: readonly string[];
+};
+/** Result of a file upload operation. */
+export interface FileUploadResult {
+    /** Whether the upload succeeded */
+    success: boolean;
+    /** File key (path relative to upload root) — use this to reference the file */
+    fileKey?: string;
+    /** Original filename */
+    originalName?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Error message on failure */
+    error?: string;
+}
+/** Metadata about an uploaded file. */
+export interface UploadedFileInfo {
+    /** File key (path relative to upload root) */
+    fileKey: string;
+    /** Absolute filesystem path */
+    absolutePath: string;
+    /** Original filename */
+    originalName: string;
+    /** File size in bytes */
+    size: number;
+    /** Upload timestamp */
+    uploadedAt: string;
+}
+/**
+ * Manages file uploads and retrieval for cloud tasks.
+ *
+ * Singleton — access via `CloudFileService.getInstance()`.
+ */
+export declare class CloudFileService {
+    private static instance;
+    private readonly logger;
+    private readonly uploadRoot;
+    private constructor();
+    /** Get singleton instance. */
+    static getInstance(): CloudFileService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /**
+     * Save an uploaded file to the user's upload directory.
+     *
+     * @param userId - Authenticated user ID (tenant isolation)
+     * @param originalName - Original filename from the client
+     * @param buffer - File content as a Buffer
+     * @param mimeType - MIME type of the file
+     * @returns Upload result with file key
+     */
+    saveFile(userId: string, originalName: string, buffer: Buffer, mimeType: string): Promise<FileUploadResult>;
+    /**
+     * Read a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File buffer or null if not found
+     */
+    readFile(fileKey: string): Promise<Buffer | null>;
+    /**
+     * Get metadata about an uploaded file.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File info or null if not found
+     */
+    getFileInfo(fileKey: string): Promise<UploadedFileInfo | null>;
+    /**
+     * Delete a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns True if deleted, false if not found
+     */
+    deleteFile(fileKey: string): Promise<boolean>;
+    /** Get the absolute path for a file key. */
+    getAbsolutePath(fileKey: string): string;
+}
+//# sourceMappingURL=cloud-file.service.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-file.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-file.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-file.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;IAChC,wCAAwC;;IAExC,yCAAyC;;IAEzC,oCAAoC;iCAU/B,SAAS,MAAM,EAAE;IACtB,8BAA8B;iCAIzB,SAAS,MAAM,EAAE;CACb,CAAC;AAMX,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAChC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;CACnB;AAMD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO;IAKP,8BAA8B;IAC9B,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,qCAAqC;IACrC,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;;;OAQG;IACG,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;IAqD5B;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgBpE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWnD,4CAA4C;IAC5C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGxC"}

package/dist/backend/backend/src/services/cloud/cloud-file.service.js

@@ -0,0 +1,184 @@
+/**
+ * Cloud File Service
+ *
+ * Handles file uploads for cloud AI employee tasks.
+ * MVP implementation: local file storage under ~/.crewly/cloud/uploads/.
+ * Future: migrate to DigitalOcean Spaces (S3-compatible).
+ *
+ * Files are organized by userId to enforce tenant isolation.
+ *
+ * @module services/cloud/cloud-file.service
+ */
+import { randomUUID } from 'node:crypto';
+import { readFile, writeFile, mkdir, stat, unlink } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { homedir } from 'node:os';
+import { LoggerService } from '../core/logger.service.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Cloud file service configuration. */
+export const CLOUD_FILE_CONSTANTS = {
+    /** Upload directory under ~/.crewly/ */
+    UPLOAD_DIR: 'cloud/uploads',
+    /** Maximum file size in bytes (20 MB) */
+    MAX_FILE_SIZE: 20 * 1024 * 1024,
+    /** Allowed MIME types for upload */
+    ALLOWED_MIME_TYPES: [
+        'image/png',
+        'image/jpeg',
+        'image/gif',
+        'image/webp',
+        'application/pdf',
+        'text/plain',
+        'text/csv',
+        'application/json',
+    ],
+    /** Allowed file extensions */
+    ALLOWED_EXTENSIONS: [
+        '.png', '.jpg', '.jpeg', '.gif', '.webp',
+        '.pdf', '.txt', '.csv', '.json',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Manages file uploads and retrieval for cloud tasks.
+ *
+ * Singleton — access via `CloudFileService.getInstance()`.
+ */
+export class CloudFileService {
+    static instance = null;
+    logger;
+    uploadRoot;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudFileService');
+        this.uploadRoot = join(homedir(), '.crewly', CLOUD_FILE_CONSTANTS.UPLOAD_DIR);
+    }
+    /** Get singleton instance. */
+    static getInstance() {
+        if (!CloudFileService.instance) {
+            CloudFileService.instance = new CloudFileService();
+        }
+        return CloudFileService.instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        CloudFileService.instance = null;
+    }
+    /**
+     * Save an uploaded file to the user's upload directory.
+     *
+     * @param userId - Authenticated user ID (tenant isolation)
+     * @param originalName - Original filename from the client
+     * @param buffer - File content as a Buffer
+     * @param mimeType - MIME type of the file
+     * @returns Upload result with file key
+     */
+    async saveFile(userId, originalName, buffer, mimeType) {
+        // Validate file size
+        if (buffer.length > CLOUD_FILE_CONSTANTS.MAX_FILE_SIZE) {
+            return {
+                success: false,
+                error: `File too large: ${buffer.length} bytes. Maximum is ${CLOUD_FILE_CONSTANTS.MAX_FILE_SIZE} bytes (20 MB).`,
+            };
+        }
+        // Validate MIME type
+        if (!CLOUD_FILE_CONSTANTS.ALLOWED_MIME_TYPES.includes(mimeType)) {
+            return {
+                success: false,
+                error: `Unsupported file type: ${mimeType}. Allowed: ${CLOUD_FILE_CONSTANTS.ALLOWED_MIME_TYPES.join(', ')}`,
+            };
+        }
+        // Validate extension
+        const ext = extname(originalName).toLowerCase();
+        if (!CLOUD_FILE_CONSTANTS.ALLOWED_EXTENSIONS.includes(ext)) {
+            return {
+                success: false,
+                error: `Unsupported file extension: ${ext}. Allowed: ${CLOUD_FILE_CONSTANTS.ALLOWED_EXTENSIONS.join(', ')}`,
+            };
+        }
+        try {
+            // Create user-scoped upload directory
+            const userDir = join(this.uploadRoot, userId);
+            await mkdir(userDir, { recursive: true });
+            // Generate unique filename to prevent collisions
+            const uniqueName = `${randomUUID()}${ext}`;
+            const filePath = join(userDir, uniqueName);
+            const fileKey = `${userId}/${uniqueName}`;
+            await writeFile(filePath, buffer);
+            this.logger.info('File saved', { fileKey, originalName, size: buffer.length, mimeType });
+            return {
+                success: true,
+                fileKey,
+                originalName,
+                size: buffer.length,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.error('Failed to save file', { error: msg, userId, originalName });
+            return { success: false, error: `Failed to save file: ${msg}` };
+        }
+    }
+    /**
+     * Read a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File buffer or null if not found
+     */
+    async readFile(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            return await readFile(filePath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get metadata about an uploaded file.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File info or null if not found
+     */
+    async getFileInfo(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            const stats = await stat(filePath);
+            return {
+                fileKey,
+                absolutePath: filePath,
+                originalName: fileKey.split('/').pop() ?? fileKey,
+                size: stats.size,
+                uploadedAt: stats.birthtime.toISOString(),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Delete a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns True if deleted, false if not found
+     */
+    async deleteFile(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            await unlink(filePath);
+            this.logger.info('File deleted', { fileKey });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Get the absolute path for a file key. */
+    getAbsolutePath(fileKey) {
+        return join(this.uploadRoot, fileKey);
+    }
+}
+//# sourceMappingURL=cloud-file.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-file.service.js.map

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

package/dist/backend/backend/src/services/cloud/cloud-image-analysis.service.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Cloud Image Analysis Service
+ *
+ * Processes images (especially WeChat screenshots) using multimodal AI.
+ * Extracts structured information: participants, timestamps, key messages,
+ * action items, and summaries.
+ *
+ * MVP: Uses a prompt template approach — the AI runtime receives the image
+ * along with a structured prompt and returns a parsed result.
+ *
+ * @module services/cloud/cloud-image-analysis.service
+ */
+/** Image analysis service configuration. */
+export declare const IMAGE_ANALYSIS_CONSTANTS: {
+    /** Maximum image file size for analysis (10 MB) */
+    readonly MAX_IMAGE_SIZE: number;
+    /** Supported image MIME types for analysis */
+    readonly SUPPORTED_MIMES: readonly string[];
+};
+/** Structured result from WeChat screenshot analysis. */
+export interface WeChatAnalysisResult {
+    /** Identified chat participants */
+    participants: string[];
+    /** Extracted messages with attribution */
+    messages: WeChatMessage[];
+    /** High-level summary of the conversation */
+    summary: string;
+    /** Action items / to-dos extracted from the conversation */
+    actionItems: string[];
+    /** Key information or decisions identified */
+    keyPoints: string[];
+}
+/** A single message extracted from a WeChat screenshot. */
+export interface WeChatMessage {
+    /** Message sender name */
+    sender: string;
+    /** Message content */
+    content: string;
+    /** Approximate timestamp if visible */
+    timestamp: string | null;
+}
+/** Result of an image analysis operation. */
+export interface ImageAnalysisResult {
+    /** Whether the analysis succeeded */
+    success: boolean;
+    /** Analysis type performed */
+    analysisType?: string;
+    /** Structured analysis result */
+    data?: WeChatAnalysisResult;
+    /** Raw text output (fallback when structured parsing fails) */
+    rawOutput?: string;
+    /** Error message on failure */
+    error?: string;
+}
+/**
+ * Prompt template for WeChat screenshot analysis.
+ * Instructs the AI to extract structured information from a chat screenshot.
+ */
+export declare const WECHAT_ANALYSIS_PROMPT = "You are analyzing a WeChat (\u5FAE\u4FE1) chat screenshot. Extract the following information in a structured JSON format:\n\n{\n  \"participants\": [\"list of people in the chat\"],\n  \"messages\": [\n    {\n      \"sender\": \"person name\",\n      \"content\": \"message text\",\n      \"timestamp\": \"time if visible, or null\"\n    }\n  ],\n  \"summary\": \"Brief summary of the conversation (2-3 sentences)\",\n  \"actionItems\": [\"List of action items or to-dos mentioned\"],\n  \"keyPoints\": [\"Key information, decisions, or important details\"]\n}\n\nRules:\n- If the screenshot is in Chinese, keep the original Chinese text in messages but provide the summary in the same language as the user's prompt.\n- If a participant name is not visible, use a descriptive label like \"Person A\", \"Person B\".\n- If no action items are found, return an empty array.\n- If timestamps are not visible, set them to null.\n- Focus on accuracy \u2014 only include information clearly visible in the image.\n\nReturn ONLY the JSON object, no markdown formatting or extra text.";
+/**
+ * Generic image analysis prompt for non-WeChat images.
+ */
+export declare const GENERIC_IMAGE_ANALYSIS_PROMPT = "Analyze this image and provide a detailed description. Include:\n1. What the image shows\n2. Any text visible in the image\n3. Key details or notable elements\n4. If it's a document or form, extract the structured data\n\nProvide your analysis as clear, organized text.";
+/**
+ * Processes images using multimodal AI for structured analysis.
+ *
+ * Singleton — access via `CloudImageAnalysisService.getInstance()`.
+ */
+export declare class CloudImageAnalysisService {
+    private static instance;
+    private readonly logger;
+    private constructor();
+    /** Get singleton instance. */
+    static getInstance(): CloudImageAnalysisService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /**
+     * Build the analysis prompt for a given image and optional user instruction.
+     *
+     * @param userPrompt - User's original task prompt / instruction
+     * @param isWeChatScreenshot - Whether to use WeChat-specific analysis
+     * @returns The complete prompt to send to the AI runtime
+     */
+    buildAnalysisPrompt(userPrompt: string, isWeChatScreenshot?: boolean): string;
+    /**
+     * Detect whether a user prompt likely refers to a WeChat screenshot.
+     *
+     * @param prompt - User's task prompt
+     * @returns True if the prompt suggests WeChat content
+     */
+    isLikelyWeChatScreenshot(prompt: string): boolean;
+    /**
+     * Parse a WeChat analysis result from AI output text.
+     *
+     * Attempts to extract structured JSON from the AI response.
+     * Falls back to raw text if JSON parsing fails.
+     *
+     * @param aiOutput - Raw text output from the AI runtime
+     * @returns Parsed analysis result
+     */
+    parseAnalysisResult(aiOutput: string): ImageAnalysisResult;
+    /**
+     * Validate that a file is suitable for image analysis.
+     *
+     * @param mimeType - File MIME type
+     * @param size - File size in bytes
+     * @returns Validation result with error message if invalid
+     */
+    validateImage(mimeType: string, size: number): {
+        valid: boolean;
+        error?: string;
+    };
+}
+//# sourceMappingURL=cloud-image-analysis.service.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-image-analysis.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-image-analysis.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-image-analysis.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB;IACpC,mDAAmD;;IAEnD,8CAA8C;8BAC6B,SAAS,MAAM,EAAE;CACnF,CAAC;AAMX,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACpC,mCAAmC;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IACnC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,wjCAuBgC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,6BAA6B,kRAMM,CAAC;AAMjD;;;;GAIG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IAEjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP,8BAA8B;IAC9B,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C,qCAAqC;IACrC,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,GAAE,OAAe,GAAG,MAAM;IAYpF;;;;;OAKG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAajD;;;;;;;;OAQG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IA4C1D;;;;;;OAMG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAiBjF"}

package/dist/backend/backend/src/services/cloud/cloud-image-analysis.service.js

@@ -0,0 +1,196 @@
+/**
+ * Cloud Image Analysis Service
+ *
+ * Processes images (especially WeChat screenshots) using multimodal AI.
+ * Extracts structured information: participants, timestamps, key messages,
+ * action items, and summaries.
+ *
+ * MVP: Uses a prompt template approach — the AI runtime receives the image
+ * along with a structured prompt and returns a parsed result.
+ *
+ * @module services/cloud/cloud-image-analysis.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Image analysis service configuration. */
+export const IMAGE_ANALYSIS_CONSTANTS = {
+    /** Maximum image file size for analysis (10 MB) */
+    MAX_IMAGE_SIZE: 10 * 1024 * 1024,
+    /** Supported image MIME types for analysis */
+    SUPPORTED_MIMES: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
+};
+// ---------------------------------------------------------------------------
+// Prompt Templates
+// ---------------------------------------------------------------------------
+/**
+ * Prompt template for WeChat screenshot analysis.
+ * Instructs the AI to extract structured information from a chat screenshot.
+ */
+export const WECHAT_ANALYSIS_PROMPT = `You are analyzing a WeChat (微信) chat screenshot. Extract the following information in a structured JSON format:
+
+{
+  "participants": ["list of people in the chat"],
+  "messages": [
+    {
+      "sender": "person name",
+      "content": "message text",
+      "timestamp": "time if visible, or null"
+    }
+  ],
+  "summary": "Brief summary of the conversation (2-3 sentences)",
+  "actionItems": ["List of action items or to-dos mentioned"],
+  "keyPoints": ["Key information, decisions, or important details"]
+}
+
+Rules:
+- If the screenshot is in Chinese, keep the original Chinese text in messages but provide the summary in the same language as the user's prompt.
+- If a participant name is not visible, use a descriptive label like "Person A", "Person B".
+- If no action items are found, return an empty array.
+- If timestamps are not visible, set them to null.
+- Focus on accuracy — only include information clearly visible in the image.
+
+Return ONLY the JSON object, no markdown formatting or extra text.`;
+/**
+ * Generic image analysis prompt for non-WeChat images.
+ */
+export const GENERIC_IMAGE_ANALYSIS_PROMPT = `Analyze this image and provide a detailed description. Include:
+1. What the image shows
+2. Any text visible in the image
+3. Key details or notable elements
+4. If it's a document or form, extract the structured data
+
+Provide your analysis as clear, organized text.`;
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Processes images using multimodal AI for structured analysis.
+ *
+ * Singleton — access via `CloudImageAnalysisService.getInstance()`.
+ */
+export class CloudImageAnalysisService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudImageAnalysisService');
+    }
+    /** Get singleton instance. */
+    static getInstance() {
+        if (!CloudImageAnalysisService.instance) {
+            CloudImageAnalysisService.instance = new CloudImageAnalysisService();
+        }
+        return CloudImageAnalysisService.instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        CloudImageAnalysisService.instance = null;
+    }
+    /**
+     * Build the analysis prompt for a given image and optional user instruction.
+     *
+     * @param userPrompt - User's original task prompt / instruction
+     * @param isWeChatScreenshot - Whether to use WeChat-specific analysis
+     * @returns The complete prompt to send to the AI runtime
+     */
+    buildAnalysisPrompt(userPrompt, isWeChatScreenshot = false) {
+        const systemPrompt = isWeChatScreenshot
+            ? WECHAT_ANALYSIS_PROMPT
+            : GENERIC_IMAGE_ANALYSIS_PROMPT;
+        if (userPrompt.trim()) {
+            return `${systemPrompt}\n\nUser's additional instruction: ${userPrompt}`;
+        }
+        return systemPrompt;
+    }
+    /**
+     * Detect whether a user prompt likely refers to a WeChat screenshot.
+     *
+     * @param prompt - User's task prompt
+     * @returns True if the prompt suggests WeChat content
+     */
+    isLikelyWeChatScreenshot(prompt) {
+        const wechatPatterns = [
+            '微信', 'wechat', 'weixin',
+            '聊天记录', 'chat history', 'chat record',
+            '群聊', 'group chat',
+            '截图', 'screenshot',
+            '对话', 'conversation',
+        ];
+        const lowerPrompt = prompt.toLowerCase();
+        return wechatPatterns.some((pattern) => lowerPrompt.includes(pattern));
+    }
+    /**
+     * Parse a WeChat analysis result from AI output text.
+     *
+     * Attempts to extract structured JSON from the AI response.
+     * Falls back to raw text if JSON parsing fails.
+     *
+     * @param aiOutput - Raw text output from the AI runtime
+     * @returns Parsed analysis result
+     */
+    parseAnalysisResult(aiOutput) {
+        try {
+            // Try to extract JSON from the AI response
+            const jsonMatch = aiOutput.match(/\{[\s\S]*\}/);
+            if (!jsonMatch) {
+                return {
+                    success: true,
+                    analysisType: 'generic',
+                    rawOutput: aiOutput,
+                };
+            }
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Validate required fields
+            if (!parsed.participants || !parsed.messages || !parsed.summary) {
+                return {
+                    success: true,
+                    analysisType: 'generic',
+                    rawOutput: aiOutput,
+                };
+            }
+            return {
+                success: true,
+                analysisType: 'wechat',
+                data: {
+                    participants: Array.isArray(parsed.participants) ? parsed.participants : [],
+                    messages: Array.isArray(parsed.messages) ? parsed.messages : [],
+                    summary: String(parsed.summary),
+                    actionItems: Array.isArray(parsed.actionItems) ? parsed.actionItems : [],
+                    keyPoints: Array.isArray(parsed.keyPoints) ? parsed.keyPoints : [],
+                },
+            };
+        }
+        catch {
+            // JSON parsing failed — return raw output
+            return {
+                success: true,
+                analysisType: 'generic',
+                rawOutput: aiOutput,
+            };
+        }
+    }
+    /**
+     * Validate that a file is suitable for image analysis.
+     *
+     * @param mimeType - File MIME type
+     * @param size - File size in bytes
+     * @returns Validation result with error message if invalid
+     */
+    validateImage(mimeType, size) {
+        if (!IMAGE_ANALYSIS_CONSTANTS.SUPPORTED_MIMES.includes(mimeType)) {
+            return {
+                valid: false,
+                error: `Unsupported image type: ${mimeType}. Supported: ${IMAGE_ANALYSIS_CONSTANTS.SUPPORTED_MIMES.join(', ')}`,
+            };
+        }
+        if (size > IMAGE_ANALYSIS_CONSTANTS.MAX_IMAGE_SIZE) {
+            return {
+                valid: false,
+                error: `Image too large: ${size} bytes. Maximum: ${IMAGE_ANALYSIS_CONSTANTS.MAX_IMAGE_SIZE} bytes (10 MB)`,
+            };
+        }
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=cloud-image-analysis.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-image-analysis.service.js.map

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