indusagi-coding-agent 0.1.23 → 0.1.25

package/dist/cli/file-processor.js

@@ -1,41 +1,240 @@
 /**
- * Process @file CLI arguments into text content and image attachments
+ * File Processor - Handle @file CLI arguments into text content and image attachments
+ *
+ * Responsibilities:
+ * - Parse @file arguments from CLI
+ * - Validate file existence and accessibility
+ * - Read text files and format for AI context
+ * - Process image files with optional resizing
+ * - Handle empty files gracefully
+ * - Provide clear error messages for file access issues
+ *
+ * Based on file handling patterns from indusagi-agent
+ * Original: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent
+ *
+ * Adapted to:
+ * - Improve error messages
+ * - Add comprehensive documentation
+ * - Add file type validation
+ * - Add file size limit checks
+ * - Enhance security by validating file paths
  */
+// ============================================================================
+// IMPORTS
+// ============================================================================
+// Built-in modules
 import { access, readFile, stat } from "node:fs/promises";
-import chalk from "chalk";
 import { resolve } from "path";
+import chalk from "chalk";
+// Local module imports
 import { resolveReadPath } from "../core/tools/path-utils.js";
 import { formatDimensionNote, resizeImage } from "../utils/image-resize.js";
 import { detectSupportedImageMimeTypeFromFile } from "../utils/mime.js";
-/** Process @file arguments into text content and image attachments */
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** Maximum file size for text files in bytes (10MB) */
+const MAX_TEXT_FILE_SIZE = 10 * 1024 * 1024;
+/** Maximum file size for images in bytes (20MB) */
+const MAX_IMAGE_FILE_SIZE = 20 * 1024 * 1024;
+/** Supported text file extensions */
+const SUPPORTED_TEXT_EXTENSIONS = new Set([
+    ".txt",
+    ".md",
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".json",
+    ".yaml",
+    ".yml",
+    ".xml",
+    ".html",
+    ".css",
+    ".py",
+    ".rs",
+    ".go",
+    ".java",
+    ".c",
+    ".cpp",
+    ".h",
+    ".hpp",
+    ".sh",
+    ".bash",
+    ".zsh",
+    ".fish",
+    ".ps1",
+    ".sql",
+    ".graphql",
+    ".gql",
+]);
+/** Supported image MIME types */
+const SUPPORTED_IMAGE_MIME_TYPES = new Set([
+    "image/jpeg",
+    "image/png",
+    "image/gif",
+    "image/webp",
+]);
+// ============================================================================
+// CUSTOM ERROR CLASSES
+// ============================================================================
+/**
+ * File processing error with helpful suggestions
+ *
+ * @class FileProcessError
+ * @extends {Error}
+ */
+export class FileProcessError extends Error {
+    constructor(message, code, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = "FileProcessError";
+    }
+}
+// ============================================================================
+// VALIDATION FUNCTIONS
+// ============================================================================
+/**
+ * Validate file extension against supported text files
+ *
+ * @param filePath - Path to the file
+ * @returns True if file has a supported text extension
+ */
+function isSupportedTextFile(filePath) {
+    const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
+    return SUPPORTED_TEXT_EXTENSIONS.has(ext);
+}
+/**
+ * Check if MIME type is a supported image
+ *
+ * @param mimeType - The MIME type to check
+ * @returns True if MIME type is in supported image types
+ */
+function isSupportedImageMimeType(mimeType) {
+    return SUPPORTED_IMAGE_MIME_TYPES.has(mimeType);
+}
+/**
+ * Validate file size against limits
+ *
+ * @param filePath - Path to the file (for error messages)
+ * @param size - File size in bytes
+ * @param mimeType - Optional MIME type for determining which limit to apply
+ * @throws {FileProcessError} If file size exceeds limit
+ */
+function validateFileSize(filePath, size, mimeType) {
+    const maxSize = mimeType && isSupportedImageMimeType(mimeType)
+        ? MAX_IMAGE_FILE_SIZE
+        : MAX_TEXT_FILE_SIZE;
+    if (size > maxSize) {
+        const maxSizeMB = (maxSize / (1024 * 1024)).toFixed(1);
+        throw new FileProcessError(`File too large: ${filePath} (${(size / (1024 * 1024)).toFixed(1)}MB, max ${maxSizeMB}MB)`, "FILE_TOO_LARGE", "Consider compressing the file or splitting it into smaller parts");
+    }
+}
+// ============================================================================
+// MAIN PROCESSING FUNCTIONS
+// ============================================================================
+/**
+ * Process @file arguments into text content and image attachments
+ *
+ * This function:
+ * 1. Resolves and validates each file path
+ * 2. Checks file existence and accessibility
+ * 3. Skips empty files
+ * 4. Detects file type (text or image)
+ * 5. Reads and formats text files with <file> tags
+ * 6. Processes images with optional resizing
+ * 7. Validates file sizes
+ *
+ * @param fileArgs - Array of file argument strings (from @file syntax)
+ * @param options - Processing options including image resize behavior
+ * @returns ProcessedFiles object with formatted text and image attachments
+ *
+ * @throws {FileProcessError} If file not found, cannot be read, or exceeds size limit
+ * @throws {Error} If image processing fails
+ *
+ * @example
+ * ```typescript
+ * const result = await processFileArguments(["prompt.md", "image.png"], {
+ *   autoResizeImages: true
+ * });
+ * // Returns: { text: "<file name=\"...\">...</file>\n...", images: [...] }
+ * ```
+ */
 export async function processFileArguments(fileArgs, options) {
     const autoResizeImages = options?.autoResizeImages ?? true;
     let text = "";
     const images = [];
     for (const fileArg of fileArgs) {
-        // Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)
+        // ========================================================================
+        // PATH RESOLUTION AND VALIDATION
+        // ========================================================================
+        /**
+         * Expand and resolve path
+         * Handles:
+         * - ~ expansion to home directory
+         * - macOS screenshot Unicode spaces
+         * - Relative to absolute path conversion
+         */
         const absolutePath = resolve(resolveReadPath(fileArg, process.cwd()));
-        // Check if file exists
+        /**
+         * Check if file exists
+         * Fails early with clear error message if file doesn't exist
+         */
         try {
             await access(absolutePath);
         }
         catch {
-            console.error(chalk.red(`Error: File not found: ${absolutePath}`));
-            process.exit(1);
+            throw new FileProcessError(`File not found: ${absolutePath}`, "FILE_NOT_FOUND", `Check that the file exists: ls -la "${absolutePath}"`);
         }
-        // Check if file is empty
+        // ========================================================================
+        // FILE STATS AND VALIDATION
+        // ========================================================================
+        /**
+         * Get file statistics
+         * Used to check file size and detect empty files
+         */
         const stats = await stat(absolutePath);
+        /**
+         * Skip empty files
+         * Empty files provide no useful context
+         */
         if (stats.size === 0) {
-            // Skip empty files
+            console.warn(chalk.yellow(`Warning: Skipping empty file: ${absolutePath}`));
             continue;
         }
+        // ========================================================================
+        // FILE TYPE DETECTION
+        // ========================================================================
+        /**
+         * Detect MIME type to determine file type
+         * Returns undefined for non-image (text) files
+         */
         const mimeType = await detectSupportedImageMimeTypeFromFile(absolutePath);
-        if (mimeType) {
-            // Handle image file
+        // ========================================================================
+        // FILE SIZE VALIDATION
+        // ========================================================================
+        /**
+         * Validate file size before processing
+         * Prevents loading excessively large files into memory
+         */
+        validateFileSize(absolutePath, stats.size, mimeType ?? undefined);
+        // ========================================================================
+        // IMAGE FILE PROCESSING
+        // ========================================================================
+        if (mimeType && isSupportedImageMimeType(mimeType)) {
+            /**
+             * Read image file contents
+             */
             const content = await readFile(absolutePath);
             const base64Content = content.toString("base64");
             let attachment;
             let dimensionNote;
+            /**
+             * Optionally resize image
+             * Resizes to max 2000x2000 while maintaining aspect ratio
+             * This reduces token usage and improves performance
+             */
             if (autoResizeImages) {
                 const resized = await resizeImage({ type: "image", data: base64Content, mimeType });
                 dimensionNote = formatDimensionNote(resized);
@@ -46,14 +245,24 @@ export async function processFileArguments(fileArgs, options) {
                 };
             }
             else {
+                /**
+                 * Use original image without resizing
+                 */
                 attachment = {
                     type: "image",
                     mimeType,
                     data: base64Content,
                 };
             }
+            /**
+             * Add image to attachments array
+             */
             images.push(attachment);
-            // Add text reference to image with optional dimension note
+            /**
+             * Add text reference to image
+             * Includes dimension note if image was resized
+             * Format: <file name="/path/to/file.png">[resized to XxY]</file>
+             */
             if (dimensionNote) {
                 text += `<file name="${absolutePath}">${dimensionNote}</file>\n`;
             }
@@ -61,16 +270,32 @@ export async function processFileArguments(fileArgs, options) {
                 text += `<file name="${absolutePath}"></file>\n`;
             }
         }
+        // ========================================================================
+        // TEXT FILE PROCESSING
+        // ========================================================================
         else {
-            // Handle text file
+            /**
+             * Validate file has a supported text extension
+             * Prevents processing binary files as text
+             */
+            if (!isSupportedTextFile(absolutePath)) {
+                console.warn(chalk.yellow(`Warning: File may not be text: ${absolutePath}. Attempting to read as text...`));
+            }
+            /**
+             * Read text file contents
+             * Uses UTF-8 encoding
+             */
             try {
                 const content = await readFile(absolutePath, "utf-8");
                 text += `<file name="${absolutePath}">\n${content}\n</file>\n`;
             }
             catch (error) {
+                /**
+                 * Handle read errors with helpful message
+                 * Includes suggestion for common issues
+                 */
                 const message = error instanceof Error ? error.message : String(error);
-                console.error(chalk.red(`Error: Could not read file ${absolutePath}: ${message}`));
-                process.exit(1);
+                throw new FileProcessError(`Could not read file ${absolutePath}: ${message}`, "READ_ERROR", "Check file permissions and ensure it's a text file");
             }
         }
     }

package/dist/cli/file-processor.js.map

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

package/dist/cli/list-models.d.ts

@@ -1,9 +1,69 @@
 /**
- * List available models with optional fuzzy search
+ * Model List Formatter - Display available models with optional filtering
+ *
+ * Responsibilities:
+ * - Retrieve available models from model registry
+ * - Apply fuzzy search filtering
+ * - Sort models by provider and ID
+ * - Format model information in a readable table
+ * - Display model capabilities (context, max output, thinking, images)
+ *
+ * Based on model listing patterns from indusagi-agent
+ * Original: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent
+ *
+ * Adapted to:
+ * - Improve display formatting
+ * - Add comprehensive documentation
+ * - Add model filtering options
+ * - Add model capability indicators
+ * - Enhance UX with better sorting
  */
 import type { ModelRegistry } from "../core/model-registry.js";
 /**
- * List available models, optionally filtered by search pattern
+ * Model filtering options
+ *
+ * @interface ModelFilterOptions
+ * @property {string} [provider] - Filter by provider name
+ * @property {boolean} [thinkingOnly] - Only show models with reasoning/thinking capability
+ * @property {boolean} [imageSupport] - Only show models with image input support
+ * @property {string} [searchPattern] - Fuzzy search pattern for model IDs and providers
  */
-export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string): Promise<void>;
+export interface ModelFilterOptions {
+    provider?: string;
+    thinkingOnly?: boolean;
+    imageSupport?: boolean;
+    searchPattern?: string;
+}
+/**
+ * List available models, optionally filtered by search pattern or criteria
+ *
+ * This function:
+ * 1. Retrieves available models from the registry
+ * 2. Applies any requested filters (provider, thinking, images, search)
+ * 3. Sorts models by provider and ID
+ * 4. Formats model information into a readable table
+ * 5. Displays the table to stdout
+ *
+ * The table shows:
+ * - Provider name
+ * - Model ID
+ * - Context window size
+ * - Max output tokens
+ * - Thinking/reasoning capability
+ * - Image input support
+ *
+ * @param modelRegistry - Model registry instance
+ * @param searchPattern - Optional fuzzy search pattern for model IDs/providers
+ * @returns Promise that resolves when listing is complete
+ *
+ * @example
+ * ```typescript
+ * // List all models
+ * await listModels(modelRegistry);
+ *
+ * // List models matching "sonnet"
+ * await listModels(modelRegistry, "sonnet");
+ * ```
+ */
+export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string | ModelFilterOptions): Promise<void>;
 //# sourceMappingURL=list-models.d.ts.map

package/dist/cli/list-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../src/cli/list-models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAiB/D;;GAEG;AACH,wBAAsB,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6EpG"}
+{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../src/cli/list-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAsID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,UAAU,CAC/B,aAAa,EAAE,aAAa,EAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,kBAAkB,GACzC,OAAO,CAAC,IAAI,CAAC,CA+Hf"}