@machina.ai/openapi-contract-tester 2.1.0

package/dist/llm/ai-cache.js

@@ -0,0 +1,220 @@
+/**
+ * AI Response Cache
+ *
+ * Caches LLM responses to reduce API calls, costs, and latency.
+ * Uses simple in-memory cache with TTL (time-to-live).
+ *
+ * @module llm/ai-cache
+ */
+import { createHash } from 'crypto';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('ai-cache');
+/**
+ * AI Response Cache
+ *
+ * Simple in-memory cache for LLM responses.
+ * Automatically expires entries after TTL.
+ */
+class AICache {
+    cache = new Map();
+    TTL;
+    hits = 0;
+    misses = 0;
+    /**
+     * Creates a new AI cache
+     *
+     * @param ttl - Time-to-live in milliseconds (default: 1 hour)
+     */
+    constructor(ttl = 3600000) {
+        this.TTL = ttl;
+        log.info('AI cache initialized', { ttl, ttlMinutes: ttl / 60000 });
+        // Clean up expired entries periodically
+        setInterval(() => this.cleanup(), ttl / 2);
+    }
+    /**
+     * Generates a hash key for a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns Hash key
+     */
+    getHash(prompt) {
+        return createHash('sha256').update(prompt).digest('hex').slice(0, 32);
+    }
+    /**
+     * Gets cached response for a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns Cached response or null if not found/expired
+     */
+    get(prompt) {
+        const hash = this.getHash(prompt);
+        const entry = this.cache.get(hash);
+        if (!entry) {
+            this.misses++;
+            log.debug('Cache miss', { hash: hash.slice(0, 8) });
+            return null;
+        }
+        const age = Date.now() - entry.timestamp;
+        if (age > this.TTL) {
+            // Entry expired
+            this.cache.delete(hash);
+            this.misses++;
+            log.debug('Cache expired', { hash: hash.slice(0, 8), ageMinutes: age / 60000 });
+            return null;
+        }
+        // Cache hit
+        entry.hits++;
+        this.hits++;
+        log.debug('Cache hit', {
+            hash: hash.slice(0, 8),
+            ageMinutes: age / 60000,
+            totalHits: entry.hits
+        });
+        return entry.response;
+    }
+    /**
+     * Stores a response in the cache
+     *
+     * @param prompt - Prompt text
+     * @param response - LLM response
+     */
+    set(prompt, response) {
+        const hash = this.getHash(prompt);
+        const entry = {
+            prompt,
+            response,
+            timestamp: Date.now(),
+            hits: 0
+        };
+        this.cache.set(hash, entry);
+        log.debug('Cache stored', {
+            hash: hash.slice(0, 8),
+            promptLength: prompt.length,
+            responseLength: response.length,
+            cacheSize: this.cache.size
+        });
+    }
+    /**
+     * Clears the entire cache
+     */
+    clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+        log.info('Cache cleared', { entriesRemoved: size });
+    }
+    /**
+     * Removes expired entries from the cache
+     */
+    cleanup() {
+        const before = this.cache.size;
+        const now = Date.now();
+        let removed = 0;
+        for (const [hash, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.TTL) {
+                this.cache.delete(hash);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            log.info('Cache cleanup completed', {
+                removed,
+                before,
+                after: this.cache.size
+            });
+        }
+    }
+    /**
+     * Gets cache statistics
+     *
+     * @returns Cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? this.hits / total : 0;
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.cache.size,
+            hitRate: Math.round(hitRate * 100) / 100
+        };
+    }
+    /**
+     * Logs cache statistics
+     */
+    logStats() {
+        const stats = this.getStats();
+        log.info('Cache statistics', {
+            ...stats,
+            hitRatePercent: `${(stats.hitRate * 100).toFixed(1)}%`
+        });
+    }
+    /**
+     * Checks if cache contains a prompt
+     *
+     * @param prompt - Prompt text
+     * @returns true if cached and not expired
+     */
+    has(prompt) {
+        return this.get(prompt) !== null;
+    }
+    /**
+     * Gets the number of entries in the cache
+     *
+     * @returns Cache size
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Removes a specific entry from the cache
+     *
+     * @param prompt - Prompt text
+     * @returns true if entry was removed
+     */
+    delete(prompt) {
+        const hash = this.getHash(prompt);
+        const existed = this.cache.has(hash);
+        this.cache.delete(hash);
+        if (existed) {
+            log.debug('Cache entry removed', { hash: hash.slice(0, 8) });
+        }
+        return existed;
+    }
+    /**
+     * Gets all cached prompts (for debugging)
+     *
+     * @returns Array of cached prompt hashes and timestamps
+     */
+    getCachedPrompts() {
+        const now = Date.now();
+        return Array.from(this.cache.entries()).map(([hash, entry]) => ({
+            hash: hash.slice(0, 8),
+            age: now - entry.timestamp,
+            hits: entry.hits
+        }));
+    }
+}
+/**
+ * Global AI cache instance (1 hour TTL)
+ */
+export const aiCache = new AICache(3600000);
+/**
+ * Gets the global AI cache instance
+ *
+ * @returns AI cache instance
+ */
+export function getAICache() {
+    return aiCache;
+}
+/**
+ * Creates a new AI cache with custom TTL
+ *
+ * @param ttl - Time-to-live in milliseconds
+ * @returns New AI cache instance
+ */
+export function createAICache(ttl) {
+    return new AICache(ttl);
+}
+//# sourceMappingURL=ai-cache.js.map

package/dist/llm/ai-cache.js.map

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

package/dist/llm/ai-client.d.ts

@@ -0,0 +1,92 @@
+/**
+ * AI Client Module
+ *
+ * Generic LLM client that supports various AI API providers.
+ * Uses TOON format to reduce token usage by ~40%.
+ *
+ * @module llm/ai-client
+ */
+/**
+ * Options for LLM calls
+ */
+export interface LLMCallOptions {
+    /**
+     * Maximum tokens in response
+     * Note: Some LLMs use thinking tokens, so this should be higher
+     * @default 4096
+     */
+    maxTokens?: number;
+    /**
+     * Temperature for response randomness (0-1)
+     * @default 0.3
+     */
+    temperature?: number;
+    /**
+     * Timeout in milliseconds (for both request and response reading)
+     * @default 30000 (30 seconds)
+     */
+    timeout?: number;
+}
+/**
+ * Result from LLM call
+ */
+export interface LLMResult {
+    success: boolean;
+    text?: string;
+    error?: string;
+    tokensUsed?: number;
+}
+/**
+ * Converts data to TOON format for token-efficient prompts
+ *
+ * @param data - Data to convert
+ * @returns TOON string or JSON fallback
+ */
+export declare function toTOONFormat(data: unknown): string;
+/**
+ * Calls the LLM with a prompt and returns the response
+ *
+ * @param prompt - The prompt to send to the LLM
+ * @param options - Call options
+ * @returns LLM response
+ *
+ * @example
+ * ```typescript
+ * const result = await callLLM('Analyze these test failures and suggest fixes');
+ * if (result.success) {
+ *   console.log(result.text);
+ * }
+ * ```
+ */
+export declare function callLLM(prompt: string, options?: LLMCallOptions): Promise<LLMResult>;
+/**
+ * Calls the LLM with structured data (automatically converts to TOON)
+ *
+ * @param instruction - What you want the LLM to do
+ * @param data - Structured data to include (will be converted to TOON)
+ * @param options - Call options
+ * @returns LLM response
+ *
+ * @example
+ * ```typescript
+ * const result = await callLLMWithData(
+ *   'Analyze these failures and suggest fixes',
+ *   { failures: [{ endpoint: '/users', status: 401, count: 10 }] }
+ * );
+ * ```
+ */
+export declare function callLLMWithData(instruction: string, data: unknown, options?: LLMCallOptions): Promise<LLMResult>;
+/**
+ * Checks if the LLM service is available
+ * Result is cached for 30 seconds to avoid repeated checks
+ *
+ * @returns true if LLM is reachable
+ */
+export declare function isLLMAvailable(): Promise<boolean>;
+/**
+ * Gets the configured AI API URL
+ *
+ * @returns The API URL being used
+ */
+export declare function getConfiguredAIUrl(): string;
+//# sourceMappingURL=ai-client.d.ts.map

package/dist/llm/ai-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-client.d.ts","sourceRoot":"","sources":["../../src/llm/ai-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6GH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAOlD;AA2ED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,SAAS,CAAC,CAwJpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,SAAS,CAAC,CAUpB;AAYD;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAyCvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}