@defai.digital/ax-cli 4.4.7 → 4.4.11

package/dist/utils/provider-settings.js

@@ -1,450 +0,0 @@
-/**
- * Provider-Aware Settings Manager
- *
- * This module wraps the SettingsManager to provide provider-specific settings
- * when running ax-glm and ax-grok in parallel.
- *
- * Key differences from base SettingsManager:
- * - Uses provider-specific config directories (~/.ax-glm/ vs ~/.ax-grok/)
- * - Supports instance-based configuration (no global singleton)
- * - Integrates with ProviderContext for path resolution
- * - Uses file locking for concurrent access
- *
- * @example
- * ```typescript
- * // Get settings for current provider context
- * const settings = getProviderSettings();
- * const apiKey = settings.getApiKey();
- *
- * // Get settings for specific provider
- * const glmSettings = getProviderSettings('glm');
- * const grokSettings = getProviderSettings('grok');
- * ```
- */
-import { existsSync, mkdirSync, chmodSync } from 'fs';
-import { dirname } from 'path';
-import { z } from 'zod';
-import { ProviderContext, getProviderContext, } from './provider-context.js';
-import { SafeJsonFile, withFileLockSync } from './file-lock.js';
-import { encrypt, decrypt } from './encryption.js';
-import { TIMEOUT_CONFIG } from '../constants.js';
-/**
- * Encrypted value schema for API keys
- */
-const EncryptedValueSchema = z.object({
-    encrypted: z.string(),
-    iv: z.string(),
-    salt: z.string(),
-    tag: z.string(),
-    version: z.number(),
-});
-/**
- * Provider-specific user settings schema
- */
-const ProviderUserSettingsSchema = z.object({
-    // API Configuration
-    apiKey: z.string().optional(),
-    apiKeyEncrypted: EncryptedValueSchema.optional(),
-    baseURL: z.string().optional(),
-    defaultModel: z.string().optional(),
-    models: z.array(z.string()).optional(),
-    // Provider-specific settings
-    temperature: z.number().min(0).max(2).optional(),
-    maxTokens: z.number().positive().optional(),
-    // Grok-specific
-    grok: z.object({
-        thinkingMode: z.enum(['off', 'low', 'high']).optional(),
-        liveSearch: z.boolean().optional(),
-        seed: z.number().optional(),
-    }).optional(),
-    // GLM-specific
-    glm: z.object({
-        thinkingEnabled: z.boolean().optional(),
-    }).optional(),
-    // Common settings
-    thinking: z.object({
-        enabled: z.boolean().optional(),
-    }).optional(),
-    sampling: z.object({
-        doSample: z.boolean().optional(),
-        seed: z.number().optional(),
-        topP: z.number().min(0).max(1).optional(),
-    }).optional(),
-    // Passthrough for other settings
-}).passthrough();
-/**
- * Provider-aware settings manager
- * Unlike the base SettingsManager, this is instance-based to support
- * multiple concurrent provider contexts.
- */
-export class ProviderSettingsManager {
-    static instances = new Map();
-    context;
-    userSettingsCache = null;
-    cacheTimestamp = 0;
-    cacheTTL = TIMEOUT_CONFIG.SETTINGS_CACHE_TTL;
-    constructor(context) {
-        this.context = context;
-    }
-    /**
-     * Get or create a settings manager for a provider context
-     */
-    static forContext(context) {
-        const key = `${context.provider}:${context.userDir}`;
-        let instance = ProviderSettingsManager.instances.get(key);
-        if (!instance) {
-            instance = new ProviderSettingsManager(context);
-            ProviderSettingsManager.instances.set(key, instance);
-        }
-        return instance;
-    }
-    /**
-     * Get settings manager for a specific provider
-     */
-    static forProvider(provider) {
-        const context = ProviderContext.create(provider);
-        return ProviderSettingsManager.forContext(context);
-    }
-    /**
-     * Get settings manager for current context
-     */
-    static current() {
-        return ProviderSettingsManager.forContext(getProviderContext());
-    }
-    /**
-     * Clear all cached instances (for testing)
-     */
-    static clearInstances() {
-        ProviderSettingsManager.instances.clear();
-    }
-    /**
-     * Invalidate cache for this instance
-     */
-    invalidateCache() {
-        this.userSettingsCache = null;
-        this.cacheTimestamp = 0;
-    }
-    /**
-     * Get the config file path for this provider
-     */
-    get configPath() {
-        return this.context.userConfigPath;
-    }
-    /**
-     * Ensure config directory exists with proper permissions
-     */
-    ensureConfigDir() {
-        const dir = dirname(this.configPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true, mode: 0o700 });
-        }
-    }
-    /**
-     * Load user settings with caching and file locking
-     */
-    loadUserSettings() {
-        const now = Date.now();
-        if (this.userSettingsCache && (now - this.cacheTimestamp) < this.cacheTTL) {
-            return this.userSettingsCache;
-        }
-        try {
-            if (!existsSync(this.configPath)) {
-                const defaults = {
-                    baseURL: this.context.config.defaultBaseURL,
-                    defaultModel: this.context.config.defaultModel,
-                };
-                this.saveUserSettings(defaults);
-                this.userSettingsCache = defaults;
-                this.cacheTimestamp = Date.now();
-                return defaults;
-            }
-            // Use file locking for safe concurrent reads
-            const data = SafeJsonFile.readSync(this.configPath, {
-                type: 'read',
-                timeout: 5000,
-            });
-            if (!data) {
-                const defaults = {};
-                this.userSettingsCache = defaults;
-                this.cacheTimestamp = Date.now();
-                return defaults;
-            }
-            // Decrypt API key if encrypted
-            let decryptedApiKey;
-            if (data.apiKeyEncrypted) {
-                try {
-                    decryptedApiKey = decrypt(data.apiKeyEncrypted);
-                }
-                catch {
-                    // Fall back to plain-text
-                    decryptedApiKey = data.apiKey;
-                }
-            }
-            else if (data.apiKey) {
-                decryptedApiKey = data.apiKey;
-                // Migrate to encrypted format
-                this.migrateToEncrypted(data, decryptedApiKey);
-            }
-            const settings = {
-                ...data,
-                apiKey: decryptedApiKey,
-                apiKeyEncrypted: undefined,
-            };
-            this.userSettingsCache = settings;
-            this.cacheTimestamp = Date.now();
-            return settings;
-        }
-        catch (error) {
-            console.warn(`Failed to load ${this.context.provider} settings:`, error);
-            const defaults = {};
-            this.userSettingsCache = defaults;
-            this.cacheTimestamp = Date.now();
-            return defaults;
-        }
-    }
-    /**
-     * Migrate plain-text API key to encrypted format
-     */
-    migrateToEncrypted(data, apiKey) {
-        try {
-            const encrypted = encrypt(apiKey);
-            const migrated = {
-                ...data,
-                apiKeyEncrypted: encrypted,
-                apiKey: undefined,
-            };
-            SafeJsonFile.writeSync(this.configPath, migrated);
-            console.log(`Migrated ${this.context.provider} API key to encrypted format`);
-        }
-        catch {
-            // Ignore migration errors
-        }
-    }
-    /**
-     * Save user settings with file locking
-     * Uses atomic read-modify-write to prevent race conditions
-     */
-    saveUserSettings(settings) {
-        this.ensureConfigDir();
-        try {
-            // Use withFileLockSync to make entire read-modify-write atomic
-            withFileLockSync(this.configPath, () => {
-                // Load existing settings (without lock - we already have it)
-                let existing = {};
-                if (existsSync(this.configPath)) {
-                    try {
-                        const content = require('fs').readFileSync(this.configPath, 'utf-8');
-                        const data = JSON.parse(content);
-                        // Decrypt existing API key
-                        if (data.apiKeyEncrypted) {
-                            try {
-                                data.apiKey = decrypt(data.apiKeyEncrypted);
-                            }
-                            catch {
-                                // Keep as-is
-                            }
-                        }
-                        existing = data;
-                    }
-                    catch {
-                        // Ignore parse errors, start fresh
-                    }
-                }
-                // Merge settings
-                const merged = { ...existing, ...settings };
-                // Encrypt API key before saving
-                const toSave = { ...merged };
-                if (toSave.apiKey) {
-                    toSave.apiKeyEncrypted = encrypt(toSave.apiKey);
-                    delete toSave.apiKey;
-                }
-                // Write atomically
-                const tempPath = `${this.configPath}.tmp.${process.pid}.${Date.now()}`;
-                try {
-                    require('fs').writeFileSync(tempPath, JSON.stringify(toSave, null, 2));
-                    require('fs').renameSync(tempPath, this.configPath);
-                    chmodSync(this.configPath, 0o600);
-                }
-                catch (writeError) {
-                    // Clean up temp file
-                    try {
-                        if (existsSync(tempPath)) {
-                            require('fs').unlinkSync(tempPath);
-                        }
-                    }
-                    catch {
-                        // Ignore cleanup errors
-                    }
-                    throw writeError;
-                }
-                // Update cache
-                this.userSettingsCache = merged;
-                this.cacheTimestamp = Date.now();
-            }, { type: 'write', timeout: 10000, throwOnTimeout: true });
-        }
-        catch (error) {
-            console.error(`Failed to save ${this.context.provider} settings:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Get API key with fallback to environment variable
-     */
-    getApiKey() {
-        // Check provider-specific environment variable first
-        const envKey = this.context.getEnvApiKey();
-        if (envKey)
-            return envKey;
-        // Check generic environment variable
-        const genericKey = process.env.YOUR_API_KEY || process.env.AI_API_KEY;
-        if (genericKey)
-            return genericKey;
-        // Fall back to settings
-        return this.loadUserSettings().apiKey;
-    }
-    /**
-     * Get base URL with fallback
-     * Returns undefined if no valid URL is configured (empty string is treated as unconfigured)
-     */
-    getBaseURL() {
-        const envURL = process.env.AI_BASE_URL;
-        if (envURL && envURL.trim())
-            return envURL;
-        const settings = this.loadUserSettings();
-        const settingsURL = settings.baseURL;
-        if (settingsURL && settingsURL.trim())
-            return settingsURL;
-        const defaultURL = this.context.config.defaultBaseURL;
-        if (defaultURL && defaultURL.trim())
-            return defaultURL;
-        return undefined;
-    }
-    /**
-     * Get current model with fallback
-     * Returns undefined if no valid model is configured (empty string is treated as unconfigured)
-     */
-    getCurrentModel() {
-        const envModel = process.env.AI_MODEL;
-        if (envModel && envModel.trim())
-            return envModel;
-        const settings = this.loadUserSettings();
-        const settingsModel = settings.defaultModel;
-        if (settingsModel && settingsModel.trim())
-            return settingsModel;
-        const defaultModel = this.context.config.defaultModel;
-        if (defaultModel && defaultModel.trim())
-            return defaultModel;
-        return undefined;
-    }
-    /**
-     * Get available models
-     */
-    getAvailableModels() {
-        return this.loadUserSettings().models || [];
-    }
-    /**
-     * Get thinking settings
-     */
-    getThinkingSettings() {
-        const envThink = process.env.AI_THINK;
-        if (envThink !== undefined) {
-            return { enabled: envThink.toLowerCase() === 'true' };
-        }
-        const settings = this.loadUserSettings();
-        if (settings.thinking) {
-            return settings.thinking;
-        }
-        // Provider-specific defaults
-        if (this.context.provider === 'glm' && settings.glm?.thinkingEnabled !== undefined) {
-            return { enabled: settings.glm.thinkingEnabled };
-        }
-        if (this.context.provider === 'grok' && settings.grok?.thinkingMode) {
-            return { enabled: settings.grok.thinkingMode !== 'off' };
-        }
-        return undefined;
-    }
-    /**
-     * Get Grok-specific settings
-     */
-    getGrokSettings() {
-        if (this.context.provider !== 'grok')
-            return undefined;
-        const settings = this.loadUserSettings();
-        return {
-            thinkingMode: settings.grok?.thinkingMode || 'high',
-            liveSearch: settings.grok?.liveSearch ?? true,
-            seed: settings.grok?.seed,
-        };
-    }
-    /**
-     * Get GLM-specific settings
-     */
-    getGLMSettings() {
-        if (this.context.provider !== 'glm')
-            return undefined;
-        const settings = this.loadUserSettings();
-        return {
-            thinkingEnabled: settings.glm?.thinkingEnabled ?? false,
-        };
-    }
-    /**
-     * Check if provider is configured
-     */
-    isConfigured() {
-        const apiKey = this.getApiKey();
-        const baseURL = this.getBaseURL();
-        const model = this.getCurrentModel();
-        return !!(apiKey && baseURL && model);
-    }
-    /**
-     * Update a specific setting
-     */
-    updateSetting(key, value) {
-        this.saveUserSettings({ [key]: value });
-    }
-}
-// ============================================================================
-// Convenience Functions
-// ============================================================================
-/**
- * Get provider settings for current context or specific provider
- */
-export function getProviderSettings(provider) {
-    if (provider) {
-        return ProviderSettingsManager.forProvider(provider);
-    }
-    return ProviderSettingsManager.current();
-}
-/**
- * Check if a provider is configured
- */
-export function isProviderConfigured(provider) {
-    return getProviderSettings(provider).isConfigured();
-}
-/**
- * Get the best available provider (configured with API key)
- */
-export function getBestAvailableProvider() {
-    // Check in order of preference
-    if (isProviderConfigured('glm'))
-        return 'glm';
-    if (isProviderConfigured('grok'))
-        return 'grok';
-    if (isProviderConfigured('generic'))
-        return 'generic';
-    return null;
-}
-/**
- * Get all configured providers
- */
-export function getConfiguredProviders() {
-    const providers = [];
-    if (isProviderConfigured('glm'))
-        providers.push('glm');
-    if (isProviderConfigured('grok'))
-        providers.push('grok');
-    if (isProviderConfigured('generic'))
-        providers.push('generic');
-    return providers;
-}
-//# sourceMappingURL=provider-settings.js.map

package/dist/utils/provider-settings.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -1,222 +0,0 @@
-/**
- * Basic Rate Limiting Utilities (Free Tier) - REQ-SEC-006
- *
- * Implements token bucket algorithm for rate limiting API calls and user actions
- * Prevents API abuse and ensures fair resource usage
- *
- * Free Tier Features:
- * ✅ Token bucket rate limiting
- * ✅ Multi-tier limits (per-second, per-minute)
- * ✅ Per-key limits (per-user, per-IP)
- * ✅ In-memory state (lightweight)
- *
- * Enterprise features (requires @ax-cli/enterprise):
- * - Custom quotas per user/team/project
- * - Cost analytics & forecasting
- * - Budget alerts ($X/day threshold)
- * - Persistent state (survives restarts)
- * - Multi-tenant quota management
- * - Usage optimization tips
- *
- * @module rate-limiter
- * Security: Protects against:
- * - API abuse (excessive requests)
- * - Resource exhaustion
- * - Denial of service (unintentional)
- */
-export interface RateLimitConfig {
-    /**
-     * Maximum number of requests allowed in the window
-     */
-    maxRequests: number;
-    /**
-     * Time window in milliseconds
-     */
-    windowMs: number;
-    /**
-     * Optional: burst allowance (can exceed limit briefly)
-     */
-    burstAllowance?: number;
-}
-export interface RateLimitResult {
-    /**
-     * Whether the request is allowed
-     */
-    allowed: boolean;
-    /**
-     * Tokens remaining in the current window
-     */
-    remaining: number;
-    /**
-     * Time until the rate limit resets (in milliseconds)
-     */
-    resetIn: number;
-    /**
-     * Total limit for this rate limiter
-     */
-    limit: number;
-}
-/**
- * Token Bucket Rate Limiter
- *
- * Uses the token bucket algorithm which allows bursts while maintaining
- * a steady average rate. Tokens are added at a constant rate, and requests
- * consume tokens.
- *
- * @example
- * ```typescript
- * const limiter = new RateLimiter({
- *   maxRequests: 60,
- *   windowMs: 60000, // 60 requests per minute
- * });
- *
- * const result = limiter.tryAcquire();
- * if (result.allowed) {
- *   // Make API call
- * } else {
- *   console.log(`Rate limit exceeded. Try again in ${result.resetIn}ms`);
- * }
- * ```
- */
-export declare class RateLimiter {
-    private tokens;
-    private readonly maxTokens;
-    private readonly refillRate;
-    private lastRefill;
-    private readonly config;
-    constructor(config: RateLimitConfig);
-    /**
-     * Refill tokens based on elapsed time
-     */
-    private refill;
-    /**
-     * Try to acquire a token (allow a request)
-     *
-     * @param cost - Number of tokens to consume (default: 1)
-     * @returns Rate limit result indicating if request is allowed
-     */
-    tryAcquire(cost?: number): RateLimitResult;
-    /**
-     * Get current state without consuming a token
-     */
-    getState(): RateLimitResult;
-    /**
-     * Reset the rate limiter (clear all tokens)
-     */
-    reset(): void;
-}
-/**
- * Multi-tier Rate Limiter
- *
- * Enforces multiple rate limits simultaneously (e.g., per-second, per-minute, per-hour)
- * Request is only allowed if ALL tiers allow it
- *
- * @example
- * ```typescript
- * const limiter = new MultiTierRateLimiter([
- *   { maxRequests: 10, windowMs: 1000 },   // 10/second
- *   { maxRequests: 100, windowMs: 60000 }, // 100/minute
- * ]);
- * ```
- */
-export declare class MultiTierRateLimiter {
-    private limiters;
-    constructor(configs: RateLimitConfig[]);
-    /**
-     * Try to acquire across all tiers
-     * Request is only allowed if ALL tiers allow it
-     */
-    tryAcquire(cost?: number): RateLimitResult;
-    /**
-     * Get current state (most restrictive tier)
-     */
-    getState(): RateLimitResult;
-    /**
-     * Reset all tiers
-     */
-    reset(): void;
-}
-/**
- * Keyed Rate Limiter
- *
- * Maintains separate rate limits for different keys (e.g., per-user, per-IP)
- * Automatically cleans up old entries to prevent memory leaks
- *
- * @example
- * ```typescript
- * const limiter = new KeyedRateLimiter({
- *   maxRequests: 100,
- *   windowMs: 60000,
- * });
- *
- * // Different limits for different users
- * const result = limiter.tryAcquire('user-123');
- * ```
- */
-export declare class KeyedRateLimiter {
-    private limiters;
-    private readonly config;
-    private cleanupTimer;
-    private readonly maxKeys;
-    constructor(config: RateLimitConfig, maxKeys?: number);
-    /**
-     * Get or create a rate limiter for the given key
-     */
-    private getLimiter;
-    /**
-     * Try to acquire for a specific key
-     */
-    tryAcquire(key: string, cost?: number): RateLimitResult;
-    /**
-     * Get state for a specific key
-     */
-    getState(key: string): RateLimitResult;
-    /**
-     * Reset a specific key
-     */
-    reset(key: string): void;
-    /**
-     * Clean up inactive limiters
-     */
-    private cleanup;
-    /**
-     * Dispose of resources
-     */
-    dispose(): void;
-}
-/**
- * Default rate limit configurations for common use cases
- */
-export declare const DEFAULT_RATE_LIMITS: {
-    /**
-     * API calls - 60 requests per minute
-     */
-    readonly API: {
-        readonly maxRequests: 60;
-        readonly windowMs: number;
-        readonly burstAllowance: 10;
-    };
-    /**
-     * LLM API calls - 20 requests per minute (more expensive)
-     */
-    readonly LLM_API: {
-        readonly maxRequests: 20;
-        readonly windowMs: number;
-        readonly burstAllowance: 5;
-    };
-    /**
-     * User actions - 100 requests per minute
-     */
-    readonly USER_ACTIONS: {
-        readonly maxRequests: 100;
-        readonly windowMs: number;
-        readonly burstAllowance: 20;
-    };
-    /**
-     * File operations - 50 per minute
-     */
-    readonly FILE_OPS: {
-        readonly maxRequests: 50;
-        readonly windowMs: number;
-    };
-};