@juspay/neurolink 9.94.6 → 9.94.7

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.94.7](https://github.com/juspay/neurolink/compare/v9.94.6...v9.94.7) (2026-07-19)
+
+### Bug Fixes
+
+- **(cli):** validate csv-max-rows, warn on large files, and document multimodal inputs ([124f0d6](https://github.com/juspay/neurolink/commit/124f0d6ca95d7d0819ab001cb9cf753052308ed1))
+
 ## [9.94.6](https://github.com/juspay/neurolink/compare/v9.94.5...v9.94.6) (2026-07-19)
 
 ### Bug Fixes

package/dist/cli/factories/commandFactory.d.ts

@@ -24,8 +24,6 @@ export declare class CLICommandFactory {
     private static processCliPDFFiles;
     private static processCliFiles;
     private static processCliVideoFiles;
-    private static isNonLocalFileReference;
-    private static validateCliInputFiles;
     private static processOptions;
     /**
      * Validate Anthropic subscription options

package/dist/cli/factories/commandFactory.js

@@ -24,6 +24,7 @@ import { initializeCliParser } from "../parser.js";
 import { formatFileSize, saveAudioToFile } from "../utils/audioFileUtils.js";
 import { playAudio } from "../utils/audioPlayer.js";
 import { resolveFilePaths } from "../utils/pathResolver.js";
+import { validateCliInputFiles, validateCsvMaxRows, } from "../utils/inputValidation.js";
 import { animatedWrite } from "../utils/typewriter.js";
 import { createStreamAbortHandler } from "../utils/abortHandler.js";
 import { formatVideoFileSize, getVideoMetadataSummary, saveVideoToFile, } from "../utils/videoFileUtils.js";
@@ -187,7 +188,7 @@ export class CLICommandFactory {
         csvMaxRows: {
             type: "number",
             default: 1000,
-            description: "Maximum number of CSV rows to process",
+            description: "Maximum number of CSV rows to process (positive integer, range 1-100000, default 1000)",
         },
         csvFormat: {
             type: "string",
@@ -805,42 +806,6 @@ export class CLICommandFactory {
         // URLs are preserved as-is by resolveFilePaths
         return resolveFilePaths(paths);
     }
-    static isNonLocalFileReference(filePath) {
-        const lower = filePath.toLowerCase();
-        return (lower.startsWith("http://") ||
-            lower.startsWith("https://") ||
-            lower.startsWith("file://") ||
-            lower.startsWith("data:"));
-    }
-    static validateCliInputFiles(argv) {
-        const fileArgs = [
-            { option: "--image", value: argv.image },
-            { option: "--csv", value: argv.csv },
-            { option: "--pdf", value: argv.pdf },
-            { option: "--video", value: argv.video },
-            { option: "--file", value: argv.file },
-        ];
-        const missingPaths = [];
-        for (const { option, value } of fileArgs) {
-            if (!value) {
-                continue;
-            }
-            const rawPaths = Array.isArray(value) ? value : [value];
-            const resolvedPaths = resolveFilePaths(rawPaths);
-            for (let i = 0; i < resolvedPaths.length; i++) {
-                const resolvedPath = resolvedPaths[i];
-                if (CLICommandFactory.isNonLocalFileReference(resolvedPath)) {
-                    continue;
-                }
-                if (!fs.existsSync(resolvedPath)) {
-                    missingPaths.push(`${option} path not found: ${rawPaths[i]} (resolved to ${resolvedPath})`);
-                }
-            }
-        }
-        if (missingPaths.length > 0) {
-            throw new Error(`One or more input files do not exist:\n${missingPaths.join("\n")}`);
-        }
-    }
     // Helper method to process common options
     static processOptions(argv) {
         // Handle noColor option by disabling chalk
@@ -1538,7 +1503,12 @@ export class CLICommandFactory {
                     .example('$0 generate "Smooth camera movement" --image ./input.jpg --provider vertex --model veo-3.1-generate-001 --outputMode video --videoResolution 720p --videoLength 6 --videoAspectRatio 16:9 --videoOutput ./output.mp4', "Video generation with full options")
                     .example('$0 generate "AI in Healthcare" --pptPages 10', "Generate a PowerPoint presentation")
                     .example('$0 generate "Company Q4 Results" --pptPages 15 --pptTheme corporate --pptAudience business', "Generate presentation with options")
-                    .example('$0 generate "Machine Learning 101" --pptTheme minimal --pptTone educational --pptNoImages', "Generate educational slides without AI images"));
+                    .example('$0 generate "Machine Learning 101" --pptTheme minimal --pptTone educational --pptNoImages', "Generate educational slides without AI images")
+                    .example('$0 generate "Describe this image" --image ./photo.jpg', "Analyze an image (multimodal input)")
+                    .example('$0 generate "Summarize this report" --pdf ./report.pdf', "Analyze a PDF document")
+                    .example('$0 generate "Key trends?" --csv large-data.csv --csvMaxRows 100', "Analyze a CSV with a row limit")
+                    .example('$0 generate "Compare the chart and the report" --image ./chart.png --pdf ./report.pdf', "Combine multiple file types in one prompt")
+                    .example('$0 generate "What is in this file?" --file ./data.json', "Auto-detect a file type with --file"));
             },
             handler: async (argv) => await CLICommandFactory.executeGenerate(argv),
         };
@@ -1560,7 +1530,10 @@ export class CLICommandFactory {
                     .example('$0 stream "Explain machine learning" -p anthropic', "Stream with specific provider")
                     .example('$0 stream "Code walkthrough" --output story.txt', "Stream to file")
                     .example('echo "Live demo" | $0 stream', "Stream from stdin")
-                    .example('$0 stream "Narrate this video" --video path/to/video.mp4', "Stream video analysis"));
+                    .example('$0 stream "Narrate this video" --video path/to/video.mp4', "Stream video analysis")
+                    .example('$0 stream "Describe this image" --image ./photo.jpg', "Stream image analysis (multimodal input)")
+                    .example('$0 stream "Summarize this document" --pdf ./report.pdf', "Stream PDF analysis")
+                    .example('$0 stream "Explain this dataset" --csv ./data.csv --csv-format markdown', "Stream CSV analysis"));
             },
             handler: async (argv) => await CLICommandFactory.executeStream(argv),
         };
@@ -2277,7 +2250,11 @@ export class CLICommandFactory {
                 if (isSttOnly) {
                     return "";
                 }
-                throw new Error("No input received from stdin");
+                throw new Error("❌ No input received from stdin.\n" +
+                    "💡 Try this:\n" +
+                    '   neurolink generate "your prompt"\n' +
+                    '   echo "your prompt" | neurolink generate\n' +
+                    '   neurolink generate "Describe this image" --image ./photo.jpg');
             }
             return trimmedData;
         }
@@ -2285,7 +2262,11 @@ export class CLICommandFactory {
             if (isSttOnly) {
                 return "";
             }
-            throw new Error('Input required. Use: neurolink generate "your prompt" or echo "prompt" | neurolink generate');
+            throw new Error("❌ Input required.\n" +
+                "💡 Try this:\n" +
+                '   neurolink generate "your prompt"\n' +
+                '   echo "your prompt" | neurolink generate\n' +
+                '   neurolink generate "Describe this image" --image ./photo.jpg');
         }
         return argv.input;
     }
@@ -2544,7 +2525,8 @@ export class CLICommandFactory {
             if (options.delay) {
                 await new Promise((resolve) => setTimeout(resolve, options.delay));
             }
-            CLICommandFactory.validateCliInputFiles(argv);
+            validateCliInputFiles(argv);
+            validateCsvMaxRows(argv);
             // Process context
             const { inputText, contextMetadata } = CLICommandFactory.processGenerateContext(rawInput, options);
             // Handle dry-run mode for testing
@@ -3304,7 +3286,11 @@ export class CLICommandFactory {
                     argv.input = "";
                     return;
                 }
-                throw new Error("No input received from stdin");
+                throw new Error("❌ No input received from stdin.\n" +
+                    "💡 Try this:\n" +
+                    '   neurolink stream "your prompt"\n' +
+                    '   echo "your prompt" | neurolink stream\n' +
+                    '   neurolink stream "Describe this image" --image ./photo.jpg');
             }
         }
         else if (!argv.input) {
@@ -3312,7 +3298,11 @@ export class CLICommandFactory {
                 argv.input = "";
                 return;
             }
-            throw new Error('Input required. Use: neurolink stream "your prompt" or echo "prompt" | neurolink stream');
+            throw new Error("❌ Input required.\n" +
+                "💡 Try this:\n" +
+                '   neurolink stream "your prompt"\n' +
+                '   echo "your prompt" | neurolink stream\n' +
+                '   neurolink stream "Describe this image" --image ./photo.jpg');
         }
     }
     /**
@@ -3331,7 +3321,8 @@ export class CLICommandFactory {
             if (options.delay) {
                 await new Promise((resolve) => setTimeout(resolve, options.delay));
             }
-            CLICommandFactory.validateCliInputFiles(argv);
+            validateCliInputFiles(argv);
+            validateCsvMaxRows(argv);
             const { inputText, contextMetadata } = await CLICommandFactory.processStreamContext(argv, options);
             // Handle dry-run mode for testing
             if (options.dryRun) {

package/dist/cli/loop/session.js

@@ -414,6 +414,22 @@ export class LoopSession {
             logger.always(chalk.yellow(`  ${c.cmd.padEnd(20)}`) + `${c.desc}`);
         });
         logger.always("\nAny other command will be executed as a standard neurolink CLI command.");
+        // #315: multimodal file flags are buried in the raw yargs dump below — call
+        // them out explicitly so loop users know PDFs/images/CSVs/video are supported.
+        logger.always(chalk.cyan("\nMultimodal file inputs (per-command flags):"));
+        [
+            ["--image <path|url>", "Attach an image for analysis (repeatable)"],
+            ["--pdf <path|url>", "Attach a PDF document (repeatable)"],
+            [
+                "--csv <path|url>",
+                "Attach a CSV file (see --csv-format, --csv-max-rows)",
+            ],
+            ["--video <path|url>", "Attach a video for analysis"],
+            ["--file <path|url>", "Attach a file and auto-detect its type"],
+        ].forEach(([flag, desc]) => {
+            logger.always(chalk.yellow(`  ${flag.padEnd(20)}`) + `${desc}`);
+        });
+        logger.always(chalk.gray('  e.g.  generate "Describe this" --image ./photo.jpg --pdf ./report.pdf'));
         // Also show the standard help output
         this.initializeCliParser().showHelp("log");
     }
@@ -429,6 +445,11 @@ export class LoopSession {
                 logger.always(chalk.gray(`    Type: ${schema.type}`));
             }
         }
+        // #350: multimodal file inputs are per-command flags, not session variables,
+        // so they don't appear above — point users to them explicitly.
+        logger.always(chalk.gray("\n  Note: file inputs (--image/--pdf/--csv/--video/--file) are per-command\n" +
+            "  flags, not session variables — pass them directly on a generate/stream line,\n" +
+            '  e.g.  generate "Summarize this" --pdf ./report.pdf'));
     }
     /**
      * Get command input with history support using readline

package/dist/cli/utils/inputValidation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI Input Validation Utilities
+ *
+ * Validates multimodal file flags (--image/--csv/--pdf/--video/--file) and
+ * --csv-max-rows before a generate/stream/batch run starts, so bad input
+ * fails fast with a clear message instead of surfacing deep inside provider
+ * calls. Exported as standalone functions (rather than private statics on
+ * CLICommandFactory) so callers — including tests — can import and invoke
+ * them directly, without reaching into the class via an `unknown` cast.
+ */
+/**
+ * Soft (warn-only) size thresholds for CLI multimodal flags. Intentionally
+ * defined here rather than reusing `lib/processors/config/sizeLimits.ts`'s
+ * hard processor caps (e.g. PDF's 100MB hard limit): reusing those names/
+ * values would couple the CLI layer to processor internals across the
+ * CLI/SDK boundary, and would blur the line between a soft "this may be
+ * slow" warning and the actual hard cap the processor enforces.
+ */
+export declare const CLI_SOFT_LIMITS_MB: {
+    readonly IMAGE_MAX_MB: 10;
+    readonly CSV_MAX_MB: 50;
+    readonly PDF_MAX_MB: 100;
+    readonly VIDEO_MAX_MB: 500;
+};
+/**
+ * Validate --image/--csv/--pdf/--video/--file inputs before a CLI run
+ * starts: every local path must exist, must not be a directory, and — for
+ * the flags with a soft limit — triggers a size warning above the
+ * threshold. URLs/data URIs skip both existence and size checks (#319).
+ */
+export declare function validateCliInputFiles(argv: Record<string, unknown>): void;
+/**
+ * #310: validate --csv-max-rows is a positive integer in the range
+ * 1-100000, matching the documented option range (the value previously
+ * flowed through silently, or — above 100000 — only warned instead of
+ * being rejected, contradicting the documented hard range).
+ */
+export declare function validateCsvMaxRows(argv: Record<string, unknown>): void;

package/dist/cli/utils/inputValidation.js

@@ -0,0 +1,143 @@
+/**
+ * CLI Input Validation Utilities
+ *
+ * Validates multimodal file flags (--image/--csv/--pdf/--video/--file) and
+ * --csv-max-rows before a generate/stream/batch run starts, so bad input
+ * fails fast with a clear message instead of surfacing deep inside provider
+ * calls. Exported as standalone functions (rather than private statics on
+ * CLICommandFactory) so callers — including tests — can import and invoke
+ * them directly, without reaching into the class via an `unknown` cast.
+ */
+import fs from "node:fs";
+import chalk from "chalk";
+import { logger } from "../../lib/utils/logger.js";
+import { resolveFilePaths } from "./pathResolver.js";
+/**
+ * Soft (warn-only) size thresholds for CLI multimodal flags. Intentionally
+ * defined here rather than reusing `lib/processors/config/sizeLimits.ts`'s
+ * hard processor caps (e.g. PDF's 100MB hard limit): reusing those names/
+ * values would couple the CLI layer to processor internals across the
+ * CLI/SDK boundary, and would blur the line between a soft "this may be
+ * slow" warning and the actual hard cap the processor enforces.
+ */
+export const CLI_SOFT_LIMITS_MB = {
+    IMAGE_MAX_MB: 10,
+    CSV_MAX_MB: 50,
+    PDF_MAX_MB: 100,
+    VIDEO_MAX_MB: 500,
+};
+function isNonLocalFileReference(filePath) {
+    const lower = filePath.toLowerCase();
+    return (lower.startsWith("http://") ||
+        lower.startsWith("https://") ||
+        lower.startsWith("file://") ||
+        lower.startsWith("data:"));
+}
+/**
+ * Validate --image/--csv/--pdf/--video/--file inputs before a CLI run
+ * starts: every local path must exist, must not be a directory, and — for
+ * the flags with a soft limit — triggers a size warning above the
+ * threshold. URLs/data URIs skip both existence and size checks (#319).
+ */
+export function validateCliInputFiles(argv) {
+    const fileArgs = [
+        {
+            option: "--image",
+            value: argv.image,
+            warnAtMB: CLI_SOFT_LIMITS_MB.IMAGE_MAX_MB,
+        },
+        {
+            option: "--csv",
+            value: argv.csv,
+            warnAtMB: CLI_SOFT_LIMITS_MB.CSV_MAX_MB,
+        },
+        {
+            option: "--pdf",
+            value: argv.pdf,
+            warnAtMB: CLI_SOFT_LIMITS_MB.PDF_MAX_MB,
+        },
+        {
+            option: "--video",
+            value: argv.video,
+            warnAtMB: CLI_SOFT_LIMITS_MB.VIDEO_MAX_MB,
+        },
+        { option: "--file", value: argv.file },
+    ];
+    const missingPaths = [];
+    for (const { option, value, warnAtMB } of fileArgs) {
+        if (!value) {
+            continue;
+        }
+        const rawPaths = Array.isArray(value) ? value : [value];
+        const resolvedPaths = resolveFilePaths(rawPaths);
+        for (let i = 0; i < resolvedPaths.length; i++) {
+            const resolvedPath = resolvedPaths[i];
+            // URLs / data: refs skip both existence and size checks (#319).
+            if (isNonLocalFileReference(resolvedPath)) {
+                continue;
+            }
+            // Single statSync covers existence, directory rejection, and the
+            // size warning below — avoids a second syscall and closes the
+            // TOCTOU gap a separate existsSync()+statSync() pair would leave.
+            let stat;
+            try {
+                stat = fs.statSync(resolvedPath);
+            }
+            catch (err) {
+                // Only ENOENT actually means "not found" — EACCES (permission
+                // denied), ELOOP (symlink loop), ENOTDIR, etc. are real failures
+                // that get masked (and made undebuggable) if we blanket-label
+                // every statSync error the same way.
+                const code = err?.code;
+                if (code === "ENOENT") {
+                    missingPaths.push(`${option} path not found: ${rawPaths[i]} (resolved to ${resolvedPath})`);
+                }
+                else {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    missingPaths.push(`${option} path could not be accessed: ${rawPaths[i]} (resolved to ${resolvedPath}) — ` +
+                        `${code ? `${code}: ` : ""}${reason}`);
+                }
+                continue;
+            }
+            if (stat.isDirectory()) {
+                missingPaths.push(`${option} path is a directory, not a file: ${rawPaths[i]} (resolved to ${resolvedPath})`);
+                continue;
+            }
+            // #319: warn (not error) when a local multimodal file is unusually
+            // large so the user isn't surprised by slow processing / token blowups.
+            if (warnAtMB !== undefined) {
+                const sizeMB = stat.size / (1024 * 1024);
+                if (sizeMB > warnAtMB) {
+                    logger.always(chalk.yellow(`⚠️  ${option} file ${rawPaths[i]} is ${sizeMB.toFixed(1)}MB ` +
+                        `(above the ${warnAtMB}MB soft limit) — processing may be slow ` +
+                        `or exceed provider token/size limits.`));
+                }
+            }
+        }
+    }
+    if (missingPaths.length > 0) {
+        throw new Error("❌ One or more input files are invalid:\n" +
+            `${missingPaths.join("\n")}\n` +
+            "💡 Check the path is correct and relative to your current directory, " +
+            "or pass an absolute path / URL.");
+    }
+}
+/**
+ * #310: validate --csv-max-rows is a positive integer in the range
+ * 1-100000, matching the documented option range (the value previously
+ * flowed through silently, or — above 100000 — only warned instead of
+ * being rejected, contradicting the documented hard range).
+ */
+export function validateCsvMaxRows(argv) {
+    const raw = argv.csvMaxRows;
+    if (raw === undefined) {
+        return;
+    }
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 1 || value > 100000) {
+        throw new Error(`Invalid --csv-max-rows (--csvMaxRows) value: ${String(raw)}. ` +
+            `Must be a positive integer in the range 1-100000. ` +
+            `Example: --csv-max-rows 500`);
+    }
+}
+//# sourceMappingURL=inputValidation.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.94.6",
+  "version": "9.94.7",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {