@windagency/valora 2.0.1

package/dist/config/interactive-wizard.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Interactive setup wizard - orchestrates the configuration setup process
+ */
+import type { ConfigLoader } from './loader.js';
+import { type Config } from './schema.js';
+export declare class SetupWizard {
+    private configLoader;
+    constructor(configLoader: ConfigLoader);
+    /**
+     * Run the interactive setup wizard
+     */
+    run(): Promise<Config>;
+    /**
+     * Select default provider based on configured providers
+     */
+    private selectDefaultProvider;
+    /**
+     * Quick setup with minimal prompts
+     */
+    quickSetup(): Promise<Config>;
+    /**
+     * Configure a specific provider (used for mismatch resolution)
+     */
+    configureSpecificProvider(providerName: string): Promise<void>;
+    /**
+     * Get provider choice and API key from environment variables or prompt user
+     */
+    private getProviderFromEnvOrPrompt;
+    /**
+     * Check environment variables for provider configuration
+     */
+    private checkEnvForProvider;
+    /**
+     * Prompt user for provider selection and API key
+     */
+    private promptForProvider;
+    /**
+     * Check if setup is needed
+     * Respects non-interactive mode and Cursor provider availability
+     */
+    static needsSetup(configLoader: ConfigLoader, forceInteractive?: boolean): Promise<boolean>;
+    /**
+     * Check if MCP is enabled
+     */
+    private static isMCPEnabled;
+    /**
+     * Check if in non-interactive mode
+     */
+    private static checkNonInteractiveMode;
+    /**
+     * Handle missing config file
+     */
+    private static handleMissingConfig;
+    /**
+     * Check existing config for setup requirements
+     */
+    private static checkExistingConfig;
+    /**
+     * Check if providers object has at least one valid provider
+     */
+    private static hasValidProvider;
+    /**
+     * Check if API key is valid
+     */
+    private static isValidApiKey;
+}
+//# sourceMappingURL=interactive-wizard.d.ts.map

package/dist/config/interactive-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-wizard.d.ts","sourceRoot":"","sources":["../../src/config/interactive-wizard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,UAAU,CAAC;AAWvD,qBAAa,WAAW;IACvB,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,YAAY;IAItC;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAgF5B;;OAEG;YACW,qBAAqB;IAiCnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAwCnC;;OAEG;IACG,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpE;;OAEG;YACW,0BAA0B;IAmBxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;YACW,iBAAiB;IAqC/B;;;OAGG;WACU,UAAU,CAAC,YAAY,EAAE,YAAY,EAAE,gBAAgB,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAStC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC;;OAEG;mBACkB,mBAAmB;IA0BxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAG5B"}

package/dist/config/interactive-wizard.js

@@ -0,0 +1,325 @@
+/**
+ * Interactive setup wizard - orchestrates the configuration setup process
+ */
+import { getColorAdapter } from '../output/color-adapter.interface.js';
+import { getPromptAdapter } from '../ui/prompt-adapter.interface.js';
+import { isPromptCancellation } from '../utils/prompt-handler.js';
+import { getProviderMetadata, ProviderName } from './providers.config.js';
+import { DEFAULT_CONFIG } from './schema.js';
+import { configureDefaults, configureProvider, filterValidProviders, PROVIDER_CHOICES, QUICK_SETUP_CHOICES } from './validation-helpers.js';
+const prompt = getPromptAdapter();
+export class SetupWizard {
+    configLoader;
+    constructor(configLoader) {
+        this.configLoader = configLoader;
+    }
+    /**
+     * Run the interactive setup wizard
+     */
+    async run() {
+        const color = getColorAdapter();
+        console.group(color.colorModifier('blue', 'bold', '\n🤖 VALORA - Setup Wizard'));
+        console.info(color.gray('This wizard will help you configure API keys for LLM providers and set default preferences.'));
+        // Check if running in Cursor/MCP context
+        if (process.env['AI_MCP_ENABLED'] === 'true') {
+            console.info(`${color.yellow('💡 TIP: You can use the Cursor Provider (no API keys needed!')}
+${color.gray('   When using tools in Cursor, they automatically use your subscription.')}
+${color.gray('   API keys are optional - only needed for CLI or specific providers.')}`);
+        }
+        console.groupEnd();
+        console.log();
+        const config = {
+            defaults: { ...DEFAULT_CONFIG.defaults },
+            paths: { ...DEFAULT_CONFIG.paths },
+            providers: {}
+        };
+        try {
+            // Ask which providers to configure
+            const { providers } = await prompt.prompt([
+                {
+                    choices: PROVIDER_CHOICES,
+                    message: 'Which LLM providers would you like to configure?',
+                    name: 'providers',
+                    type: 'checkbox'
+                }
+            ]);
+            // Filter out the skip option
+            const validProviders = filterValidProviders(providers);
+            // Configure each selected provider
+            if (validProviders.length === 0) {
+                console.info(`${color.cyan('\n✨ No API keys configured - Using Cursor Provider only')}
+${color.gray('   You can add API keys later with: valora config setup')}`);
+            }
+            else {
+                // Configure providers sequentially (required for interactive prompts)
+                await validProviders.reduce(async (previousPromise, provider) => {
+                    await previousPromise;
+                    return configureProvider(provider, config);
+                }, Promise.resolve());
+            }
+            // Set default provider
+            config.defaults.default_provider = await this.selectDefaultProvider(validProviders, color);
+            // Configure defaults
+            await configureDefaults(config);
+            // Save configuration
+            await this.configLoader.save(config);
+            console.group();
+            console.info(`${color.colorModifier('green', 'bold', '✅ Configuration saved successfully!')}
+${color.gray(`Config file: ${this.configLoader.getConfigPath()}`)}`);
+            console.groupEnd();
+            console.log();
+            return config;
+        }
+        catch (error) {
+            // Propagate prompt cancellations
+            if (isPromptCancellation(error)) {
+                throw error;
+            }
+            // Rethrow other errors
+            throw error;
+        }
+    }
+    /**
+     * Select default provider based on configured providers
+     */
+    async selectDefaultProvider(validProviders, color) {
+        // No providers configured, default to Cursor
+        if (validProviders.length === 0) {
+            return ProviderName.CURSOR;
+        }
+        // Single provider - use it automatically
+        if (validProviders.length === 1) {
+            const provider = validProviders[0];
+            const providerLabel = getProviderMetadata(provider)?.label ?? provider;
+            console.info(color.cyan(`\n✓ Set ${providerLabel} as default provider`));
+            return provider;
+        }
+        // Multiple providers - prompt user to choose
+        const { defaultProvider } = await prompt.prompt([
+            {
+                choices: validProviders.map((provider) => ({
+                    name: getProviderMetadata(provider)?.label ?? provider,
+                    value: provider
+                })),
+                message: 'Which provider would you like to use as default?',
+                name: 'defaultProvider',
+                type: 'list'
+            }
+        ]);
+        return defaultProvider;
+    }
+    /**
+     * Quick setup with minimal prompts
+     */
+    async quickSetup() {
+        const color = getColorAdapter();
+        console.group(color.colorModifier('blue', 'bold', '\n🤖 VALORA - Quick Setup'));
+        console.groupEnd();
+        try {
+            const { apiKey, providerChoice } = await this.getProviderFromEnvOrPrompt(color);
+            const config = {
+                ...DEFAULT_CONFIG,
+                defaults: {
+                    ...DEFAULT_CONFIG.defaults,
+                    default_provider: providerChoice
+                },
+                providers: apiKey
+                    ? {
+                        [providerChoice]: {
+                            apiKey: apiKey
+                        }
+                    }
+                    : {}
+            };
+            await this.configLoader.save(config);
+            console.group();
+            console.info(`${color.colorModifier('green', 'bold', '✅ Quick setup complete!')}
+${color.gray(`You can run 'valora config setup' for more options.`)}`);
+            console.groupEnd();
+            console.log();
+            return config;
+        }
+        catch (error) {
+            if (isPromptCancellation(error)) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Configure a specific provider (used for mismatch resolution)
+     */
+    async configureSpecificProvider(providerName) {
+        const color = getColorAdapter();
+        const config = await this.configLoader.load();
+        console.group(color.cyan(`\n📦 Configuring ${providerName}`));
+        try {
+            await configureProvider(providerName, config);
+            // If this is the only provider or no default is set, make it the default
+            if (!config.defaults.default_provider) {
+                config.defaults.default_provider = providerName;
+                console.info(color.cyan(`✓ Set ${providerName} as default provider`));
+            }
+            await this.configLoader.save(config);
+            console.info(color.green('✅ Configuration saved'));
+            console.groupEnd();
+        }
+        catch (error) {
+            console.groupEnd();
+            // Propagate prompt cancellations
+            if (isPromptCancellation(error)) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get provider choice and API key from environment variables or prompt user
+     */
+    async getProviderFromEnvOrPrompt(color) {
+        // Check for environment variables first
+        const envProvider = this.checkEnvForProvider();
+        if (envProvider) {
+            return envProvider;
+        }
+        // Check if non-interactive mode without API keys
+        if (process.env['AI_INTERACTIVE'] === 'false' || process.env['CI']) {
+            console.info(color.cyan('✨ No API keys found - Using Cursor Provider (non-interactive mode)'));
+            return { apiKey: '', providerChoice: ProviderName.CURSOR };
+        }
+        // Interactive mode - prompt user
+        return this.promptForProvider(color);
+    }
+    /**
+     * Check environment variables for provider configuration
+     */
+    checkEnvForProvider() {
+        const envMapping = {
+            [ProviderName.ANTHROPIC]: process.env['AI_ANTHROPIC_API_KEY'],
+            [ProviderName.GOOGLE]: process.env['AI_GOOGLE_API_KEY'],
+            [ProviderName.OPENAI]: process.env['AI_OPENAI_API_KEY']
+        };
+        for (const [provider, apiKey] of Object.entries(envMapping)) {
+            if (apiKey) {
+                return { apiKey, providerChoice: provider };
+            }
+        }
+        return null;
+    }
+    /**
+     * Prompt user for provider selection and API key
+     */
+    async promptForProvider(color) {
+        const providerAnswer = await prompt.prompt([
+            {
+                choices: QUICK_SETUP_CHOICES,
+                default: ProviderName.CURSOR,
+                message: 'Which LLM provider would you like to use?',
+                name: 'providerChoice',
+                type: 'list'
+            }
+        ]);
+        const providerChoice = providerAnswer['providerChoice'];
+        // Cursor provider doesn't need API key
+        if (providerChoice === ProviderName.CURSOR) {
+            console.info(`${color.cyan('✨ Using Cursor Provider (no API key needed)')}
+${color.gray('   Available when running in Cursor IDE.')}`);
+            return { apiKey: '', providerChoice };
+        }
+        // Prompt for API key
+        const apiKeyAnswer = await prompt.prompt([
+            {
+                message: 'Enter your API key:',
+                name: 'apiKey',
+                type: 'password',
+                validate: (input) => typeof input === 'string' && input.trim().length > 0 ? true : 'API key is required'
+            }
+        ]);
+        const keyValue = apiKeyAnswer['apiKey'];
+        const apiKey = typeof keyValue === 'string' ? keyValue.trim() : '';
+        return { apiKey, providerChoice };
+    }
+    /**
+     * Check if setup is needed
+     * Respects non-interactive mode and Cursor provider availability
+     */
+    static async needsSetup(configLoader, forceInteractive = false) {
+        if (this.isMCPEnabled()) {
+            return false;
+        }
+        const isNonInteractive = this.checkNonInteractiveMode(forceInteractive);
+        if (!configLoader.exists()) {
+            return this.handleMissingConfig(isNonInteractive);
+        }
+        return this.checkExistingConfig(configLoader, isNonInteractive);
+    }
+    /**
+     * Check if MCP is enabled
+     */
+    static isMCPEnabled() {
+        return process.env['AI_MCP_ENABLED'] === 'true';
+    }
+    /**
+     * Check if in non-interactive mode
+     */
+    static checkNonInteractiveMode(forceInteractive) {
+        return (process.env['AI_INTERACTIVE'] === 'false' ||
+            process.env['CI'] === 'true' ||
+            process.env['NODE_ENV'] === 'test' ||
+            forceInteractive === false);
+    }
+    /**
+     * Handle missing config file
+     */
+    static handleMissingConfig(isNonInteractive) {
+        return !isNonInteractive;
+    }
+    /**
+     * Check existing config for setup requirements
+     */
+    static async checkExistingConfig(configLoader, isNonInteractive) {
+        try {
+            const config = await configLoader.load();
+            if (config.defaults?.default_provider) {
+                return false; // Setup already complete
+            }
+            if (!config.providers || typeof config.providers !== 'object') {
+                return !isNonInteractive; // Only need setup if interactive
+            }
+            const hasConfiguredProvider = this.hasValidProvider(config.providers);
+            if (hasConfiguredProvider) {
+                return false;
+            }
+            // If no providers configured but we're non-interactive, that's OK (Cursor provider can be used)
+            return !isNonInteractive;
+        }
+        catch {
+            // If config loading fails and we're non-interactive, assume setup isn't needed
+            return !isNonInteractive;
+        }
+    }
+    /**
+     * Check if providers object has at least one valid provider
+     */
+    static hasValidProvider(providers) {
+        return Object.keys(providers).some((key) => {
+            const providerConfig = providers[key];
+            const providerMetadata = getProviderMetadata(key);
+            if (!providerMetadata) {
+                return false; // Unknown provider
+            }
+            if (providerMetadata.requiresApiKey) {
+                return this.isValidApiKey(providerConfig?.apiKey);
+            }
+            // For providers that don't require API keys (like Cursor), just having the provider configured is enough
+            return true;
+        });
+    }
+    /**
+     * Check if API key is valid
+     */
+    static isValidApiKey(apiKey) {
+        return Boolean(apiKey && typeof apiKey === 'string' && apiKey.trim().length > 0);
+    }
+}
+//# sourceMappingURL=interactive-wizard.js.map

package/dist/config/interactive-wizard.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Configuration loader - loads config from file and environment variables
+ */
+import { type Config } from './schema.js';
+export declare class ConfigLoader {
+    private config;
+    private configPath;
+    constructor(configPath?: string);
+    /**
+     * Load configuration with multi-level cascade:
+     * 1. Package defaults (data/config.default.json)
+     * 2. Global user preferences (~/.valora/config.json)
+     * 3. Project-specific settings (.valora/config.json)
+     * 4. Environment variables (VALORA_* with AI_* alias)
+     * 5. CLI flags
+     */
+    load(cliOverrides?: Partial<Config>): Promise<Config>;
+    /**
+     * Load package default config from the configured path
+     */
+    private loadPackageConfig;
+    /**
+     * Load global user config (~/.valora/config.json)
+     */
+    private loadGlobalConfig;
+    /**
+     * Load project config (.valora/config.json)
+     */
+    private loadProjectConfig;
+    /**
+     * Auto-migrate: set default_provider if missing but providers exist
+     */
+    private autoMigrateDefaultProvider;
+    /**
+     * Load configuration from environment variables
+     */
+    private loadFromEnv;
+    /**
+     * Load provider configurations from environment variables
+     */
+    private loadProvidersFromEnv;
+    /**
+     * Load defaults configuration from environment variables.
+     * Supports both VALORA_* and AI_* prefixes (VALORA_* takes precedence).
+     */
+    private loadDefaultsFromEnv;
+    /**
+     * Load logging configuration from environment variables
+     */
+    private loadLoggingFromEnv;
+    /**
+     * Load sessions configuration from environment variables
+     */
+    private loadSessionsFromEnv;
+    /**
+     * Load feature flags from environment variables
+     */
+    private loadFeaturesFromEnv;
+    /**
+     * Merge multiple config objects
+     */
+    private mergeConfigs;
+    /**
+     * Merge a single config into the result
+     */
+    private mergeSingleConfig;
+    /**
+     * Merge feature flags
+     */
+    private mergeFeatures;
+    /**
+     * Check if any of the environment variables exist
+     */
+    private hasAnyEnvVar;
+    /**
+     * Apply environment variable mapping to a config section
+     */
+    private applyEnvMapping;
+    /**
+     * Save configuration to file
+     */
+    save(config: Config): Promise<void>;
+    /**
+     * Get current configuration
+     */
+    get(): Config;
+    /**
+     * Check if configuration file exists
+     */
+    exists(): boolean;
+    /**
+     * Get configuration file path
+     */
+    getConfigPath(): string;
+    /**
+     * Load configuration from a specific file path
+     */
+    loadFromPath(filePath: string): Promise<Config>;
+    /**
+     * Reload configuration
+     */
+    reload(): Promise<Config>;
+}
+export declare function getConfigLoader(configPath?: string): ConfigLoader;
+/**
+ * Set global CLI overrides that will be applied to all configuration loading
+ */
+export declare function setGlobalCliOverrides(overrides: Partial<Config>): void;
+/**
+ * Get current global CLI overrides
+ */
+export declare function getGlobalCliOverrides(): null | Partial<Config>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,OAAO,EAAE,KAAK,MAAM,EAAiC,MAAM,UAAU,CAAC;AAWtE,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAQ/B;;;;;;;OAOG;IACG,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAgC3D;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAalC;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC;;OAEG;IACH,GAAG,IAAI,MAAM;IAOb;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBrD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAI/B;AAQD,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAGjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9D"}