@juspay/neurolink 9.1.1 → 9.3.0

package/dist/cli/factories/commandFactory.js

@@ -1,27 +1,27 @@
-import path from "node:path";
 import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import ora from "ora";
+import { ModelResolver } from "../../lib/models/modelResolver.js";
 import { globalSession } from "../../lib/session/globalSessionState.js";
-import { configManager } from "../commands/config.js";
-import { handleError } from "../errorHandler.js";
+// Use TokenUsage from standard types - no local interface needed
+import { ContextFactory, } from "../../lib/types/contextTypes.js";
+import { checkRedisAvailability } from "../../lib/utils/conversationMemoryUtils.js";
 import { normalizeEvaluationData } from "../../lib/utils/evaluationUtils.js";
+import { logger } from "../../lib/utils/logger.js";
 import { createThinkingConfigFromRecord } from "../../lib/utils/thinkingConfig.js";
+import { configManager } from "../commands/config.js";
+import { MCPCommandFactory } from "../commands/mcp.js";
+import { ModelsCommandFactory } from "../commands/models.js";
+import { handleSetup } from "../commands/setup.js";
+import { handleError } from "../errorHandler.js";
 import { LoopSession } from "../loop/session.js";
 import { initializeCliParser } from "../parser.js";
+import { formatFileSize, saveAudioToFile } from "../utils/audioFileUtils.js";
 import { resolveFilePaths } from "../utils/pathResolver.js";
-// Use TokenUsage from standard types - no local interface needed
-import { ContextFactory, } from "../../lib/types/contextTypes.js";
-import { ModelsCommandFactory } from "../commands/models.js";
-import { MCPCommandFactory } from "../commands/mcp.js";
+import { formatVideoFileSize, getVideoMetadataSummary, saveVideoToFile, } from "../utils/videoFileUtils.js";
 import { OllamaCommandFactory } from "./ollamaCommandFactory.js";
 import { SageMakerCommandFactory } from "./sagemakerCommandFactory.js";
-import { ModelResolver } from "../../lib/models/modelResolver.js";
-import ora from "ora";
-import chalk from "chalk";
-import { logger } from "../../lib/utils/logger.js";
-import { handleSetup } from "../commands/setup.js";
-import { checkRedisAvailability } from "../../lib/utils/conversationMemoryUtils.js";
-import { saveAudioToFile, formatFileSize } from "../utils/audioFileUtils.js";
-import { saveVideoToFile, formatVideoFileSize, getVideoMetadataSummary, } from "../utils/videoFileUtils.js";
 /**
  * CLI Command Factory for generate commands
  */
@@ -324,11 +324,53 @@ export class CLICommandFactory {
             description: "Vertex AI region (e.g., us-central1, europe-west1, asia-northeast1)",
             alias: "r",
         },
+        // RAG options
+        ragFiles: {
+            type: "array",
+            description: "File paths to load for RAG (Retrieval-Augmented Generation). AI will search these documents to answer your question.",
+            alias: "rag-files",
+            string: true,
+        },
+        ragStrategy: {
+            type: "string",
+            description: "Chunking strategy for RAG documents (auto-detected from file extension if not specified)",
+            alias: "rag-strategy",
+            choices: [
+                "character",
+                "recursive",
+                "sentence",
+                "token",
+                "markdown",
+                "html",
+                "json",
+                "latex",
+                "semantic",
+                "semantic-markdown",
+            ],
+        },
+        ragChunkSize: {
+            type: "number",
+            description: "Maximum chunk size in characters for RAG documents",
+            alias: "rag-chunk-size",
+            default: 1000,
+        },
+        ragChunkOverlap: {
+            type: "number",
+            description: "Overlap between adjacent chunks for RAG documents",
+            alias: "rag-chunk-overlap",
+            default: 200,
+        },
+        ragTopK: {
+            type: "number",
+            description: "Number of top results to retrieve for RAG",
+            alias: "rag-top-k",
+            default: 5,
+        },
     };
     // Helper method to build options for commands
     static buildOptions(yargs, additionalOptions = {}) {
         return yargs.options({
-            ...this.commonOptions,
+            ...CLICommandFactory.commonOptions,
             ...additionalOptions,
         });
     }
@@ -538,7 +580,8 @@ export class CLICommandFactory {
                 }
                 // Add analytics display for text mode when enabled
                 if (options.enableAnalytics && generateResult.analytics) {
-                    output += this.formatAnalyticsForTextMode(generateResult);
+                    output +=
+                        CLICommandFactory.formatAnalyticsForTextMode(generateResult);
                 }
             }
             else if (result && typeof result === "object" && "text" in result) {
@@ -710,7 +753,7 @@ export class CLICommandFactory {
     }
     // Helper method to normalize token usage data to standard format
     static normalizeTokenUsage(tokens) {
-        if (!this.isValidTokenUsage(tokens)) {
+        if (!CLICommandFactory.isValidTokenUsage(tokens)) {
             return null;
         }
         const tokensObj = tokens;
@@ -754,7 +797,7 @@ export class CLICommandFactory {
         }
         analyticsText += "\n";
         // Token usage with fallback handling
-        const normalizedTokens = this.normalizeTokenUsage(analytics.tokenUsage);
+        const normalizedTokens = CLICommandFactory.normalizeTokenUsage(analytics.tokenUsage);
         if (normalizedTokens) {
             analyticsText += `   Tokens: ${normalizedTokens.input} input + ${normalizedTokens.output} output = ${normalizedTokens.total} total\n`;
         }
@@ -796,7 +839,7 @@ export class CLICommandFactory {
             command: ["generate <input>", "gen <input>"],
             describe: "Generate content using AI providers",
             builder: (yargs) => {
-                return this.buildOptions(yargs
+                return CLICommandFactory.buildOptions(yargs
                     .positional("input", {
                     type: "string",
                     description: "Text prompt for AI generation (or read from stdin)",
@@ -812,7 +855,7 @@ export class CLICommandFactory {
                     .example('$0 generate "Product showcase video" --image ./product.jpg --outputMode video --videoOutput ./output.mp4', "Generate video from image")
                     .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"));
             },
-            handler: async (argv) => await this.executeGenerate(argv),
+            handler: async (argv) => await CLICommandFactory.executeGenerate(argv),
         };
     }
     /**
@@ -823,7 +866,7 @@ export class CLICommandFactory {
             command: "stream <input>",
             describe: "Stream generation in real-time",
             builder: (yargs) => {
-                return this.buildOptions(yargs
+                return CLICommandFactory.buildOptions(yargs
                     .positional("input", {
                     type: "string",
                     description: "Text prompt for streaming (or read from stdin)",
@@ -834,7 +877,7 @@ export class CLICommandFactory {
                     .example('echo "Live demo" | $0 stream', "Stream from stdin")
                     .example('$0 stream "Narrate this video" --video path/to/video.mp4', "Stream video analysis"));
             },
-            handler: async (argv) => await this.executeStream(argv),
+            handler: async (argv) => await CLICommandFactory.executeStream(argv),
         };
     }
     /**
@@ -845,7 +888,7 @@ export class CLICommandFactory {
             command: "batch <file>",
             describe: "Process multiple prompts from a file",
             builder: (yargs) => {
-                return this.buildOptions(yargs
+                return CLICommandFactory.buildOptions(yargs
                     .positional("file", {
                     type: "string",
                     description: "File with prompts (one per line)",
@@ -856,7 +899,7 @@ export class CLICommandFactory {
                     .example("$0 batch tasks.txt -p vertex --delay 2000", "Use Vertex AI with 2s delay")
                     .example("$0 batch batch.txt --output results.json", "Save results to file"));
             },
-            handler: async (argv) => await this.executeBatch(argv),
+            handler: async (argv) => await CLICommandFactory.executeBatch(argv),
         };
     }
     /**
@@ -868,7 +911,7 @@ export class CLICommandFactory {
             describe: "Manage AI provider configurations and status",
             builder: (yargs) => {
                 return yargs
-                    .command("status", "Check status of all configured AI providers", (y) => this.buildOptions(y)
+                    .command("status", "Check status of all configured AI providers", (y) => CLICommandFactory.buildOptions(y)
                     .example("$0 provider status", "Check all provider status")
                     .example("$0 provider status --verbose", "Detailed provider diagnostics")
                     .example("$0 provider status --quiet", "Minimal status output"), (argv) => CLICommandFactory.executeProviderStatus(argv))
@@ -884,7 +927,7 @@ export class CLICommandFactory {
         return {
             command: "status",
             describe: "Check AI provider connectivity and performance (alias for provider status)",
-            builder: (yargs) => this.buildOptions(yargs)
+            builder: (yargs) => CLICommandFactory.buildOptions(yargs)
                 .example("$0 status", "Quick provider status check")
                 .example("$0 status --verbose", "Detailed connectivity diagnostics")
                 .example("$0 status --format json", "Export status as JSON"),
@@ -918,25 +961,25 @@ export class CLICommandFactory {
             describe: "Manage conversation memory",
             builder: (yargs) => {
                 return yargs
-                    .command("stats", "Show conversation memory statistics", (y) => this.buildOptions(y)
+                    .command("stats", "Show conversation memory statistics", (y) => CLICommandFactory.buildOptions(y)
                     .example("$0 memory stats", "Show memory usage statistics")
-                    .example("$0 memory stats --format json", "Export stats as JSON"), async (argv) => await this.executeMemoryStats(argv))
-                    .command("history <sessionId>", "Show conversation history for a session", (y) => this.buildOptions(y)
+                    .example("$0 memory stats --format json", "Export stats as JSON"), async (argv) => await CLICommandFactory.executeMemoryStats(argv))
+                    .command("history <sessionId>", "Show conversation history for a session", (y) => CLICommandFactory.buildOptions(y)
                     .positional("sessionId", {
                     type: "string",
                     description: "Session ID to retrieve history for",
                     demandOption: true,
                 })
                     .example("$0 memory history session-123", "Show conversation history")
-                    .example("$0 memory history session-123 --format json", "Export history as JSON"), async (argv) => await this.executeMemoryHistory(argv))
-                    .command("clear [sessionId]", "Clear conversation history", (y) => this.buildOptions(y)
+                    .example("$0 memory history session-123 --format json", "Export history as JSON"), async (argv) => await CLICommandFactory.executeMemoryHistory(argv))
+                    .command("clear [sessionId]", "Clear conversation history", (y) => CLICommandFactory.buildOptions(y)
                     .positional("sessionId", {
                     type: "string",
                     description: "Session ID to clear (omit to clear all sessions)",
                     demandOption: false,
                 })
                     .example("$0 memory clear", "Clear all conversation history")
-                    .example("$0 memory clear session-123", "Clear specific session"), async (argv) => await this.executeMemoryClear(argv))
+                    .example("$0 memory clear session-123", "Clear specific session"), async (argv) => await CLICommandFactory.executeMemoryClear(argv))
                     .demandCommand(1, "Please specify a memory subcommand");
             },
             handler: () => { }, // No-op handler as subcommands handle everything
@@ -951,13 +994,13 @@ export class CLICommandFactory {
             describe: "Manage NeuroLink configuration",
             builder: (yargs) => {
                 return yargs
-                    .command("init", "Interactive configuration setup wizard", (y) => this.buildOptions(y), async (_argv) => {
+                    .command("init", "Interactive configuration setup wizard", (y) => CLICommandFactory.buildOptions(y), async (_argv) => {
                     await configManager.initInteractive();
                 })
-                    .command("show", "Display current configuration", (y) => this.buildOptions(y), async (_argv) => {
+                    .command("show", "Display current configuration", (y) => CLICommandFactory.buildOptions(y), async (_argv) => {
                     configManager.showConfig();
                 })
-                    .command("validate", "Validate current configuration", (y) => this.buildOptions(y), async (_argv) => {
+                    .command("validate", "Validate current configuration", (y) => CLICommandFactory.buildOptions(y), async (_argv) => {
                     const result = configManager.validateConfig();
                     if (result.valid) {
                         logger.always(chalk.green("✅ Configuration is valid"));
@@ -967,10 +1010,10 @@ export class CLICommandFactory {
                         handleError(new Error(`Configuration has errors:\n  • ${errorMessages}`), "Configuration validation");
                     }
                 })
-                    .command("reset", "Reset configuration to defaults", (y) => this.buildOptions(y), async (_argv) => {
+                    .command("reset", "Reset configuration to defaults", (y) => CLICommandFactory.buildOptions(y), async (_argv) => {
                     configManager.resetConfig();
                 })
-                    .command("export", "Export current configuration", (y) => this.buildOptions(y), (argv) => this.executeConfigExport(argv))
+                    .command("export", "Export current configuration", (y) => CLICommandFactory.buildOptions(y), (argv) => CLICommandFactory.executeConfigExport(argv))
                     .demandCommand(1, "");
             },
             handler: () => { }, // No-op handler as subcommands handle everything
@@ -983,7 +1026,7 @@ export class CLICommandFactory {
         return {
             command: "validate",
             describe: "Validate current configuration (alias for 'config validate')",
-            builder: (yargs) => this.buildOptions(yargs),
+            builder: (yargs) => CLICommandFactory.buildOptions(yargs),
             handler: async (_argv) => {
                 const result = configManager.validateConfig();
                 if (result.valid) {
@@ -1003,11 +1046,11 @@ export class CLICommandFactory {
         return {
             command: "get-best-provider",
             describe: "Show the best available AI provider",
-            builder: (yargs) => this.buildOptions(yargs)
+            builder: (yargs) => CLICommandFactory.buildOptions(yargs)
                 .example("$0 get-best-provider", "Get best available provider")
                 .example("$0 get-best-provider --format json", "Get provider as JSON")
                 .example("$0 get-best-provider --quiet", "Just the provider name"),
-            handler: async (argv) => await this.executeGetBestProvider(argv),
+            handler: async (argv) => await CLICommandFactory.executeGetBestProvider(argv),
         };
     }
     /**
@@ -1024,7 +1067,7 @@ export class CLICommandFactory {
             command: ["setup [provider]", "s [provider]"],
             describe: "Interactive AI provider setup wizard",
             builder: (yargs) => {
-                return this.buildOptions(yargs
+                return CLICommandFactory.buildOptions(yargs
                     .positional("provider", {
                     type: "string",
                     description: "Specific provider to set up",
@@ -1073,7 +1116,7 @@ export class CLICommandFactory {
         return {
             command: "loop",
             describe: "Start an interactive loop session with conversation management",
-            builder: (yargs) => this.buildOptions(yargs, {
+            builder: (yargs) => CLICommandFactory.buildOptions(yargs, {
                 "enable-conversation-memory": {
                     type: "boolean",
                     description: "Enable conversation memory for the loop session",
@@ -1200,12 +1243,12 @@ export class CLICommandFactory {
         return {
             command: "completion",
             describe: "Generate shell completion script",
-            builder: (yargs) => this.buildOptions(yargs)
+            builder: (yargs) => CLICommandFactory.buildOptions(yargs)
                 .example("$0 completion", "Generate shell completion")
                 .example("$0 completion > ~/.neurolink-completion.sh", "Save completion script")
                 .example("source ~/.neurolink-completion.sh", "Enable completions (bash)")
                 .epilogue("Add the completion script to your shell profile for persistent completions"),
-            handler: async (argv) => await this.executeCompletion(argv),
+            handler: async (argv) => await CLICommandFactory.executeCompletion(argv),
         };
     }
     /**
@@ -1333,7 +1376,7 @@ export class CLICommandFactory {
         else if (!argv.input) {
             throw new Error('Input required. Use: neurolink generate "your prompt" or echo "prompt" | neurolink generate');
         }
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         // Determine if video generation mode is enabled
         const isVideoMode = options.outputMode === "video";
         const spinnerMessage = isVideoMode
@@ -1405,7 +1448,7 @@ export class CLICommandFactory {
                 if (spinner) {
                     spinner.succeed(chalk.green("✅ Dry-run completed successfully!"));
                 }
-                this.handleOutput(mockResult, options);
+                CLICommandFactory.handleOutput(mockResult, options);
                 if (options.debug) {
                     logger.debug("\n" + chalk.yellow("Debug Information (Dry-run):"));
                     logger.debug("Provider:", mockResult.provider);
@@ -1413,7 +1456,7 @@ export class CLICommandFactory {
                     logger.debug("Mode: DRY-RUN (no actual API calls made)");
                 }
                 if (!globalSession.getCurrentSessionId()) {
-                    await this.flushLangfuseTraces();
+                    await CLICommandFactory.flushLangfuseTraces();
                     process.exit(0);
                 }
             }
@@ -1432,7 +1475,7 @@ export class CLICommandFactory {
             }
             // Video generation doesn't support tools, so auto-disable them
             if (isVideoMode) {
-                this.configureVideoMode(enhancedOptions, argv, options);
+                CLICommandFactory.configureVideoMode(enhancedOptions, argv, options);
             }
             // Process CLI multimodal inputs
             const imageBuffers = CLICommandFactory.processCliImages(argv.image);
@@ -1495,6 +1538,16 @@ export class CLICommandFactory {
                         validateDomainData: true,
                     }
                     : undefined,
+                // RAG configuration
+                rag: argv.ragFiles?.length
+                    ? {
+                        files: argv.ragFiles,
+                        strategy: argv.ragStrategy,
+                        chunkSize: argv.ragChunkSize,
+                        chunkOverlap: argv.ragChunkOverlap,
+                        topK: argv.ragTopK,
+                    }
+                    : undefined,
             });
             if (spinner) {
                 if (isVideoMode) {
@@ -1512,12 +1565,12 @@ export class CLICommandFactory {
             }
             // Handle output with universal formatting (for text mode)
             if (!isVideoMode) {
-                this.handleOutput(result, options);
+                CLICommandFactory.handleOutput(result, options);
             }
             // Handle TTS audio file output if --tts-output is provided
-            await this.handleTTSOutput(result, options);
+            await CLICommandFactory.handleTTSOutput(result, options);
             // Handle video file output if --videoOutput is provided
-            await this.handleVideoOutput(result, options);
+            await CLICommandFactory.handleVideoOutput(result, options);
             if (options.debug) {
                 logger.debug("\n" + chalk.yellow("Debug Information:"));
                 logger.debug("Provider:", result.provider);
@@ -1530,7 +1583,7 @@ export class CLICommandFactory {
                 }
             }
             if (!globalSession.getCurrentSessionId()) {
-                await this.flushLangfuseTraces();
+                await CLICommandFactory.flushLangfuseTraces();
                 process.exit(0);
             }
         }
@@ -1615,7 +1668,7 @@ export class CLICommandFactory {
                 model: mockAnalytics.model,
                 toolsUsed: [],
             };
-            const analyticsDisplay = this.formatAnalyticsForTextMode(mockGenerateResult);
+            const analyticsDisplay = CLICommandFactory.formatAnalyticsForTextMode(mockGenerateResult);
             logger.always(analyticsDisplay);
         }
         if (options.enableEvaluation) {
@@ -1639,7 +1692,7 @@ export class CLICommandFactory {
             logger.debug("Mode: DRY-RUN (no actual API calls made)");
         }
         if (!globalSession.getCurrentSessionId()) {
-            await this.flushLangfuseTraces();
+            await CLICommandFactory.flushLangfuseTraces();
             process.exit(0);
         }
     }
@@ -1702,9 +1755,19 @@ export class CLICommandFactory {
                     validateDomainData: true,
                 }
                 : undefined,
+            // RAG configuration
+            rag: argv.ragFiles?.length
+                ? {
+                    files: argv.ragFiles,
+                    strategy: argv.ragStrategy,
+                    chunkSize: argv.ragChunkSize,
+                    chunkOverlap: argv.ragChunkOverlap,
+                    topK: argv.ragTopK,
+                }
+                : undefined,
         });
-        const fullContent = await this.processStreamWithTimeout(stream, options);
-        await this.displayStreamResults(stream, fullContent, options);
+        const fullContent = await CLICommandFactory.processStreamWithTimeout(stream, options);
+        await CLICommandFactory.displayStreamResults(stream, fullContent, options);
         return fullContent;
     }
     /**
@@ -1822,7 +1885,7 @@ export class CLICommandFactory {
                 model: stream.model,
                 toolsUsed: stream.toolCalls?.map((tc) => tc.toolName) || [],
             };
-            const analyticsDisplay = this.formatAnalyticsForTextMode(streamAnalytics);
+            const analyticsDisplay = CLICommandFactory.formatAnalyticsForTextMode(streamAnalytics);
             logger.always(analyticsDisplay);
         }
         // Display evaluation after streaming
@@ -1864,7 +1927,7 @@ export class CLICommandFactory {
         }
         // Debug output for streaming
         if (options.debug) {
-            await this.logStreamDebugInfo({
+            await CLICommandFactory.logStreamDebugInfo({
                 provider: options.provider,
                 model: options.model,
             });
@@ -1916,8 +1979,8 @@ export class CLICommandFactory {
      * Execute the stream command
      */
     static async executeStream(argv) {
-        await this.handleStdinInput(argv);
-        const options = this.processOptions(argv);
+        await CLICommandFactory.handleStdinInput(argv);
+        const options = CLICommandFactory.processOptions(argv);
         if (!options.quiet) {
             logger.always(chalk.blue("🔄 Streaming..."));
         }
@@ -1926,16 +1989,16 @@ export class CLICommandFactory {
             if (options.delay) {
                 await new Promise((resolve) => setTimeout(resolve, options.delay));
             }
-            const { inputText, contextMetadata } = await this.processStreamContext(argv, options);
+            const { inputText, contextMetadata } = await CLICommandFactory.processStreamContext(argv, options);
             // Handle dry-run mode for testing
             if (options.dryRun) {
-                await this.executeDryRunStream(options, contextMetadata);
+                await CLICommandFactory.executeDryRunStream(options, contextMetadata);
                 return;
             }
-            const fullContent = await this.executeRealStream(argv, options, inputText, contextMetadata);
-            await this.handleStreamOutput(options, fullContent);
+            const fullContent = await CLICommandFactory.executeRealStream(argv, options, inputText, contextMetadata);
+            await CLICommandFactory.handleStreamOutput(options, fullContent);
             if (!globalSession.getCurrentSessionId()) {
-                await this.flushLangfuseTraces();
+                await CLICommandFactory.flushLangfuseTraces();
                 process.exit(0);
             }
         }
@@ -1947,7 +2010,7 @@ export class CLICommandFactory {
      * Execute the batch command
      */
     static async executeBatch(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         const spinner = options.quiet ? null : ora().start();
         try {
             if (!argv.file) {
@@ -2055,9 +2118,9 @@ export class CLICommandFactory {
                 spinner.succeed(chalk.green("✅ Batch processing complete!"));
             }
             // Handle output with universal formatting
-            this.handleOutput(results, options);
+            CLICommandFactory.handleOutput(results, options);
             if (!globalSession.getCurrentSessionId()) {
-                await this.flushLangfuseTraces();
+                await CLICommandFactory.flushLangfuseTraces();
                 process.exit(0);
             }
         }
@@ -2072,7 +2135,7 @@ export class CLICommandFactory {
      * Execute config export command
      */
     static async executeConfigExport(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         try {
             const config = {
                 providers: {
@@ -2091,7 +2154,7 @@ export class CLICommandFactory {
                 },
                 timestamp: new Date().toISOString(),
             };
-            this.handleOutput(config, options);
+            CLICommandFactory.handleOutput(config, options);
         }
         catch (error) {
             handleError(error, "Configuration export");
@@ -2101,19 +2164,19 @@ export class CLICommandFactory {
      * Execute get best provider command
      */
     static async executeGetBestProvider(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         try {
             const { getBestProvider } = await import("../../lib/utils/providerUtils.js");
             const bestProvider = await getBestProvider();
             if (options.format === "json") {
-                this.handleOutput({ provider: bestProvider }, options);
+                CLICommandFactory.handleOutput({ provider: bestProvider }, options);
             }
             else {
                 if (!options.quiet) {
                     logger.always(chalk.green(`🎯 Best available provider: ${bestProvider}`));
                 }
                 else {
-                    this.handleOutput(bestProvider, options);
+                    CLICommandFactory.handleOutput(bestProvider, options);
                 }
             }
         }
@@ -2125,7 +2188,7 @@ export class CLICommandFactory {
      * Execute memory stats command
      */
     static async executeMemoryStats(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         const spinner = options.quiet
             ? null
             : ora("🧠 Getting memory stats...").start();
@@ -2141,7 +2204,7 @@ export class CLICommandFactory {
                 if (spinner) {
                     spinner.succeed(chalk.green("✅ Memory stats retrieved (dry-run)"));
                 }
-                this.handleOutput(mockStats, options);
+                CLICommandFactory.handleOutput(mockStats, options);
                 return;
             }
             const stats = await sdk.getConversationStats();
@@ -2149,7 +2212,7 @@ export class CLICommandFactory {
                 spinner.succeed(chalk.green("✅ Memory stats retrieved"));
             }
             if (options.format === "json") {
-                this.handleOutput(stats, options);
+                CLICommandFactory.handleOutput(stats, options);
             }
             else {
                 logger.always(chalk.blue("📊 Conversation Memory Stats:"));
@@ -2175,7 +2238,7 @@ export class CLICommandFactory {
      * Execute memory history command
      */
     static async executeMemoryHistory(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         const spinner = options.quiet
             ? null
             : ora(`🧠 Getting history for ${argv.sessionId}...`).start();
@@ -2198,7 +2261,7 @@ export class CLICommandFactory {
                 if (spinner) {
                     spinner.succeed(chalk.green(`✅ History retrieved for ${argv.sessionId} (dry-run)`));
                 }
-                this.handleOutput(mockHistory, options);
+                CLICommandFactory.handleOutput(mockHistory, options);
                 return;
             }
             const history = await sdk.getConversationHistory(argv.sessionId);
@@ -2210,7 +2273,7 @@ export class CLICommandFactory {
                 return;
             }
             if (options.format === "json") {
-                this.handleOutput(history, options);
+                CLICommandFactory.handleOutput(history, options);
             }
             else {
                 logger.always(chalk.blue(`💬 Conversation History (${argv.sessionId}):`));
@@ -2238,7 +2301,7 @@ export class CLICommandFactory {
      * Execute memory clear command
      */
     static async executeMemoryClear(argv) {
-        const options = this.processOptions(argv);
+        const options = CLICommandFactory.processOptions(argv);
         const isAllSessions = !argv.sessionId;
         const target = isAllSessions ? "all sessions" : `session ${argv.sessionId}`;
         const spinner = options.quiet
@@ -2257,7 +2320,7 @@ export class CLICommandFactory {
                     sessionId: argv.sessionId || null,
                     message: `${isAllSessions ? "All sessions" : "Session"} would be cleared`,
                 };
-                this.handleOutput(result, options);
+                CLICommandFactory.handleOutput(result, options);
                 return;
             }
             let success;
@@ -2286,7 +2349,7 @@ export class CLICommandFactory {
                     action: isAllSessions ? "clear_all" : "clear_session",
                     sessionId: argv.sessionId || null,
                 };
-                this.handleOutput(result, options);
+                CLICommandFactory.handleOutput(result, options);
             }
             else if (!success && !isAllSessions) {
                 logger.always(chalk.yellow(`⚠️ Session ${argv.sessionId} not found or already empty`));

package/dist/cli/parser.js

@@ -9,6 +9,7 @@ import { logger } from "../lib/utils/logger.js";
 import { SetupCommandFactory } from "./factories/setupCommandFactory.js";
 import { ServerCommandFactory } from "./commands/server.js";
 import { ServeCommandFactory } from "./commands/serve.js";
+import { ragCommand } from "./commands/rag.js";
 // Enhanced CLI with Professional UX
 export function initializeCliParser() {
     return (yargs(hideBin(process.argv))
@@ -163,6 +164,8 @@ export function initializeCliParser() {
         // Server Command Group - Using ServerCommandFactory
         .command(ServerCommandFactory.createServerCommands())
         // Serve Command - Simplified server start - Using ServeCommandFactory
-        .command(ServeCommandFactory.createServeCommands())); // Close the main return statement
+        .command(ServeCommandFactory.createServeCommands())
+        // RAG Document Processing Commands
+        .command(ragCommand)); // Close the main return statement
 }
 //# sourceMappingURL=parser.js.map