filex-cli 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# FileX
+
+A terminal CLI for safe local file operations with optional AI assistance.
+
+## Installation
+
+```bash
+npm install -g filex
+```
+
+## Usage
+
+### Manual Commands
+
+```bash
+# Convert images to WebP
+filex convert ./photos
+filex convert ./photos --max-width 1600 --quality 90
+
+# Resize images
+filex resize ./photos --max-width 800
+
+# Merge PDFs
+filex merge-pdfs ./documents
+filex merge-pdfs ./documents --output combined.pdf
+```
+
+### AI-Driven Usage
+
+Set your Gemini API key:
+```bash
+export GEMINI_API_KEY="your-api-key"
+```
+
+Then use natural language:
+```bash
+filex "convert all images here to webp and make them smaller for web"
+filex "resize these photos to 1200px wide" --directory ./photos
+filex "merge all the PDFs in this folder"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `convert <dir>` | Convert PNG/JPG/JPEG to WebP |
+| `resize <dir>` | Resize images to max width |
+| `merge-pdfs <dir>` | Merge all PDFs alphabetically |
+
+## Options
+
+### convert
+- `--max-width <px>` - Maximum width in pixels
+- `--quality <1-100>` - Output quality (default: 80)
+
+### resize
+- `--max-width <px>` - Maximum width in pixels (required)
+
+### merge-pdfs
+- `-o, --output <file>` - Output filename (default: merged.pdf)
+
+## Safety Guarantees
+
+- ✅ **Originals are never deleted** - All operations create new files
+- ✅ **Confirmation before writes** - Preview planned actions and approve
+- ✅ **AI is sandboxed** - AI only parses intent, never touches files
+- ✅ **Graceful errors** - Clear messages, no crashes on edge cases
+- ✅ **Works without AI** - Manual commands function independently
+
+## License
+
+MIT

package/dist/bin/filex.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=filex.d.ts.map

package/dist/bin/filex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filex.d.ts","sourceRoot":"","sources":["../../bin/filex.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/bin/filex.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { runCli } from '../src/cli.js';
+runCli();
+//# sourceMappingURL=filex.js.map

package/dist/bin/filex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filex.js","sourceRoot":"","sources":["../../bin/filex.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,EAAE,CAAC"}

package/dist/src/actions/convertImages.d.ts

@@ -0,0 +1,16 @@
+export declare const INPUT_FORMATS: readonly ["png", "jpg", "jpeg", "webp", "gif", "tiff", "avif"];
+export declare const OUTPUT_FORMATS: readonly ["webp", "png", "jpg"];
+export type InputFormat = typeof INPUT_FORMATS[number];
+export type OutputFormat = typeof OUTPUT_FORMATS[number];
+export interface ConvertImagesOptions {
+    from?: InputFormat | InputFormat[];
+    to?: OutputFormat;
+    quality?: number;
+    maxWidth?: number;
+}
+/**
+ * Convert images in a directory from one format to another.
+ * Originals are preserved. Output files are written alongside originals.
+ */
+export declare function convertImages(dirPath: string, options?: ConvertImagesOptions): Promise<void>;
+//# sourceMappingURL=convertImages.d.ts.map

package/dist/src/actions/convertImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertImages.d.ts","sourceRoot":"","sources":["../../../src/actions/convertImages.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,gEAAiE,CAAC;AAC5F,eAAO,MAAM,cAAc,iCAAkC,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACnC,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,IAAI,CAAC,CA0Gf"}

package/dist/src/actions/convertImages.js

@@ -0,0 +1,101 @@
+import * as path from 'node:path';
+import sharp from 'sharp';
+import ora from 'ora';
+import chalk from 'chalk';
+import { scanDirectory } from '../scan.js';
+import { confirmAction } from '../confirm.js';
+// Supported formats
+export const INPUT_FORMATS = ['png', 'jpg', 'jpeg', 'webp', 'gif', 'tiff', 'avif'];
+export const OUTPUT_FORMATS = ['webp', 'png', 'jpg'];
+/**
+ * Convert images in a directory from one format to another.
+ * Originals are preserved. Output files are written alongside originals.
+ */
+export async function convertImages(dirPath, options = {}) {
+    const { from, to = 'webp', quality = 80, maxWidth } = options;
+    // Determine which extensions to scan for
+    const inputExtensions = from
+        ? (Array.isArray(from) ? from : [from])
+        : [...INPUT_FORMATS];
+    // Filter out the target format from input (no point converting webp to webp)
+    const filteredExtensions = inputExtensions.filter(ext => {
+        // jpg and jpeg are the same
+        if (to === 'jpg' && (ext === 'jpg' || ext === 'jpeg'))
+            return false;
+        return ext !== to;
+    });
+    if (filteredExtensions.length === 0) {
+        console.log(chalk.yellow('No valid source formats to convert.'));
+        return;
+    }
+    // Scan for images with specified extensions
+    const scanResult = await scanDirectory(dirPath, filteredExtensions);
+    if (scanResult.count === 0) {
+        const extList = filteredExtensions.map(e => e.toUpperCase()).join(', ');
+        console.log(chalk.yellow(`No ${extList} images found in directory.`));
+        return;
+    }
+    // Build action descriptions
+    const fromLabel = from
+        ? (Array.isArray(from) ? from.join(', ') : from).toUpperCase()
+        : 'all supported formats';
+    const actions = [
+        `Convert ${fromLabel} → ${to.toUpperCase()}`,
+    ];
+    if (maxWidth) {
+        actions.push(`Resize to max width ${maxWidth}px`);
+    }
+    actions.push(`Quality: ${quality}%`);
+    // Confirm with user
+    const confirmed = await confirmAction({
+        fileCount: scanResult.count,
+        fileType: `${fromLabel} images`,
+        actions,
+        preserveOriginals: true,
+    });
+    if (!confirmed) {
+        return;
+    }
+    // Process images
+    const spinner = ora('Converting images...').start();
+    let successCount = 0;
+    let errorCount = 0;
+    for (const filePath of scanResult.files) {
+        try {
+            const dir = path.dirname(filePath);
+            const basename = path.basename(filePath, path.extname(filePath));
+            const outputExt = to === 'jpg' ? 'jpg' : to;
+            const outputPath = path.join(dir, `${basename}.${outputExt}`);
+            let pipeline = sharp(filePath);
+            if (maxWidth) {
+                pipeline = pipeline.resize({ width: maxWidth, withoutEnlargement: true });
+            }
+            // Convert to target format
+            switch (to) {
+                case 'webp':
+                    await pipeline.webp({ quality }).toFile(outputPath);
+                    break;
+                case 'png':
+                    await pipeline.png({ quality }).toFile(outputPath);
+                    break;
+                case 'jpg':
+                    await pipeline.jpeg({ quality }).toFile(outputPath);
+                    break;
+            }
+            successCount++;
+            spinner.text = `Converting images... (${successCount}/${scanResult.count})`;
+        }
+        catch (error) {
+            errorCount++;
+            spinner.warn(`Failed to convert: ${path.basename(filePath)}`);
+            spinner.start();
+        }
+    }
+    spinner.stop();
+    console.log();
+    console.log(chalk.green(`✓ Converted ${successCount} images to ${to.toUpperCase()}`));
+    if (errorCount > 0) {
+        console.log(chalk.red(`✗ Failed to convert ${errorCount} images`));
+    }
+}
+//# sourceMappingURL=convertImages.js.map

package/dist/src/actions/convertImages.js.map

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

package/dist/src/actions/mergePdfs.d.ts

@@ -0,0 +1,12 @@
+export declare const SORT_ORDERS: readonly ["name", "name-desc", "date", "date-desc", "random"];
+export type SortOrder = typeof SORT_ORDERS[number];
+export interface MergePdfsOptions {
+    outputFile?: string;
+    order?: SortOrder;
+}
+/**
+ * Merge all PDFs in a directory into a single output file.
+ * Originals are preserved.
+ */
+export declare function mergePdfs(dirPath: string, options?: MergePdfsOptions): Promise<void>;
+//# sourceMappingURL=mergePdfs.d.ts.map

package/dist/src/actions/mergePdfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePdfs.d.ts","sourceRoot":"","sources":["../../../src/actions/mergePdfs.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,WAAW,+DAAgE,CAAC;AACzF,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACrB;AAwED;;;GAGG;AACH,wBAAsB,SAAS,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyEf"}

package/dist/src/actions/mergePdfs.js

@@ -0,0 +1,132 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { PDFDocument } from 'pdf-lib';
+import ora from 'ora';
+import chalk from 'chalk';
+import { scanForPdfs } from '../scan.js';
+import { confirmAction } from '../confirm.js';
+export const SORT_ORDERS = ['name', 'name-desc', 'date', 'date-desc', 'random'];
+/**
+ * Get file modification time.
+ */
+async function getFileMtime(filePath) {
+    const stat = await fs.stat(filePath);
+    return stat.mtimeMs;
+}
+/**
+ * Sort files according to the specified order.
+ */
+async function sortFiles(files, order) {
+    const sorted = [...files];
+    switch (order) {
+        case 'name':
+            // Already sorted alphabetically by scan.ts
+            return sorted;
+        case 'name-desc':
+            return sorted.reverse();
+        case 'date': {
+            const withTimes = await Promise.all(sorted.map(async (f) => ({ path: f, mtime: await getFileMtime(f) })));
+            withTimes.sort((a, b) => a.mtime - b.mtime);
+            return withTimes.map((f) => f.path);
+        }
+        case 'date-desc': {
+            const withTimes = await Promise.all(sorted.map(async (f) => ({ path: f, mtime: await getFileMtime(f) })));
+            withTimes.sort((a, b) => b.mtime - a.mtime);
+            return withTimes.map((f) => f.path);
+        }
+        case 'random':
+            for (let i = sorted.length - 1; i > 0; i--) {
+                const j = Math.floor(Math.random() * (i + 1));
+                [sorted[i], sorted[j]] = [sorted[j], sorted[i]];
+            }
+            return sorted;
+        default:
+            return sorted;
+    }
+}
+/**
+ * Get human-readable order description.
+ */
+function getOrderDescription(order) {
+    switch (order) {
+        case 'name':
+            return 'alphabetical (A→Z)';
+        case 'name-desc':
+            return 'reverse alphabetical (Z→A)';
+        case 'date':
+            return 'oldest first';
+        case 'date-desc':
+            return 'newest first';
+        case 'random':
+            return 'random';
+        default:
+            return 'alphabetical';
+    }
+}
+/**
+ * Merge all PDFs in a directory into a single output file.
+ * Originals are preserved.
+ */
+export async function mergePdfs(dirPath, options = {}) {
+    const { outputFile = 'merged.pdf', order = 'name' } = options;
+    // Scan for PDFs
+    const scanResult = await scanForPdfs(dirPath);
+    if (scanResult.count === 0) {
+        console.log(chalk.yellow('No PDF files found in directory.'));
+        return;
+    }
+    if (scanResult.count === 1) {
+        console.log(chalk.yellow('Only one PDF found. Nothing to merge.'));
+        return;
+    }
+    // Sort files according to order
+    const sortedFiles = await sortFiles(scanResult.files, order);
+    const outputPath = path.join(scanResult.directory, outputFile);
+    const orderDesc = getOrderDescription(order);
+    // Build action descriptions
+    const actions = [
+        `Merge ${scanResult.count} PDFs (${orderDesc})`,
+        `Output: ${outputFile}`,
+    ];
+    // Confirm with user
+    const confirmed = await confirmAction({
+        fileCount: scanResult.count,
+        fileType: 'PDF files',
+        actions,
+        preserveOriginals: true,
+    });
+    if (!confirmed) {
+        return;
+    }
+    // Merge PDFs
+    const spinner = ora('Merging PDFs...').start();
+    try {
+        const mergedPdf = await PDFDocument.create();
+        for (let i = 0; i < sortedFiles.length; i++) {
+            const filePath = sortedFiles[i];
+            spinner.text = `Merging PDFs... (${i + 1}/${scanResult.count})`;
+            try {
+                const pdfBytes = await fs.readFile(filePath);
+                const pdf = await PDFDocument.load(pdfBytes);
+                const pages = await mergedPdf.copyPages(pdf, pdf.getPageIndices());
+                for (const page of pages) {
+                    mergedPdf.addPage(page);
+                }
+            }
+            catch (error) {
+                spinner.warn(`Failed to read: ${path.basename(filePath)}`);
+                spinner.start();
+            }
+        }
+        const outputBytes = await mergedPdf.save();
+        await fs.writeFile(outputPath, outputBytes);
+        spinner.stop();
+        console.log();
+        console.log(chalk.green(`✓ Created ${outputFile} with ${mergedPdf.getPageCount()} pages`));
+    }
+    catch (error) {
+        spinner.stop();
+        console.log(chalk.red(`✗ Failed to merge PDFs: ${error.message}`));
+    }
+}
+//# sourceMappingURL=mergePdfs.js.map

package/dist/src/actions/mergePdfs.js.map

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

package/dist/src/actions/resizeImages.d.ts

@@ -0,0 +1,11 @@
+export interface ResizeImagesOptions {
+    maxWidth: number;
+    quality?: number;
+}
+/**
+ * Resize images in a directory to a maximum width.
+ * Aspect ratio is preserved. Originals are preserved.
+ * Output files are written with _resized suffix.
+ */
+export declare function resizeImages(dirPath: string, options: ResizeImagesOptions): Promise<void>;
+//# sourceMappingURL=resizeImages.d.ts.map

package/dist/src/actions/resizeImages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizeImages.d.ts","sourceRoot":"","sources":["../../../src/actions/resizeImages.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/src/actions/resizeImages.js

@@ -0,0 +1,71 @@
+import * as path from 'node:path';
+import sharp from 'sharp';
+import ora from 'ora';
+import chalk from 'chalk';
+import { scanForImages } from '../scan.js';
+import { confirmAction } from '../confirm.js';
+/**
+ * Resize images in a directory to a maximum width.
+ * Aspect ratio is preserved. Originals are preserved.
+ * Output files are written with _resized suffix.
+ */
+export async function resizeImages(dirPath, options) {
+    const { maxWidth, quality = 80 } = options;
+    // Scan for images
+    const scanResult = await scanForImages(dirPath);
+    if (scanResult.count === 0) {
+        console.log(chalk.yellow('No images found in directory.'));
+        return;
+    }
+    // Build action descriptions
+    const actions = [
+        `Resize to max width ${maxWidth}px`,
+        'Preserve aspect ratio',
+    ];
+    // Confirm with user
+    const confirmed = await confirmAction({
+        fileCount: scanResult.count,
+        fileType: 'images',
+        actions,
+        preserveOriginals: true,
+    });
+    if (!confirmed) {
+        return;
+    }
+    // Process images
+    const spinner = ora('Resizing images...').start();
+    let successCount = 0;
+    let errorCount = 0;
+    for (const filePath of scanResult.files) {
+        try {
+            const dir = path.dirname(filePath);
+            const ext = path.extname(filePath);
+            const basename = path.basename(filePath, ext);
+            const outputPath = path.join(dir, `${basename}_resized${ext}`);
+            const metadata = await sharp(filePath).metadata();
+            // Skip if already smaller than maxWidth
+            if (metadata.width && metadata.width <= maxWidth) {
+                spinner.text = `Skipping ${path.basename(filePath)} (already ${metadata.width}px wide)`;
+                successCount++;
+                continue;
+            }
+            await sharp(filePath)
+                .resize({ width: maxWidth, withoutEnlargement: true })
+                .toFile(outputPath);
+            successCount++;
+            spinner.text = `Resizing images... (${successCount}/${scanResult.count})`;
+        }
+        catch (error) {
+            errorCount++;
+            spinner.warn(`Failed to resize: ${path.basename(filePath)}`);
+            spinner.start();
+        }
+    }
+    spinner.stop();
+    console.log();
+    console.log(chalk.green(`✓ Resized ${successCount} images successfully`));
+    if (errorCount > 0) {
+        console.log(chalk.red(`✗ Failed to resize ${errorCount} images`));
+    }
+}
+//# sourceMappingURL=resizeImages.js.map

package/dist/src/actions/resizeImages.js.map

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

package/dist/src/ai/explain.d.ts

@@ -0,0 +1,15 @@
+import type { Action } from '../schema.js';
+/**
+ * Get action name for display.
+ */
+export declare function getActionName(action: Action): string;
+/**
+ * Generate a human-friendly explanation from an Action.
+ * This is a pure function - no API calls needed.
+ */
+export declare function explainAction(action: Action): string[];
+/**
+ * Format explanation as a styled string for console output.
+ */
+export declare function formatExplanation(action: Action): string;
+//# sourceMappingURL=explain.d.ts.map

package/dist/src/ai/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/ai/explain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkDtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/dist/src/ai/explain.js

@@ -0,0 +1,75 @@
+import chalk from 'chalk';
+/**
+ * Get action name for display.
+ */
+export function getActionName(action) {
+    switch (action.action) {
+        case 'convert_images':
+            return 'Image Conversion';
+        case 'resize_images':
+            return 'Image Resize';
+        case 'merge_pdfs':
+            return 'PDF Merge';
+        default:
+            return 'Unknown';
+    }
+}
+/**
+ * Generate a human-friendly explanation from an Action.
+ * This is a pure function - no API calls needed.
+ */
+export function explainAction(action) {
+    switch (action.action) {
+        case 'convert_images': {
+            const lines = [];
+            const from = action.options?.from;
+            const to = action.options?.to ?? action.options?.format ?? 'webp';
+            if (from) {
+                lines.push(`Convert: ${from.toUpperCase()} → ${to.toUpperCase()}`);
+            }
+            else {
+                lines.push(`Convert to: ${to.toUpperCase()}`);
+            }
+            if (action.options?.maxWidth) {
+                lines.push(`Max width: ${action.options.maxWidth}px`);
+            }
+            if (action.options?.quality) {
+                lines.push(`Quality: ${action.options.quality}%`);
+            }
+            return lines;
+        }
+        case 'resize_images': {
+            return [
+                `Max width: ${action.options.maxWidth}px`,
+                'Aspect ratio preserved',
+            ];
+        }
+        case 'merge_pdfs': {
+            const outputFile = action.options?.outputFile ?? 'merged.pdf';
+            const order = action.options?.order ?? 'name';
+            const orderLabels = {
+                'name': 'Alphabetical (A→Z)',
+                'name-desc': 'Reverse (Z→A)',
+                'date': 'Oldest first',
+                'date-desc': 'Newest first',
+                'random': 'Random',
+            };
+            return [
+                `Order: ${orderLabels[order] ?? 'Alphabetical'}`,
+                `Output: ${outputFile}`,
+            ];
+        }
+        default:
+            return ['Unknown action'];
+    }
+}
+/**
+ * Format explanation as a styled string for console output.
+ */
+export function formatExplanation(action) {
+    const name = getActionName(action);
+    const lines = explainAction(action);
+    const formatted = lines.map(line => `  ${chalk.gray('›')} ${chalk.white(line)}`).join('\n');
+    return `${chalk.cyan.bold(`▸ ${name}`)}\n${formatted}`;
+}
+//# sourceMappingURL=explain.js.map

package/dist/src/ai/explain.js.map

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

package/dist/src/ai/parseIntent.d.ts

@@ -0,0 +1,18 @@
+import { type Action } from '../schema.js';
+export type ParseIntentResult = {
+    success: true;
+    action: Action;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parse natural language input into a structured Action using Gemini AI.
+ * Returns a validated Action or an error message.
+ */
+export declare function parseIntent(input: string): Promise<ParseIntentResult>;
+/**
+ * Display a helpful message when AI parsing fails.
+ */
+export declare function showAiFailureMessage(error: string): void;
+//# sourceMappingURL=parseIntent.d.ts.map

package/dist/src/ai/parseIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseIntent.d.ts","sourceRoot":"","sources":["../../../src/ai/parseIntent.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AA+B5D,MAAM,MAAM,iBAAiB,GACvB;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB,GACC;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwG3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAiBxD"}