@luckydraw/cumulus 0.5.1

package/dist/lib/history.js

@@ -0,0 +1,205 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { nanoid } from 'nanoid';
+/**
+ * HistoryStore manages conversation history persistence in JSONL format.
+ *
+ * Each conversation thread is stored as a separate JSONL file where each line
+ * is a JSON-serialized Message object. This format is append-only, crash-safe,
+ * and efficient for streaming reads.
+ */
+export class HistoryStore {
+    threadPath;
+    /**
+     * Create a new HistoryStore instance.
+     * @param threadPath - Absolute path to the JSONL file for this thread
+     */
+    constructor(threadPath) {
+        this.threadPath = threadPath;
+    }
+    /**
+     * Estimate token count from content using whitespace-based approximation.
+     * Multiplies word count by 1.3 to account for subword tokenization.
+     */
+    estimateTokens(content) {
+        const words = content.split(/\s+/).filter(w => w.length > 0);
+        return Math.ceil(words.length * 1.3);
+    }
+    /**
+     * Append a new message to the history.
+     * Automatically generates id (nanoid) and timestamp.
+     * Creates parent directories if they don't exist.
+     * @param msg - Message without id and timestamp
+     * @returns The complete message with generated fields
+     */
+    async append(msg) {
+        // Ensure parent directory exists
+        const dir = path.dirname(this.threadPath);
+        await fs.mkdir(dir, { recursive: true });
+        // Build complete message
+        const message = {
+            id: nanoid(),
+            timestamp: Date.now(),
+            role: msg.role,
+            content: msg.content,
+            tokenCount: msg.tokenCount ?? this.estimateTokens(msg.content),
+            ...(msg.metadata && { metadata: msg.metadata }),
+        };
+        // Persist attachments: copy from ephemeral source to thread's attachments/ dir
+        if (msg.attachments?.length) {
+            const attachDir = path.join(dir, 'attachments');
+            await fs.mkdir(attachDir, { recursive: true });
+            const persisted = [];
+            for (const att of msg.attachments) {
+                const destName = `${message.id}-${att.name}`;
+                const destPath = path.join(attachDir, destName);
+                try {
+                    await fs.copyFile(att.storedPath, destPath);
+                    persisted.push({
+                        name: att.name,
+                        type: att.type,
+                        mimeType: att.mimeType,
+                        storedPath: path.join('attachments', destName),
+                    });
+                }
+                catch {
+                    // Source file missing (e.g., $TMPDIR already cleaned) — skip this attachment
+                }
+            }
+            if (persisted.length > 0) {
+                message.attachments = persisted;
+            }
+        }
+        // Append to file with newline
+        const line = JSON.stringify(message) + '\n';
+        await fs.appendFile(this.threadPath, line, 'utf-8');
+        return message;
+    }
+    /**
+     * Resolve relative attachment storedPaths to absolute paths.
+     * Called before returning messages to clients so they can use paths directly.
+     */
+    resolveAttachmentPaths(messages) {
+        const dir = path.dirname(this.threadPath);
+        return messages.map(msg => {
+            if (!msg.attachments?.length)
+                return msg;
+            return {
+                ...msg,
+                attachments: msg.attachments.map(att => ({
+                    ...att,
+                    storedPath: path.join(dir, att.storedPath),
+                })),
+            };
+        });
+    }
+    /**
+     * Load all messages from the history file.
+     * Returns empty array if file doesn't exist.
+     * @returns Array of all messages in chronological order
+     */
+    async getAll() {
+        try {
+            const content = await fs.readFile(this.threadPath, 'utf-8');
+            if (!content.trim()) {
+                return [];
+            }
+            const messages = content
+                .trim()
+                .split('\n')
+                .filter(line => line.trim())
+                .map(line => JSON.parse(line));
+            return this.resolveAttachmentPaths(messages);
+        }
+        catch (error) {
+            // File doesn't exist - return empty array
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get messages by index range (0-based, inclusive start, exclusive end).
+     * Follows JavaScript slice() semantics.
+     * @param startIdx - Starting index (inclusive)
+     * @param endIdx - Ending index (exclusive)
+     * @returns Array of messages in the range
+     */
+    async getRange(startIdx, endIdx) {
+        const all = await this.getAll();
+        return all.slice(startIdx, endIdx);
+    }
+    /**
+     * Get the N most recent messages.
+     * @param n - Number of messages to retrieve
+     * @returns Array of recent messages, oldest first
+     */
+    async getRecent(n) {
+        if (n <= 0) {
+            return [];
+        }
+        const all = await this.getAll();
+        // Return last n messages, maintaining chronological order
+        return all.slice(-n);
+    }
+    /**
+     * Get statistics about the conversation history.
+     * @returns Stats object with counts and timestamps
+     */
+    async getStats() {
+        const messages = await this.getAll();
+        if (messages.length === 0) {
+            return {
+                count: 0,
+                totalTokens: 0,
+            };
+        }
+        const totalTokens = messages.reduce((sum, msg) => sum + (msg.tokenCount ?? 0), 0);
+        return {
+            count: messages.length,
+            totalTokens,
+            oldestTimestamp: messages[0]?.timestamp,
+            newestTimestamp: messages[messages.length - 1]?.timestamp,
+        };
+    }
+    /**
+     * Search messages by content (case-insensitive substring match).
+     * @param query - Search string
+     * @param limit - Maximum results to return (default: 10)
+     * @returns Matching messages, most recent first
+     */
+    async search(query, limit = 10) {
+        const messages = await this.getAll();
+        const lowerQuery = query.toLowerCase();
+        // Filter matches and reverse for most-recent-first
+        const matches = messages
+            .filter(msg => msg.content.toLowerCase().includes(lowerQuery))
+            .reverse()
+            .slice(0, limit);
+        return matches;
+    }
+    /**
+     * Truncate history to keep only messages up to and including the target message.
+     * Uses atomic write (write to .tmp then rename) to prevent data loss.
+     * @param messageId - ID of the last message to keep
+     * @returns Array of removed message IDs
+     * @throws If messageId is not found
+     */
+    async truncateTo(messageId) {
+        const messages = await this.getAll();
+        const targetIndex = messages.findIndex(m => m.id === messageId);
+        if (targetIndex === -1) {
+            throw new Error(`Message not found: ${messageId}`);
+        }
+        const kept = messages.slice(0, targetIndex + 1);
+        const removed = messages.slice(targetIndex + 1);
+        // Atomic write: write to temp file, then rename over original
+        const tmpPath = this.threadPath + '.tmp';
+        const content = kept.map(m => JSON.stringify(m)).join('\n') + '\n';
+        await fs.writeFile(tmpPath, content, 'utf-8');
+        await fs.rename(tmpPath, this.threadPath);
+        return removed.map(m => m.id);
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/lib/history.js.map

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

package/dist/lib/image-utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Image detection, validation, caching, and clipboard reading utilities.
+ */
+export interface DetectedImage {
+    /** As written in message, or "clipboard" */
+    originalPath: string;
+    /** Absolute path to source file */
+    resolvedPath: string;
+    /** Path in content store images directory */
+    cachedPath: string;
+    /** MIME type (image/png, image/jpeg, etc.) */
+    mediaType: string;
+    /** Base64-encoded file contents */
+    base64Data: string;
+    /** File size in bytes */
+    sizeBytes: number;
+}
+export interface ImageProcessingResult {
+    /** Successfully processed images */
+    images: DetectedImage[];
+    /** User text with image paths replaced by [IMAGE: filename] */
+    cleanedText: string;
+    /** Errors encountered during processing */
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Process all image references in a message text.
+ * Detects file paths, validates, caches, and encodes images.
+ * Returns processed images and cleaned text with paths replaced by [IMAGE: filename].
+ */
+export declare function processImagesInMessage(text: string, contentBasePath: string): Promise<ImageProcessingResult>;
+/**
+ * Read image data from the system clipboard.
+ * Platform-specific: macOS (osascript), Linux X11 (xclip), Linux Wayland (wl-paste).
+ * Returns null if clipboard has no image data.
+ */
+export declare function readClipboardImage(contentBasePath: string): Promise<DetectedImage | null>;
+//# sourceMappingURL=image-utils.d.ts.map

package/dist/lib/image-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-utils.d.ts","sourceRoot":"","sources":["../../src/lib/image-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AA2JD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAyB/F"}

package/dist/lib/image-utils.js

@@ -0,0 +1,288 @@
+/**
+ * Image detection, validation, caching, and clipboard reading utilities.
+ */
+import { execFile } from 'child_process';
+import * as crypto from 'crypto';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { promisify } from 'util';
+import { nanoid } from 'nanoid';
+const execFileAsync = promisify(execFile);
+/** Supported image formats with their MIME types and magic bytes */
+const IMAGE_FORMATS = {
+    '.png': {
+        mediaType: 'image/png',
+        magic: [Buffer.from([0x89, 0x50, 0x4e, 0x47])],
+    },
+    '.jpg': {
+        mediaType: 'image/jpeg',
+        magic: [Buffer.from([0xff, 0xd8, 0xff])],
+    },
+    '.jpeg': {
+        mediaType: 'image/jpeg',
+        magic: [Buffer.from([0xff, 0xd8, 0xff])],
+    },
+    '.gif': {
+        mediaType: 'image/gif',
+        magic: [Buffer.from('GIF87a'), Buffer.from('GIF89a')],
+    },
+    '.webp': {
+        mediaType: 'image/webp',
+        magic: [Buffer.from('RIFF')],
+    },
+};
+/** Maximum image file size: 5MB */
+const MAX_IMAGE_SIZE = 5 * 1024 * 1024;
+/**
+ * Regex patterns for detecting image file paths in text.
+ * Matches:
+ * - Quoted paths: "~/my photos/cat.png"
+ * - Unquoted paths starting with /, ~/, ./, ../
+ */
+const IMAGE_PATH_PATTERNS = [
+    // Quoted paths with spaces: "path/to/image.ext"
+    /"([^"]+\.(?:png|jpg|jpeg|gif|webp))"/gi,
+    // Unquoted absolute or relative paths (no spaces allowed)
+    /(?:^|\s)((?:\/|~\/|\.\/|\.\.\/)[^\s]+\.(?:png|jpg|jpeg|gif|webp))\b/gi,
+];
+/**
+ * Detect image file paths in a text message.
+ * Returns deduplicated resolved absolute paths.
+ */
+function detectImagePaths(text) {
+    const found = new Map(); // resolved -> original
+    for (const pattern of IMAGE_PATH_PATTERNS) {
+        // Reset lastIndex for global regex
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const rawPath = match[1];
+            const expanded = rawPath.startsWith('~/')
+                ? path.join(os.homedir(), rawPath.slice(2))
+                : rawPath;
+            const resolved = path.resolve(expanded);
+            if (!found.has(resolved)) {
+                found.set(resolved, rawPath);
+            }
+        }
+    }
+    return Array.from(found.entries()).map(([resolved, original]) => ({
+        original,
+        resolved,
+    }));
+}
+/**
+ * Validate an image file: exists, readable, supported format, under size limit, magic bytes match.
+ */
+async function validateImage(filePath) {
+    try {
+        const stat = await fs.stat(filePath);
+        if (!stat.isFile()) {
+            return { valid: false, error: 'Not a file' };
+        }
+        if (stat.size > MAX_IMAGE_SIZE) {
+            const sizeMB = (stat.size / (1024 * 1024)).toFixed(1);
+            return { valid: false, error: `Image too large: ${sizeMB}MB (max 5MB)` };
+        }
+        if (stat.size === 0) {
+            return { valid: false, error: 'Empty file' };
+        }
+        const ext = path.extname(filePath).toLowerCase();
+        const format = IMAGE_FORMATS[ext];
+        if (!format) {
+            return { valid: false, error: `Unsupported format: ${ext}` };
+        }
+        // Check magic bytes
+        const header = Buffer.alloc(8);
+        const fh = await fs.open(filePath, 'r');
+        try {
+            await fh.read(header, 0, 8, 0);
+        }
+        finally {
+            await fh.close();
+        }
+        const magicMatch = format.magic.some(magic => header.subarray(0, magic.length).equals(magic));
+        if (!magicMatch) {
+            return { valid: false, error: `File content doesn't match ${ext} format` };
+        }
+        return { valid: true, mediaType: format.mediaType, sizeBytes: stat.size };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { valid: false, error: 'File not found' };
+        }
+        if (err.code === 'EACCES') {
+            return { valid: false, error: 'Permission denied' };
+        }
+        return { valid: false, error: `Cannot read file: ${err.message}` };
+    }
+}
+/**
+ * Cache an image file to the content store images directory.
+ * Deduplicates by SHA-256 hash.
+ */
+async function cacheImage(sourcePath, imagesDir) {
+    await fs.mkdir(imagesDir, { recursive: true });
+    const fileData = await fs.readFile(sourcePath);
+    const hash = crypto.createHash('sha256').update(fileData).digest('hex').slice(0, 16);
+    const ext = path.extname(sourcePath).toLowerCase();
+    // Use hash prefix in filename for O(1) dedup via file existence check
+    const cachedName = `img_${hash}${ext}`;
+    const cachedPath = path.join(imagesDir, cachedName);
+    try {
+        await fs.access(cachedPath);
+        // File already exists with same content hash
+        return cachedPath;
+    }
+    catch {
+        // Not cached yet, copy it
+        await fs.copyFile(sourcePath, cachedPath);
+        return cachedPath;
+    }
+}
+/**
+ * Process a single detected image path: validate, cache, encode.
+ */
+async function processImagePath(original, resolved, imagesDir) {
+    const validation = await validateImage(resolved);
+    if (!validation.valid) {
+        return { error: validation.error };
+    }
+    const cachedPath = await cacheImage(resolved, imagesDir);
+    const fileData = await fs.readFile(resolved);
+    const base64Data = fileData.toString('base64');
+    return {
+        originalPath: original,
+        resolvedPath: resolved,
+        cachedPath,
+        mediaType: validation.mediaType,
+        base64Data,
+        sizeBytes: validation.sizeBytes,
+    };
+}
+/**
+ * Process all image references in a message text.
+ * Detects file paths, validates, caches, and encodes images.
+ * Returns processed images and cleaned text with paths replaced by [IMAGE: filename].
+ */
+export async function processImagesInMessage(text, contentBasePath) {
+    const imagesDir = path.join(contentBasePath, 'images');
+    const detected = detectImagePaths(text);
+    if (detected.length === 0) {
+        return { images: [], cleanedText: text, errors: [] };
+    }
+    const images = [];
+    const errors = [];
+    let cleanedText = text;
+    for (const { original, resolved } of detected) {
+        const result = await processImagePath(original, resolved, imagesDir);
+        if ('error' in result) {
+            errors.push({ path: original, error: result.error });
+        }
+        else {
+            images.push(result);
+            const filename = path.basename(resolved);
+            // Replace the path in the text with an image indicator
+            cleanedText = cleanedText.replace(original, `[IMAGE: ${filename}]`);
+        }
+    }
+    return { images, cleanedText, errors };
+}
+/**
+ * Read image data from the system clipboard.
+ * Platform-specific: macOS (osascript), Linux X11 (xclip), Linux Wayland (wl-paste).
+ * Returns null if clipboard has no image data.
+ */
+export async function readClipboardImage(contentBasePath) {
+    const platform = os.platform();
+    const imagesDir = path.join(contentBasePath, 'images');
+    await fs.mkdir(imagesDir, { recursive: true });
+    const tempPath = path.join(os.tmpdir(), `cumulus-clip-${nanoid(8)}.png`);
+    try {
+        if (platform === 'darwin') {
+            return await readMacClipboard(tempPath, imagesDir);
+        }
+        else if (platform === 'linux') {
+            return await readLinuxClipboard(tempPath, imagesDir);
+        }
+        return null;
+    }
+    catch {
+        // Clipboard read failed — no image data or command not available
+        return null;
+    }
+    finally {
+        // Clean up temp file
+        try {
+            await fs.unlink(tempPath);
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+async function readMacClipboard(tempPath, imagesDir) {
+    // Check if clipboard has image data (PNGf class)
+    try {
+        const { stdout } = await execFileAsync('osascript', ['-e', 'clipboard info']);
+        if (!stdout.includes('PNGf') && !stdout.includes('«class PNGf»')) {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+    // Write clipboard image to temp file
+    const script = `
+    set theFile to open for access POSIX file "${tempPath}" with write permission
+    set eof theFile to 0
+    write (the clipboard as «class PNGf») to theFile
+    close access theFile
+  `;
+    try {
+        await execFileAsync('osascript', ['-e', script]);
+    }
+    catch {
+        return null;
+    }
+    return await finishClipboardImage(tempPath, imagesDir);
+}
+async function readLinuxClipboard(tempPath, imagesDir) {
+    const isWayland = !!process.env.WAYLAND_DISPLAY;
+    try {
+        if (isWayland) {
+            const { stdout } = await execFileAsync('wl-paste', ['--type', 'image/png'], {
+                encoding: 'buffer',
+                maxBuffer: MAX_IMAGE_SIZE,
+            });
+            await fs.writeFile(tempPath, stdout);
+        }
+        else {
+            const { stdout } = await execFileAsync('xclip', ['-selection', 'clipboard', '-t', 'image/png', '-o'], { encoding: 'buffer', maxBuffer: MAX_IMAGE_SIZE });
+            await fs.writeFile(tempPath, stdout);
+        }
+    }
+    catch {
+        return null;
+    }
+    return await finishClipboardImage(tempPath, imagesDir);
+}
+async function finishClipboardImage(tempPath, imagesDir) {
+    const validation = await validateImage(tempPath);
+    if (!validation.valid) {
+        return null;
+    }
+    const cachedPath = await cacheImage(tempPath, imagesDir);
+    const fileData = await fs.readFile(tempPath);
+    const base64Data = fileData.toString('base64');
+    return {
+        originalPath: 'clipboard',
+        resolvedPath: tempPath,
+        cachedPath,
+        mediaType: validation.mediaType,
+        base64Data,
+        sizeBytes: validation.sizeBytes,
+    };
+}
+//# sourceMappingURL=image-utils.js.map

package/dist/lib/image-utils.js.map

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

package/dist/lib/migrate.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Migration utilities for upgrading old threads to support new features.
+ */
+export interface MigrationResult {
+    threadName: string;
+    messagesTotal: number;
+    embeddingsGenerated: number;
+    sessionCreated: boolean;
+    sessionExchanges: number;
+    errors: string[];
+}
+export interface MigrationProgress {
+    phase: 'loading' | 'embeddings' | 'sessions' | 'done';
+    current: number;
+    total: number;
+    message: string;
+}
+export type ProgressCallback = (progress: MigrationProgress) => void;
+/**
+ * Migrate a thread to support RAG features.
+ * - Generates embeddings for all messages
+ * - Creates a legacy session document from old conversations
+ */
+export declare function migrateThread(threadPath: string, onProgress?: ProgressCallback): Promise<MigrationResult>;
+/**
+ * Check if a thread needs migration.
+ * Returns true if embeddings or sessions are missing.
+ */
+export declare function needsMigration(threadPath: string): Promise<{
+    needsEmbeddings: boolean;
+    needsSessions: boolean;
+    messageCount: number;
+    embeddingCount: number;
+}>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/lib/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/lib/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAqK1B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAgCD"}