@juspay/neurolink 7.33.4 → 7.35.0

package/dist/cli/factories/setupCommandFactory.js

@@ -0,0 +1,137 @@
+/**
+ * Setup Command Factory for NeuroLink
+ * Consolidates all provider setup commands into a unified interface
+ */
+import { handleGCPSetup } from "../commands/setup-gcp.js";
+import { handleBedrockSetup } from "../commands/setup-bedrock.js";
+import { handleOpenAISetup } from "../commands/setup-openai.js";
+import { handleGoogleAISetup } from "../commands/setup-google-ai.js";
+import { handleAnthropicSetup } from "../commands/setup-anthropic.js";
+import { handleAzureSetup } from "../commands/setup-azure.js";
+import { handleHuggingFaceSetup } from "../commands/setup-huggingface.js";
+import { handleMistralSetup } from "../commands/setup-mistral.js";
+import { handleSetup } from "../commands/setup.js";
+/**
+ * Setup Command Factory
+ */
+export class SetupCommandFactory {
+    /**
+     * Create the main setup command with all provider subcommands
+     */
+    static createSetupCommands() {
+        return {
+            command: ["setup [provider]", "s [provider]"],
+            describe: "Setup AI provider configurations",
+            builder: (yargs) => {
+                return (yargs
+                    .positional("provider", {
+                    type: "string",
+                    description: "Specific provider to set up",
+                    choices: [
+                        "google-ai",
+                        "openai",
+                        "anthropic",
+                        "azure",
+                        "bedrock",
+                        "gcp",
+                        "vertex",
+                        "huggingface",
+                        "mistral",
+                    ],
+                })
+                    .option("list", {
+                    type: "boolean",
+                    description: "List all available providers",
+                    alias: "l",
+                })
+                    .option("status", {
+                    type: "boolean",
+                    description: "Show provider configuration status",
+                })
+                    .option("check", {
+                    type: "boolean",
+                    description: "Only check existing configuration without prompting",
+                    default: false,
+                })
+                    .option("non-interactive", {
+                    type: "boolean",
+                    description: "Skip interactive prompts",
+                    default: false,
+                })
+                    .option("quiet", {
+                    type: "boolean",
+                    alias: "q",
+                    default: false,
+                    description: "Suppress non-essential output",
+                })
+                    .option("debug", {
+                    type: "boolean",
+                    default: false,
+                    description: "Enable debug output",
+                })
+                    // Subcommands for each provider
+                    .command("google-ai", "Setup Google AI Studio configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleGoogleAISetup(argv))
+                    .command("openai", "Setup OpenAI configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleOpenAISetup(argv))
+                    .command("anthropic", "Setup Anthropic Claude configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleAnthropicSetup(argv))
+                    .command("azure", "Setup Azure OpenAI configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleAzureSetup(argv))
+                    .command("bedrock", "Setup AWS Bedrock configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleBedrockSetup(argv))
+                    .command(["gcp", "vertex"], "Setup Google Cloud Platform / Vertex AI configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleGCPSetup(argv))
+                    .command("huggingface", "Setup Hugging Face configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleHuggingFaceSetup(argv))
+                    .command("mistral", "Setup Mistral AI configuration", (y) => this.buildProviderOptions(y), 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                async (argv) => await handleMistralSetup(argv))
+                    .example("$0 setup", "Interactive setup wizard")
+                    .example("$0 setup google-ai", "Setup Google AI Studio")
+                    .example("$0 setup openai --check", "Check OpenAI configuration")
+                    .example("$0 setup --list", "List all providers")
+                    .example("$0 setup --status", "Check provider status")
+                    .help());
+            },
+            handler: async (argv) => {
+                // If no subcommand specified, run main setup wizard
+                await handleSetup(argv);
+            },
+        };
+    }
+    /**
+     * Build common options for provider setup commands
+     */
+    static buildProviderOptions(yargs) {
+        return yargs
+            .option("check", {
+            type: "boolean",
+            describe: "Only check existing configuration without prompting",
+            default: false,
+        })
+            .option("non-interactive", {
+            type: "boolean",
+            describe: "Skip interactive prompts",
+            default: false,
+        })
+            .option("quiet", {
+            type: "boolean",
+            alias: "q",
+            default: false,
+            description: "Suppress non-essential output",
+        })
+            .option("debug", {
+            type: "boolean",
+            default: false,
+            description: "Enable debug output",
+        });
+    }
+}

package/dist/cli/index.d.ts

@@ -5,4 +5,4 @@
  * Professional CLI experience with minimal maintenance overhead.
  * Features: Spinners, colors, batch processing, provider testing, rich help
  */
-export declare function handleError(_error: Error, context: string): void;
+export {};

package/dist/cli/index.js

@@ -5,15 +5,8 @@
  * Professional CLI experience with minimal maintenance overhead.
  * Features: Spinners, colors, batch processing, provider testing, rich help
  */
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
+import { initializeCliParser } from "./parser.js";
 import chalk from "chalk";
-import _fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import { CLICommandFactory } from "./factories/commandFactory.js";
-import { AuthenticationError, AuthorizationError, NetworkError, RateLimitError, } from "../lib/types/errors.js";
-import { logger } from "../lib/utils/logger.js";
 // Clean up pnpm-specific environment variables that cause npm warnings
 // These variables are set by pnpm but cause "Unknown env config" warnings in npm
 if (process.env.npm_config_verify_deps_before_run) {
@@ -22,11 +15,6 @@ if (process.env.npm_config_verify_deps_before_run) {
 if (process.env.npm_config__jsr_registry) {
     delete process.env.npm_config__jsr_registry;
 }
-// Get version from package.json
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const packageJson = JSON.parse(_fs.readFileSync(path.resolve(__dirname, "../../package.json"), "utf-8"));
-const cliVersion = packageJson.version;
 // Load environment variables from .env file
 try {
     // Try to import and configure dotenv
@@ -37,158 +25,8 @@ catch {
     // dotenv is not available (dev dependency only) - this is fine for production
     // Environment variables should be set externally in production
 }
-// Utility Functions (Simple, Zero Maintenance)
-export function handleError(_error, context) {
-    logger.error(chalk.red(`❌ ${context} failed: ${_error.message}`));
-    if (_error instanceof AuthenticationError) {
-        logger.error(chalk.yellow("💡 Set Google AI Studio API key (RECOMMENDED): export GOOGLE_AI_API_KEY=AIza-..."));
-        logger.error(chalk.yellow("💡 Or set OpenAI API key: export OPENAI_API_KEY=sk-..."));
-        logger.error(chalk.yellow("💡 Or set AWS Bedrock credentials: export AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_REGION=us-east-1"));
-        logger.error(chalk.yellow("💡 Or set Google Vertex AI credentials: export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json"));
-        logger.error(chalk.yellow("💡 Or set Anthropic API key: export ANTHROPIC_API_KEY=sk-ant-..."));
-        logger.error(chalk.yellow("💡 Or set Azure OpenAI credentials: export AZURE_OPENAI_API_KEY=... AZURE_OPENAI_ENDPOINT=..."));
-    }
-    else if (_error instanceof RateLimitError) {
-        logger.error(chalk.yellow("💡 Try again in a few moments or use --provider vertex"));
-    }
-    else if (_error instanceof AuthorizationError) {
-        logger.error(chalk.yellow("💡 Check your account permissions for the selected model/service."));
-        logger.error(chalk.yellow("💡 For AWS Bedrock, ensure you have permissions for the specific model and consider using inference profile ARNs."));
-    }
-    else if (_error instanceof NetworkError) {
-        logger.error(chalk.yellow("💡 Check your internet connection and the provider's status page."));
-    }
-    process.exit(1);
-}
-// Manual pre-validation for unknown flags
-const args = hideBin(process.argv);
 // Enhanced CLI with Professional UX
-const cli = yargs(args)
-    .scriptName("neurolink")
-    .usage("Usage: $0 <command> [options]")
-    .version(cliVersion)
-    .help()
-    .alias("h", "help")
-    .alias("V", "version")
-    .strictOptions()
-    .strictCommands()
-    .demandCommand(1, "")
-    .epilogue("For more info: https://github.com/juspay/neurolink")
-    .showHelpOnFail(true, "Specify --help for available options")
-    .middleware((argv) => {
-    // Handle no-color option globally
-    if (argv.noColor || process.env.NO_COLOR || !process.stdout.isTTY) {
-        process.env.FORCE_COLOR = "0";
-    }
-    // Handle custom config file
-    if (argv.configFile) {
-        process.env.NEUROLINK_CONFIG_FILE = argv.configFile;
-    }
-    // Control SDK logging based on debug flag
-    if (argv.debug) {
-        process.env.NEUROLINK_DEBUG = "true";
-    }
-    else {
-        // Always set to false when debug is not enabled (including when not provided)
-        process.env.NEUROLINK_DEBUG = "false";
-    }
-    // Keep existing quiet middleware
-    if (process.env.NEUROLINK_QUIET === "true" &&
-        typeof argv.quiet === "undefined") {
-        argv.quiet = true;
-    }
-})
-    .fail((msg, err, yargsInstance) => {
-    const exitProcess = () => {
-        if (!process.exitCode) {
-            process.exit(1);
-        }
-    };
-    if (err) {
-        // Error likely from an async command handler (e.g., via _handleError)
-        // _handleError already prints and calls process.exit(1).
-        // If we're here, it means _handleError's process.exit might not have been caught by the top-level async IIFE.
-        // Or, it's a synchronous yargs error during parsing that yargs itself throws.
-        const alreadyExitedByHandleError = err?.exitCode !== undefined;
-        // A simple heuristic: if the error message doesn't look like one of our handled generic messages,
-        // it might be a direct yargs parsing error.
-        const isLikelyYargsInternalError = err.message && // Ensure err.message exists
-            !err.message.includes("Authentication error") &&
-            !err.message.includes("Network error") &&
-            !err.message.includes("Authorization error") &&
-            !err.message.includes("Permission denied") && // from config export
-            !err.message.includes("Invalid or unparseable JSON"); // from config import
-        if (!alreadyExitedByHandleError) {
-            process.stderr.write(chalk.red(`CLI Error: ${err.message || msg || "An unexpected error occurred."}\n`));
-            // If it's a yargs internal parsing error, show help.
-            if (isLikelyYargsInternalError && msg) {
-                yargsInstance.showHelp((h) => {
-                    process.stderr.write(h + "\n");
-                    exitProcess();
-                });
-                return;
-            }
-            exitProcess();
-        }
-        return; // Exit was already called or error handled
-    }
-    // Yargs parsing/validation error (msg is present, err is null)
-    if (msg) {
-        let processedMsg = `Error: ${msg}\n`;
-        if (msg.includes("Not enough non-option arguments") ||
-            msg.includes("Missing required argument") ||
-            msg.includes("Unknown command")) {
-            process.stderr.write(chalk.red(processedMsg)); // Print error first
-            yargsInstance.showHelp((h) => {
-                process.stderr.write("\n" + h + "\n");
-                exitProcess();
-            });
-            return; // Exit happens in callback
-        }
-        else if (msg.includes("Unknown argument") ||
-            msg.includes("Invalid values")) {
-            processedMsg = `Error: ${msg}\nUse --help to see available options.\n`;
-        }
-        process.stderr.write(chalk.red(processedMsg));
-    }
-    else {
-        // No specific message, but failure occurred (e.g. demandCommand failed silently)
-        yargsInstance.showHelp((h) => {
-            process.stderr.write(h + "\n");
-            exitProcess();
-        });
-        return; // Exit happens in callback
-    }
-    exitProcess(); // Default exit
-})
-    // Generate Command (Primary) - Using CLICommandFactory
-    .command(CLICommandFactory.createGenerateCommand())
-    // Stream Text Command - Using CLICommandFactory
-    .command(CLICommandFactory.createStreamCommand())
-    // Batch Processing Command - Using CLICommandFactory
-    .command(CLICommandFactory.createBatchCommand())
-    // Provider Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createProviderCommands())
-    // Status command alias - Using CLICommandFactory
-    .command(CLICommandFactory.createStatusCommand())
-    // Models Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createModelsCommands())
-    // MCP Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createMCPCommands())
-    // Discover Command - Using CLICommandFactory
-    .command(CLICommandFactory.createDiscoverCommand())
-    // Configuration Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createConfigCommands())
-    // Get Best Provider Command - Using CLICommandFactory
-    .command(CLICommandFactory.createBestProviderCommand())
-    // Validate Command (alias for config validate)
-    .command(CLICommandFactory.createValidateCommand())
-    // Completion Command - Using CLICommandFactory
-    .command(CLICommandFactory.createCompletionCommand())
-    // Ollama Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createOllamaCommands())
-    // SageMaker Command Group - Using CLICommandFactory
-    .command(CLICommandFactory.createSageMakerCommands());
+const cli = initializeCliParser();
 // Execute CLI
 (async () => {
     try {
@@ -201,3 +39,10 @@ const cli = yargs(args)
         process.exit(1);
     }
 })();
+// Cleanup on exit
+process.on("SIGINT", () => {
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    process.exit(0);
+});

package/dist/cli/loop/optionsSchema.d.ts

@@ -0,0 +1,15 @@
+import { type TextGenerationOptions } from "../../lib/core/types.js";
+/**
+ * Defines the schema for a session variable or a generation option.
+ */
+export interface OptionSchema {
+    type: "string" | "boolean" | "number";
+    description: string;
+    allowedValues?: string[];
+}
+/**
+ * Master schema for all text generation options.
+ * This object provides metadata for validation and help text in the CLI loop.
+ * It is derived from the main TextGenerationOptions interface to ensure consistency.
+ */
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria">, OptionSchema>;

package/dist/cli/loop/optionsSchema.js

@@ -0,0 +1,59 @@
+import { AIProviderName, } from "../../lib/core/types.js";
+/**
+ * Master schema for all text generation options.
+ * This object provides metadata for validation and help text in the CLI loop.
+ * It is derived from the main TextGenerationOptions interface to ensure consistency.
+ */
+export const textGenerationOptionsSchema = {
+    provider: {
+        type: "string",
+        description: "The AI provider to use.",
+        allowedValues: Object.values(AIProviderName)
+            .filter((p) => typeof p === "string")
+            .filter((p) => p !== AIProviderName.AUTO),
+    },
+    model: {
+        type: "string",
+        description: "The specific model to use from the provider.",
+    },
+    temperature: {
+        type: "number",
+        description: "Controls randomness of the output (e.g., 0.2, 0.8).",
+    },
+    maxTokens: {
+        type: "number",
+        description: "The maximum number of tokens to generate.",
+    },
+    systemPrompt: {
+        type: "string",
+        description: "The system prompt to guide the AI's behavior.",
+    },
+    timeout: {
+        type: "number",
+        description: "Timeout for the generation request in milliseconds.",
+    },
+    disableTools: {
+        type: "boolean",
+        description: "Disable all tool usage for the AI.",
+    },
+    maxSteps: {
+        type: "number",
+        description: "Maximum number of tool execution steps.",
+    },
+    enableAnalytics: {
+        type: "boolean",
+        description: "Enable or disable analytics for responses.",
+    },
+    enableEvaluation: {
+        type: "boolean",
+        description: "Enable or disable AI-powered evaluation of responses.",
+    },
+    evaluationDomain: {
+        type: "string",
+        description: 'Domain expertise for evaluation (e.g., "general AI assistant").',
+    },
+    toolUsageContext: {
+        type: "string",
+        description: "Context about tools/MCPs used in the interaction.",
+    },
+};

package/dist/cli/loop/session.d.ts

@@ -0,0 +1,15 @@
+import type { Argv } from "yargs";
+import type { ConversationMemoryConfig } from "../../lib/types/conversation.js";
+export declare class LoopSession {
+    private conversationMemoryConfig?;
+    private initializeCliParser;
+    private isRunning;
+    private sessionId?;
+    private sessionVariablesSchema;
+    constructor(initializeCliParser: () => Argv, conversationMemoryConfig?: ConversationMemoryConfig | undefined);
+    start(): Promise<void>;
+    private handleSessionCommands;
+    private parseValue;
+    private showHelp;
+    private showSetHelp;
+}