@defai.digital/ax-cli 4.1.11 → 4.1.15

package/dist/utils/provider-file-cache.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Provider-Aware File Cache
+ *
+ * This module extends FileCache to support provider-specific cache isolation.
+ * When running ax-glm and ax-grok in parallel, each has its own cache directory:
+ * - ~/.ax-glm/cache/
+ * - ~/.ax-grok/cache/
+ *
+ * Benefits:
+ * - No cache collisions between providers
+ * - Independent cache eviction per provider
+ * - Clear cache separation for debugging
+ *
+ * @example
+ * ```typescript
+ * // Get cache for current provider context
+ * const cache = await getProviderFileCache<AnalysisResult>('analysis');
+ *
+ * // Get cache for specific provider
+ * const glmCache = await getProviderFileCache<AnalysisResult>('analysis', 'glm');
+ * const grokCache = await getProviderFileCache<AnalysisResult>('analysis', 'grok');
+ * ```
+ */
+import { FileCache } from './file-cache.js';
+import { ProviderType } from './provider-context.js';
+/**
+ * Provider-aware file cache configuration
+ */
+export interface ProviderFileCacheConfig {
+    /** Entry time-to-live in milliseconds (default: 7 days) */
+    ttl?: number;
+    /** Max cache entries (default: 10000) */
+    maxEntries?: number;
+    /** Max cache size in bytes (default: 100MB) */
+    maxSize?: number;
+    /** Enable git-based change detection (default: true) */
+    useGit?: boolean;
+    /** Tool version for cache invalidation */
+    toolVersion?: string;
+}
+/**
+ * Get or create a provider-aware file cache
+ *
+ * @param namespace - Cache namespace (e.g., 'analysis', 'dependency', 'security')
+ * @param provider - Provider type (default: current context)
+ * @param config - Cache configuration
+ * @returns Initialized file cache
+ */
+export declare function getProviderFileCache<T = unknown>(namespace: string, provider?: ProviderType, config?: ProviderFileCacheConfig): Promise<FileCache<T>>;
+/**
+ * Get provider-aware file cache synchronously (without init)
+ *
+ * Use this when you need immediate access and will call init() later
+ */
+export declare function getProviderFileCacheSync<T = unknown>(namespace: string, provider?: ProviderType, config?: ProviderFileCacheConfig): FileCache<T>;
+/**
+ * Save all provider cache instances
+ */
+export declare function saveAllProviderCaches(): Promise<void>;
+/**
+ * Clear cache for a specific provider
+ */
+export declare function clearProviderCache(provider: ProviderType): Promise<void>;
+/**
+ * Clear all provider caches
+ */
+export declare function clearAllProviderCaches(): Promise<void>;
+/**
+ * Get cache statistics for a provider
+ */
+export declare function getProviderCacheStats(provider: ProviderType): {
+    namespaces: string[];
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+};
+/**
+ * Get cache statistics for all providers
+ */
+export declare function getAllProviderCacheStats(): Map<ProviderType, {
+    namespaces: string[];
+    totalEntries: number;
+    totalHits: number;
+    totalMisses: number;
+    hitRate: number;
+}>;
+/**
+ * Reset all provider cache instances (for testing)
+ */
+export declare function resetProviderCaches(): void;

package/dist/utils/provider-file-cache.js

@@ -0,0 +1,165 @@
+/**
+ * Provider-Aware File Cache
+ *
+ * This module extends FileCache to support provider-specific cache isolation.
+ * When running ax-glm and ax-grok in parallel, each has its own cache directory:
+ * - ~/.ax-glm/cache/
+ * - ~/.ax-grok/cache/
+ *
+ * Benefits:
+ * - No cache collisions between providers
+ * - Independent cache eviction per provider
+ * - Clear cache separation for debugging
+ *
+ * @example
+ * ```typescript
+ * // Get cache for current provider context
+ * const cache = await getProviderFileCache<AnalysisResult>('analysis');
+ *
+ * // Get cache for specific provider
+ * const glmCache = await getProviderFileCache<AnalysisResult>('analysis', 'glm');
+ * const grokCache = await getProviderFileCache<AnalysisResult>('analysis', 'grok');
+ * ```
+ */
+import { createFileCache } from './file-cache.js';
+import { ProviderContext, getProviderContext, } from './provider-context.js';
+/**
+ * Cache instances keyed by provider:namespace
+ */
+const providerCacheInstances = new Map();
+/**
+ * Get or create a provider-aware file cache
+ *
+ * @param namespace - Cache namespace (e.g., 'analysis', 'dependency', 'security')
+ * @param provider - Provider type (default: current context)
+ * @param config - Cache configuration
+ * @returns Initialized file cache
+ */
+export async function getProviderFileCache(namespace, provider, config) {
+    // Get provider context
+    const ctx = provider
+        ? ProviderContext.create(provider)
+        : getProviderContext();
+    // Create unique key for this provider:namespace combination
+    const key = `${ctx.provider}:${namespace}`;
+    // Return existing instance if available
+    if (providerCacheInstances.has(key)) {
+        const cache = providerCacheInstances.get(key);
+        await cache.init();
+        return cache;
+    }
+    // Create new cache with provider-specific directory
+    const cache = createFileCache({
+        cacheDir: ctx.userCacheDir,
+        namespace: ctx.getCacheNamespace(namespace),
+        ttl: config?.ttl,
+        maxEntries: config?.maxEntries,
+        maxSize: config?.maxSize,
+        useGit: config?.useGit,
+        toolVersion: config?.toolVersion,
+    });
+    // Initialize and store
+    await cache.init();
+    providerCacheInstances.set(key, cache);
+    return cache;
+}
+/**
+ * Get provider-aware file cache synchronously (without init)
+ *
+ * Use this when you need immediate access and will call init() later
+ */
+export function getProviderFileCacheSync(namespace, provider, config) {
+    const ctx = provider
+        ? ProviderContext.create(provider)
+        : getProviderContext();
+    const key = `${ctx.provider}:${namespace}`;
+    if (providerCacheInstances.has(key)) {
+        return providerCacheInstances.get(key);
+    }
+    const cache = createFileCache({
+        cacheDir: ctx.userCacheDir,
+        namespace: ctx.getCacheNamespace(namespace),
+        ttl: config?.ttl,
+        maxEntries: config?.maxEntries,
+        maxSize: config?.maxSize,
+        useGit: config?.useGit,
+        toolVersion: config?.toolVersion,
+    });
+    providerCacheInstances.set(key, cache);
+    return cache;
+}
+/**
+ * Save all provider cache instances
+ */
+export async function saveAllProviderCaches() {
+    await Promise.all(Array.from(providerCacheInstances.values()).map((cache) => cache.save()));
+}
+/**
+ * Clear cache for a specific provider
+ */
+export async function clearProviderCache(provider) {
+    const keysToDelete = [];
+    for (const [key, cache] of providerCacheInstances.entries()) {
+        if (key.startsWith(`${provider}:`)) {
+            await cache.clear();
+            keysToDelete.push(key);
+        }
+    }
+    keysToDelete.forEach((key) => providerCacheInstances.delete(key));
+}
+/**
+ * Clear all provider caches
+ */
+export async function clearAllProviderCaches() {
+    await Promise.all(Array.from(providerCacheInstances.values()).map((cache) => cache.clear()));
+    providerCacheInstances.clear();
+}
+/**
+ * Get cache statistics for a provider
+ */
+export function getProviderCacheStats(provider) {
+    const namespaces = [];
+    let totalEntries = 0;
+    let totalHits = 0;
+    let totalMisses = 0;
+    for (const [key, cache] of providerCacheInstances.entries()) {
+        if (key.startsWith(`${provider}:`)) {
+            const namespace = key.substring(provider.length + 1);
+            namespaces.push(namespace);
+            const stats = cache.getStats();
+            totalEntries += stats.totalEntries;
+            totalHits += stats.hits;
+            totalMisses += stats.misses;
+        }
+    }
+    const totalRequests = totalHits + totalMisses;
+    const hitRate = totalRequests > 0 ? totalHits / totalRequests : 0;
+    return {
+        namespaces,
+        totalEntries,
+        totalHits,
+        totalMisses,
+        hitRate,
+    };
+}
+/**
+ * Get cache statistics for all providers
+ */
+export function getAllProviderCacheStats() {
+    const providers = ['glm', 'grok', 'generic'];
+    const stats = new Map();
+    for (const provider of providers) {
+        const providerStats = getProviderCacheStats(provider);
+        if (providerStats.namespaces.length > 0) {
+            stats.set(provider, providerStats);
+        }
+    }
+    return stats;
+}
+/**
+ * Reset all provider cache instances (for testing)
+ */
+export function resetProviderCaches() {
+    providerCacheInstances.clear();
+}
+//# sourceMappingURL=provider-file-cache.js.map

package/dist/utils/provider-file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-file-cache.js","sourceRoot":"","sources":["../../src/utils/provider-file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAa,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EACL,eAAe,EAEf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAkB/B;;GAEG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA8B,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,QAAuB,EACvB,MAAgC;IAEhC,uBAAuB;IACvB,MAAM,GAAG,GAAG,QAAQ;QAClB,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAEzB,4DAA4D;IAC5D,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;IAE3C,wCAAwC;IACxC,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAiB,CAAC;QAC9D,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oDAAoD;IACpD,MAAM,KAAK,GAAG,eAAe,CAAI;QAC/B,QAAQ,EAAE,GAAG,CAAC,YAAY;QAC1B,SAAS,EAAE,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC3C,GAAG,EAAE,MAAM,EAAE,GAAG;QAChB,UAAU,EAAE,MAAM,EAAE,UAAU;QAC9B,OAAO,EAAE,MAAM,EAAE,OAAO;QACxB,MAAM,EAAE,MAAM,EAAE,MAAM;QACtB,WAAW,EAAE,MAAM,EAAE,WAAW;KACjC,CAAC,CAAC;IAEH,uBAAuB;IACvB,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,QAAuB,EACvB,MAAgC;IAEhC,MAAM,GAAG,GAAG,QAAQ;QAClB,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAEzB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;IAE3C,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAiB,CAAC;IACzD,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAI;QAC/B,QAAQ,EAAE,GAAG,CAAC,YAAY;QAC1B,SAAS,EAAE,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC3C,GAAG,EAAE,MAAM,EAAE,GAAG;QAChB,UAAU,EAAE,MAAM,EAAE,UAAU;QAC9B,OAAO,EAAE,MAAM,EAAE,OAAO;QACxB,MAAM,EAAE,MAAM,EAAE,MAAM;QACtB,WAAW,EAAE,MAAM,EAAE,WAAW;KACjC,CAAC,CAAC;IAEH,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAsB;IAC7D,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAC1E,CAAC;IACF,sBAAsB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAsB;IAO1D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAE3B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;YACnC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC;YACxB,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;IAC9C,MAAM,OAAO,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO;QACL,UAAU;QACV,YAAY;QACZ,SAAS;QACT,WAAW;QACX,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IAUtC,MAAM,SAAS,GAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,EASlB,CAAC;IAEJ,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,aAAa,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,sBAAsB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/utils/provider-settings.d.ts

@@ -0,0 +1,181 @@
+/**
+ * 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 { z } from 'zod';
+import { ProviderContext, ProviderType } from './provider-context.js';
+/**
+ * Provider-specific user settings schema
+ */
+declare const ProviderUserSettingsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    apiKeyEncrypted: z.ZodOptional<z.ZodObject<{
+        encrypted: z.ZodString;
+        iv: z.ZodString;
+        salt: z.ZodString;
+        tag: z.ZodString;
+        version: z.ZodNumber;
+    }, z.core.$strip>>;
+    baseURL: z.ZodOptional<z.ZodString>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+    models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    grok: z.ZodOptional<z.ZodObject<{
+        thinkingMode: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            low: "low";
+            high: "high";
+        }>>;
+        liveSearch: z.ZodOptional<z.ZodBoolean>;
+        seed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    glm: z.ZodOptional<z.ZodObject<{
+        thinkingEnabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    thinking: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    sampling: z.ZodOptional<z.ZodObject<{
+        doSample: z.ZodOptional<z.ZodBoolean>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type ProviderUserSettings = z.infer<typeof ProviderUserSettingsSchema>;
+/**
+ * Provider-aware settings manager
+ * Unlike the base SettingsManager, this is instance-based to support
+ * multiple concurrent provider contexts.
+ */
+export declare class ProviderSettingsManager {
+    private static instances;
+    readonly context: ProviderContext;
+    private userSettingsCache;
+    private cacheTimestamp;
+    private readonly cacheTTL;
+    private constructor();
+    /**
+     * Get or create a settings manager for a provider context
+     */
+    static forContext(context: ProviderContext): ProviderSettingsManager;
+    /**
+     * Get settings manager for a specific provider
+     */
+    static forProvider(provider: ProviderType): ProviderSettingsManager;
+    /**
+     * Get settings manager for current context
+     */
+    static current(): ProviderSettingsManager;
+    /**
+     * Clear all cached instances (for testing)
+     */
+    static clearInstances(): void;
+    /**
+     * Invalidate cache for this instance
+     */
+    invalidateCache(): void;
+    /**
+     * Get the config file path for this provider
+     */
+    get configPath(): string;
+    /**
+     * Ensure config directory exists with proper permissions
+     */
+    private ensureConfigDir;
+    /**
+     * Load user settings with caching and file locking
+     */
+    loadUserSettings(): ProviderUserSettings;
+    /**
+     * Migrate plain-text API key to encrypted format
+     */
+    private migrateToEncrypted;
+    /**
+     * Save user settings with file locking
+     * Uses atomic read-modify-write to prevent race conditions
+     */
+    saveUserSettings(settings: Partial<ProviderUserSettings>): void;
+    /**
+     * Get API key with fallback to environment variable
+     */
+    getApiKey(): string | undefined;
+    /**
+     * Get base URL with fallback
+     * Returns undefined if no valid URL is configured (empty string is treated as unconfigured)
+     */
+    getBaseURL(): string | undefined;
+    /**
+     * Get current model with fallback
+     * Returns undefined if no valid model is configured (empty string is treated as unconfigured)
+     */
+    getCurrentModel(): string | undefined;
+    /**
+     * Get available models
+     */
+    getAvailableModels(): string[];
+    /**
+     * Get thinking settings
+     */
+    getThinkingSettings(): {
+        enabled?: boolean;
+    } | undefined;
+    /**
+     * Get Grok-specific settings
+     */
+    getGrokSettings(): {
+        thinkingMode: 'off' | 'low' | 'high';
+        liveSearch: boolean;
+        seed?: number;
+    } | undefined;
+    /**
+     * Get GLM-specific settings
+     */
+    getGLMSettings(): {
+        thinkingEnabled: boolean;
+    } | undefined;
+    /**
+     * Check if provider is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Update a specific setting
+     */
+    updateSetting<K extends keyof ProviderUserSettings>(key: K, value: ProviderUserSettings[K]): void;
+}
+/**
+ * Get provider settings for current context or specific provider
+ */
+export declare function getProviderSettings(provider?: ProviderType): ProviderSettingsManager;
+/**
+ * Check if a provider is configured
+ */
+export declare function isProviderConfigured(provider: ProviderType): boolean;
+/**
+ * Get the best available provider (configured with API key)
+ */
+export declare function getBestAvailableProvider(): ProviderType | null;
+/**
+ * Get all configured providers
+ */
+export declare function getConfiguredProviders(): ProviderType[];
+export {};