@machina.ai/openapi-contract-tester 2.1.0

package/dist/llm/ai-client.js

@@ -0,0 +1,386 @@
+/**
+ * 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
+ */
+import { encode as toTOON } from '@toon-format/toon';
+import { createLogger } from '../utils/logger.js';
+import { aiCache } from './ai-cache.js';
+import http from 'http';
+import https from 'https';
+const log = createLogger('ai-client');
+/**
+ * Default AI configuration
+ */
+const DEFAULT_AI_BASE_URL = 'http://localhost:13800/cell_apps/v1.1/gemini/v1beta/models';
+const DEFAULT_AI_MODEL = 'gemini-3-flash-preview';
+const DEFAULT_AI_ENDPOINT = 'generateContent';
+/**
+ * Model limits for LLM
+ */
+const MODEL_LIMITS = {
+    maxContextTokens: 32000, // Total context window
+    thinkingMargin: 3000, // Reserve for thinking tokens
+    minOutputTokens: 1024, // Minimum output tokens
+    maxOutputTokens: 8192, // Maximum output tokens
+    charsPerToken: 4, // Approximate chars per token
+};
+/**
+ * Get the AI API URL from environment or use default
+ *
+ * Priority order:
+ * 1. AI_API_URL (complete URL override)
+ * 2. AI_MODEL (model name only, uses default base URL)
+ * 3. DEFAULT values
+ *
+ * @returns The full AI API URL
+ *
+ * @example
+ * // Using defaults
+ * // Returns: http://localhost:13800/cell_apps/v1.1/gemini/v1beta/models/gemini-3-flash-preview:generateContent
+ *
+ * // Using AI_MODEL env var
+ * // AI_MODEL=gemini-2.0-flash-exp
+ * // Returns: http://localhost:13800/cell_apps/v1.1/gemini/v1beta/models/gemini-2.0-flash-exp:generateContent
+ *
+ * // Using AI_API_URL env var (complete override)
+ * // AI_API_URL=https://custom-api.com/v1/generate
+ * // Returns: https://custom-api.com/v1/generate
+ */
+function getAIApiUrl() {
+    // Priority 1: Complete URL override
+    if (process.env.AI_API_URL) {
+        return process.env.AI_API_URL;
+    }
+    // Priority 2: Model override with default base URL
+    const model = process.env.AI_MODEL || DEFAULT_AI_MODEL;
+    const baseUrl = process.env.AI_BASE_URL || DEFAULT_AI_BASE_URL;
+    const endpoint = process.env.AI_ENDPOINT || DEFAULT_AI_ENDPOINT;
+    return `${baseUrl}/${model}:${endpoint}`;
+}
+/**
+ * Estimates token count from text (approximate)
+ * @param text - Text to estimate tokens for
+ * @returns Estimated token count
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / MODEL_LIMITS.charsPerToken);
+}
+/**
+ * Calculates optimal maxOutputTokens based on prompt size
+ * Accounts for thinking tokens used by LLM
+ *
+ * @param promptTokens - Estimated tokens in the prompt
+ * @returns Optimal maxOutputTokens value
+ */
+function calculateMaxOutputTokens(promptTokens) {
+    const availableTokens = MODEL_LIMITS.maxContextTokens - promptTokens - MODEL_LIMITS.thinkingMargin;
+    // Clamp between min and max
+    return Math.max(MODEL_LIMITS.minOutputTokens, Math.min(MODEL_LIMITS.maxOutputTokens, availableTokens));
+}
+/**
+ * Converts data to TOON format for token-efficient prompts
+ *
+ * @param data - Data to convert
+ * @returns TOON string or JSON fallback
+ */
+export function toTOONFormat(data) {
+    try {
+        return toTOON(data);
+    }
+    catch (error) {
+        log.warn('TOON conversion failed, using JSON', { error });
+        return JSON.stringify(data, null, 2);
+    }
+}
+/**
+ * Makes HTTP/HTTPS request using native Node.js modules
+ * This works reliably with local AI proxies (e.g., localhost:13800)
+ * whereas fetch() can have streaming issues with some proxies
+ *
+ * @param url - Full URL to request
+ * @param payload - JSON payload to send
+ * @param timeout - Timeout in milliseconds
+ * @returns Promise with response text
+ */
+async function httpRequest(url, payload, timeout) {
+    return new Promise((resolve, reject) => {
+        const urlObj = new URL(url);
+        const isHttps = urlObj.protocol === 'https:';
+        const httpModule = isHttps ? https : http;
+        const body = JSON.stringify(payload);
+        const options = {
+            hostname: urlObj.hostname,
+            port: urlObj.port || (isHttps ? 443 : 80),
+            path: urlObj.pathname + urlObj.search,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body)
+            },
+            timeout
+        };
+        log.debug('Starting HTTP request', { hostname: options.hostname, port: options.port });
+        const req = httpModule.request(options, (res) => {
+            log.debug('HTTP response received', { status: res.statusCode });
+            const chunks = [];
+            res.on('data', (chunk) => {
+                log.debug('Received chunk', { size: chunk.length });
+                chunks.push(chunk);
+            });
+            res.on('end', () => {
+                const responseText = Buffer.concat(chunks).toString('utf-8');
+                log.debug('HTTP response complete', { totalBytes: responseText.length });
+                resolve({
+                    status: res.statusCode || 500,
+                    text: responseText
+                });
+            });
+            res.on('error', (error) => {
+                log.error('HTTP response error', { error: error.message });
+                reject(error);
+            });
+        });
+        req.on('timeout', () => {
+            req.destroy();
+            log.error('HTTP request timeout', { timeout });
+            reject(new Error(`Request timed out after ${timeout}ms`));
+        });
+        req.on('error', (error) => {
+            log.error('HTTP request error', { error: error.message });
+            reject(error);
+        });
+        req.write(body);
+        req.end();
+    });
+}
+/**
+ * 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 async function callLLM(prompt, options = {}) {
+    const { temperature = 0.3, timeout = 300000 // 5 minutes default timeout (very generous for complex analysis)
+     } = options;
+    // Check cache first
+    const cached = aiCache.get(prompt);
+    if (cached) {
+        log.info('LLM response from cache', {
+            promptLength: prompt.length,
+            responseLength: cached.length
+        });
+        aiCache.logStats(); // Log cache stats periodically
+        return { success: true, text: cached };
+    }
+    const apiUrl = getAIApiUrl();
+    // Calculate optimal maxOutputTokens dynamically based on prompt size
+    const estimatedPromptTokens = estimateTokens(prompt);
+    const maxTokens = options.maxTokens || calculateMaxOutputTokens(estimatedPromptTokens);
+    log.info('Calling LLM (cache miss)', {
+        apiUrl,
+        promptLength: prompt.length,
+        estimatedPromptTokens,
+        maxTokens,
+        temperature
+    });
+    try {
+        // Prepare request payload
+        const requestPayload = {
+            contents: [
+                {
+                    parts: [{ text: prompt }]
+                }
+            ],
+            generationConfig: {
+                maxOutputTokens: maxTokens,
+                temperature: temperature
+            }
+        };
+        log.debug('LLM Request payload', {
+            prompt: prompt.length > 500 ? prompt.slice(0, 500) + '...' : prompt,
+            fullPromptLength: prompt.length,
+            generationConfig: requestPayload.generationConfig
+        });
+        // Use native http/https module instead of fetch
+        // (fetch can have issues with some local AI proxy streaming)
+        const response = await httpRequest(apiUrl, requestPayload, timeout);
+        log.debug('Response received', {
+            status: response.status,
+            length: response.text.length,
+            preview: response.text.slice(0, 200)
+        });
+        if (response.status !== 200) {
+            log.error('LLM API error', { status: response.status, error: response.text });
+            return {
+                success: false,
+                error: `API error: ${response.status} - ${response.text}`
+            };
+        }
+        const rawText = response.text;
+        log.debug('LLM Full Response', {
+            fullResponse: rawText.length > 2000 ? rawText.slice(0, 2000) + '...' : rawText,
+            fullLength: rawText.length
+        });
+        // Parse JSON from text
+        log.debug('Parsing JSON from text');
+        let data;
+        try {
+            data = JSON.parse(rawText);
+            log.debug('JSON parsed successfully');
+            // Log parsed response structure
+            log.debug('Parsed LLM Response', {
+                hasCandidates: !!data.candidates,
+                candidatesCount: data.candidates?.length || 0,
+                hasError: !!data.error,
+                finishReason: data.candidates?.[0]?.finishReason,
+                textLength: data.candidates?.[0]?.content?.parts?.[0]?.text?.length || 0
+            });
+        }
+        catch (parseError) {
+            log.error('JSON parse failed', {
+                error: parseError instanceof Error ? parseError.message : String(parseError),
+                rawTextLength: rawText.length,
+                rawTextPreview: rawText.slice(0, 500)
+            });
+            return {
+                success: false,
+                error: `Failed to parse JSON response: ${parseError instanceof Error ? parseError.message : String(parseError)}`
+            };
+        }
+        // Check for API error in response
+        if (data.error) {
+            log.error('LLM returned error', { error: data.error });
+            return {
+                success: false,
+                error: data.error.message || 'Unknown API error'
+            };
+        }
+        // Extract text from response
+        const text = data.candidates?.[0]?.content?.parts?.[0]?.text;
+        if (!text) {
+            log.warn('LLM returned empty response', { data });
+            return {
+                success: false,
+                error: 'Empty response from LLM'
+            };
+        }
+        log.debug('LLM response received', { responseLength: text.length });
+        // Store in cache
+        aiCache.set(prompt, text);
+        log.debug('Response cached');
+        return {
+            success: true,
+            text
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Check if it's a timeout error
+        if (errorMessage.includes('timed out')) {
+            log.error('LLM call timed out', { timeout, error: errorMessage });
+            return {
+                success: false,
+                error: `Request timed out after ${timeout}ms`
+            };
+        }
+        log.error('LLM call failed', { errorMessage, errorType: error instanceof Error ? error.name : typeof error });
+        return {
+            success: false,
+            error: errorMessage
+        };
+    }
+}
+/**
+ * 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 async function callLLMWithData(instruction, data, options = {}) {
+    const toonData = toTOONFormat(data);
+    const prompt = `${instruction}\n\nData:\n${toonData}`;
+    log.debug('Calling LLM with TOON data', {
+        instructionLength: instruction.length,
+        dataLength: toonData.length
+    });
+    return callLLM(prompt, options);
+}
+/**
+ * Cache for LLM availability check
+ */
+let llmAvailabilityCache = null;
+const LLM_AVAILABILITY_CACHE_TTL = 30000; // 30 seconds
+/**
+ * Checks if the LLM service is available
+ * Result is cached for 30 seconds to avoid repeated checks
+ *
+ * @returns true if LLM is reachable
+ */
+export async function isLLMAvailable() {
+    const now = Date.now();
+    // Return cached result if still valid
+    if (llmAvailabilityCache && (now - llmAvailabilityCache.timestamp) < LLM_AVAILABILITY_CACHE_TTL) {
+        log.debug('LLM availability check (from cache)', {
+            available: llmAvailabilityCache.available,
+            cacheAge: now - llmAvailabilityCache.timestamp
+        });
+        return llmAvailabilityCache.available;
+    }
+    // Cache expired or doesn't exist - perform actual check
+    log.debug('LLM availability check (fresh check)');
+    try {
+        const result = await callLLM('Say "ok"', {
+            maxTokens: 10,
+            timeout: 5000
+        });
+        const available = result.success;
+        // Update cache
+        llmAvailabilityCache = {
+            available,
+            timestamp: now
+        };
+        log.info('LLM availability check complete', { available });
+        return available;
+    }
+    catch {
+        // Cache negative result too
+        llmAvailabilityCache = {
+            available: false,
+            timestamp: now
+        };
+        log.info('LLM availability check failed');
+        return false;
+    }
+}
+/**
+ * Gets the configured AI API URL
+ *
+ * @returns The API URL being used
+ */
+export function getConfiguredAIUrl() {
+    return getAIApiUrl();
+}
+//# sourceMappingURL=ai-client.js.map

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

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

package/dist/llm/data-generator-ai.d.ts

@@ -0,0 +1,84 @@
+/**
+ * AI-Powered Data Generator
+ *
+ * Generates contextual, realistic test data using LLM.
+ * Used as a fallback when Faker data is not appropriate for the API domain.
+ *
+ * @module llm/data-generator-ai
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+/**
+ * API context for intelligent data generation
+ */
+export interface APIContext {
+    /**
+     * Type of API (banking, ecommerce, blog, internal, other)
+     */
+    type?: string;
+    /**
+     * Domain of the API (more specific than type)
+     */
+    domain?: string;
+    /**
+     * Industry classification
+     */
+    industry?: string;
+    /**
+     * Entity types in the API (users, products, orders, etc.)
+     */
+    entityTypes?: string[];
+    /**
+     * Endpoint path for context-specific generation
+     */
+    endpoint?: string;
+    /**
+     * Purpose of the endpoint (login, payment, transfer, etc.)
+     */
+    purpose?: string;
+    /**
+     * Validation level (strict for banking, relaxed for blogs)
+     */
+    validationLevel?: 'strict' | 'relaxed';
+    /**
+     * Whether to use real formats (IBANs, credit cards, etc.)
+     */
+    useRealFormats?: boolean;
+}
+/**
+ * Checks if an endpoint is critical and requires AI-generated data
+ *
+ * @param context - API context
+ * @returns true if endpoint is critical
+ */
+export declare function isCriticalEndpoint(context?: APIContext): boolean;
+/**
+ * Generates a realistic value using AI based on schema and context
+ *
+ * @param schema - JSON Schema object
+ * @param propertyName - Name of the property being generated
+ * @param context - API context for domain-specific generation
+ * @returns Generated value or null if AI fails
+ */
+export declare function generateValueWithAI(schema: OpenAPIV3.SchemaObject, propertyName: string, context?: APIContext): Promise<unknown | null>;
+/**
+ * Generates intelligent edge case values using AI
+ *
+ * @param schema - JSON Schema object
+ * @param propertyName - Name of the property
+ * @param context - API context
+ * @returns Array of edge case values with descriptions
+ */
+export declare function generateEdgeCasesWithAI(schema: OpenAPIV3.SchemaObject, propertyName: string, context?: APIContext): Promise<Array<{
+    value: unknown;
+    description: string;
+    expectedStatus: number;
+}>>;
+/**
+ * Infers the purpose of an endpoint from its path and method
+ *
+ * @param endpoint - Endpoint path
+ * @param method - HTTP method
+ * @returns Inferred purpose
+ */
+export declare function inferEndpointPurpose(endpoint: string, method: string): string;
+//# sourceMappingURL=data-generator-ai.d.ts.map

package/dist/llm/data-generator-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-generator-ai.d.ts","sourceRoot":"","sources":["../../src/llm/data-generator-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,eAAe,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAoBhE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,CAAC,YAAY,EAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA4BzB;AAyHD;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,CAAC,YAAY,EAC9B,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkDjF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgC7E"}