agentic-qe 2.6.6 → 2.7.1

package/dist/agents/ApiContractValidatorAgent.d.ts

@@ -15,12 +15,24 @@
  * ROI: 350% (prevents 15-20% of production incidents)
  */
 import { BaseAgent, BaseAgentConfig } from './BaseAgent';
-import { QETask, ApiContractValidatorConfig } from '../types';
+import { QETask, ApiContractValidatorConfig, TaskAssignment } from '../types';
+import { OpenAPISchema, HttpRequest, HttpResponse } from '../types/api-contract.types';
 interface ValidationResult {
     valid: boolean;
     errors: ValidationError[];
     warnings?: ValidationWarning[];
 }
+/** Severity levels for validation errors and breaking changes */
+type Severity = 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+/** AJV error params type - represents validation error parameters from AJV */
+interface AjvErrorParams {
+    missingProperty?: string;
+    additionalProperty?: string;
+    type?: string;
+    limit?: number;
+    comparison?: string;
+    [key: string]: unknown;
+}
 interface ValidationError {
     type: string;
     message: string;
@@ -28,8 +40,8 @@ interface ValidationError {
     param?: string;
     field?: string;
     status?: number;
-    severity?: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
-    params?: any;
+    severity?: Severity;
+    params?: AjvErrorParams;
 }
 interface ValidationWarning {
     type: string;
@@ -37,7 +49,7 @@ interface ValidationWarning {
 }
 interface BreakingChange {
     type: string;
-    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    severity: Severity;
     message: string;
     endpoint?: string;
     method?: string;
@@ -81,7 +93,7 @@ interface VersionValidationResult {
     violations: VersionViolation[];
 }
 interface VersionViolation {
-    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM';
+    severity: Exclude<Severity, 'LOW'>;
     message: string;
     expected: string;
     actual: string;
@@ -99,7 +111,7 @@ interface ConsumerImpact {
     affectedEndpoints: AffectedEndpoint[];
     totalRequests: number;
     estimatedMigrationTime: string;
-    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    priority: Severity;
 }
 interface AffectedEndpoint {
     endpoint: string;
@@ -122,90 +134,105 @@ interface ApiUsage {
 export interface ApiContractValidatorAgentConfig extends BaseAgentConfig {
     validatorConfig: ApiContractValidatorConfig;
 }
+/** Parameters for validateContract */
+interface ValidateContractParams {
+    schema: OpenAPISchema | string;
+    format: 'openapi' | 'swagger' | 'graphql';
+}
+/** Parameters for detectBreakingChanges */
+interface DetectBreakingChangesParams {
+    baseline: OpenAPISchema | string;
+    candidate: OpenAPISchema | string;
+    format?: 'openapi' | 'graphql';
+}
+/** Parameters for validateVersionBump */
+interface ValidateVersionBumpParams {
+    currentVersion: string;
+    proposedVersion: string;
+    changes: ChangeDetectionResult | {
+        breaking: BreakingChange[];
+        nonBreaking: NonBreakingChange[];
+    };
+}
+/** Parameters for analyzeConsumerImpact */
+interface AnalyzeConsumerImpactParams {
+    changes: {
+        breaking: BreakingChange[];
+        nonBreaking: NonBreakingChange[];
+    };
+    consumers: Consumer[];
+}
+/** Parameters for generateDiff */
+interface GenerateDiffParams {
+    baseline: OpenAPISchema | string;
+    candidate: OpenAPISchema | string;
+    format?: 'markdown' | 'json' | 'html';
+}
+/** Parameters for generateMigrationGuide */
+interface GenerateMigrationGuideParams {
+    fromVersion: string;
+    toVersion: string;
+    changes: {
+        breaking: BreakingChange[];
+        nonBreaking: NonBreakingChange[];
+    };
+}
+/** Parameters for validateRequestResponse */
+interface ValidateRequestResponseParams {
+    request: HttpRequest;
+    response: HttpResponse;
+    schema: OpenAPISchema;
+    endpoint: string;
+    method: string;
+}
 export declare class ApiContractValidatorAgent extends BaseAgent {
     private readonly config;
     private ajv;
     constructor(config: ApiContractValidatorAgentConfig);
     protected onPreTask(data: {
-        assignment: any;
+        assignment: TaskAssignment;
+        context?: Record<string, unknown>;
     }): Promise<void>;
     protected onPostTask(data: {
-        assignment: any;
-        result: any;
+        assignment: TaskAssignment;
+        result: unknown;
     }): Promise<void>;
     protected onTaskError(data: {
-        assignment: any;
+        assignment: TaskAssignment;
         error: Error;
     }): Promise<void>;
     protected initializeComponents(): Promise<void>;
     protected loadKnowledge(): Promise<void>;
     protected cleanup(): Promise<void>;
-    protected performTask(task: QETask): Promise<any>;
+    protected performTask(task: QETask): Promise<ValidationResult | ChangeDetectionResult | VersionValidationResult | ConsumerImpactAnalysis | string>;
     /**
      * Validate an API contract (OpenAPI, GraphQL, etc.)
      */
-    validateContract(params: {
-        schema: any;
-        format: 'openapi' | 'swagger' | 'graphql';
-    }): Promise<ValidationResult>;
+    validateContract(params: ValidateContractParams): Promise<ValidationResult>;
     /**
      * Detect breaking changes between two schema versions
      */
-    detectBreakingChanges(params: {
-        baseline: any;
-        candidate: any;
-        format?: 'openapi' | 'graphql';
-    }): Promise<ChangeDetectionResult>;
+    detectBreakingChanges(params: DetectBreakingChangesParams): Promise<ChangeDetectionResult>;
     /**
      * Validate request/response against schema
      */
-    validateRequestResponse(params: {
-        request: any;
-        response: any;
-        schema: any;
-        endpoint: string;
-        method: string;
-    }): Promise<ValidationResult>;
+    validateRequestResponse(params: ValidateRequestResponseParams): Promise<ValidationResult>;
     /**
      * Validate semantic version bump
      */
-    validateVersionBump(params: {
-        currentVersion: string;
-        proposedVersion: string;
-        changes: ChangeDetectionResult | {
-            breaking: any[];
-            nonBreaking: any[];
-        };
-    }): Promise<VersionValidationResult>;
+    validateVersionBump(params: ValidateVersionBumpParams): Promise<VersionValidationResult>;
     /**
      * Analyze consumer impact of API changes
      */
-    analyzeConsumerImpact(params: {
-        changes: {
-            breaking: BreakingChange[];
-            nonBreaking: NonBreakingChange[];
-        };
-        consumers: Consumer[];
-    }): Promise<ConsumerImpactAnalysis>;
+    analyzeConsumerImpact(params: AnalyzeConsumerImpactParams): Promise<ConsumerImpactAnalysis>;
     /**
      * Generate contract diff report
      */
-    generateDiff(params: {
-        baseline: any;
-        candidate: any;
-        format?: 'markdown' | 'json' | 'html';
-    }): Promise<string>;
+    generateDiff(params: GenerateDiffParams): Promise<string>;
     /**
      * Generate migration guide
      */
-    generateMigrationGuide(params: {
-        fromVersion: string;
-        toVersion: string;
-        changes: {
-            breaking: BreakingChange[];
-            nonBreaking: NonBreakingChange[];
-        };
-    }): Promise<string>;
+    generateMigrationGuide(params: GenerateMigrationGuideParams): Promise<string>;
     private validateOpenAPISchema;
     private validateGraphQLSchema;
     private validateRequest;
@@ -232,7 +259,7 @@ export declare class ApiContractValidatorAgent extends BaseAgent {
      * Extract domain-specific metrics for Nightly-Learner
      * Provides rich API contract validation metrics for pattern learning
      */
-    protected extractTaskMetrics(result: any): Record<string, number>;
+    protected extractTaskMetrics(result: unknown): Record<string, number>;
 }
 export {};
 //# sourceMappingURL=ApiContractValidatorAgent.d.ts.map

package/dist/agents/ApiContractValidatorAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiContractValidatorAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ApiContractValidatorAgent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ApiContractValidatorAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ApiContractValidatorAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/ApiContractValidatorAgent.js

@@ -31,9 +31,10 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         this.config = config.validatorConfig;
         this.ajv = new ajv_1.default({ allErrors: true });
         try {
+            // Type assertion needed due to ajv-formats library type incompatibility
             (0, ajv_formats_1.default)(this.ajv);
         }
-        catch (e) {
+        catch {
             // Formats may not be compatible, continue without them
         }
     }
@@ -54,14 +55,15 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
     }
     async onPostTask(data) {
         await super.onPostTask(data);
+        const taskResult = data.result;
         // Store validation results
         await this.memoryStore.store(`aqe/${this.agentId.type}/results/${data.assignment.id}`, {
             result: data.result,
             timestamp: new Date(),
             taskType: data.assignment.task.type,
-            success: data.result?.success !== false,
-            breakingChangesDetected: data.result?.breakingChanges?.length || 0,
-            contractsValidated: data.result?.contractsValidated || 0
+            success: taskResult?.success !== false,
+            breakingChangesDetected: taskResult?.breakingChanges?.length || 0,
+            contractsValidated: taskResult?.contractsValidated || 0
         }, 86400);
         // Emit completion event
         this.eventBus.emit(`${this.agentId.type}:completed`, {
@@ -71,7 +73,7 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         });
         console.log(`[${this.agentId.type}] API contract validation task completed`, {
             taskId: data.assignment.id,
-            breakingChanges: data.result?.breakingChanges?.length || 0
+            breakingChanges: taskResult?.breakingChanges?.length || 0
         });
     }
     async onTaskError(data) {
@@ -103,9 +105,10 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         // Initialize validation components
         this.ajv = new ajv_1.default({ allErrors: true });
         try {
+            // Type assertion needed due to ajv-formats library type incompatibility
             (0, ajv_formats_1.default)(this.ajv);
         }
-        catch (e) {
+        catch {
             // Formats may not be compatible, continue without them
         }
         await this.storeSharedMemory('status', {
@@ -160,6 +163,10 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         const { schema, format } = params;
         let result;
         if (format === 'graphql') {
+            // GraphQL schema must be a string
+            if (typeof schema !== 'string') {
+                return { valid: false, errors: [{ type: 'INVALID_SCHEMA', message: 'GraphQL schema must be a string' }] };
+            }
             result = this.validateGraphQLSchema(schema);
         }
         else {
@@ -186,6 +193,15 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         const { baseline, candidate, format = 'openapi' } = params;
         let result;
         if (format === 'graphql') {
+            // GraphQL schemas must be strings
+            if (typeof baseline !== 'string' || typeof candidate !== 'string') {
+                return {
+                    breaking: [{ type: 'INVALID_SCHEMA', severity: 'CRITICAL', message: 'GraphQL schemas must be strings' }],
+                    nonBreaking: [],
+                    hasBreakingChanges: true,
+                    summary: { totalBreaking: 1, totalNonBreaking: 0, recommendation: 'Provide valid GraphQL schema strings' }
+                };
+            }
             result = this.detectGraphQLBreakingChanges(baseline, candidate);
         }
         else {
@@ -354,6 +370,15 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
     // ============================================================================
     validateOpenAPISchema(schema) {
         const errors = [];
+        // Handle string input (should be parsed first)
+        if (typeof schema === 'string') {
+            errors.push({
+                type: 'INVALID_SCHEMA_TYPE',
+                message: 'Schema must be an object, not a string. Parse the schema first.',
+                severity: 'CRITICAL'
+            });
+            return { valid: false, errors };
+        }
         // Validate required top-level fields
         if (!schema.openapi && !schema.swagger) {
             errors.push({
@@ -445,7 +470,8 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
         // Validate query parameters
         for (const param of parameters) {
             if (param.in === 'query' && param.required) {
-                if (request.query[param.name] === undefined) {
+                const queryValue = request.query[param.name];
+                if (queryValue === undefined) {
                     errors.push({
                         type: 'MISSING_QUERY_PARAM',
                         param: param.name,
@@ -494,7 +520,7 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
             ? []
             : (validate.errors || []).map((error) => ({
                 type: 'SCHEMA_VALIDATION',
-                path: error.instancePath || error.dataPath || '',
+                path: error.instancePath || '',
                 message: error.message || 'Validation error',
                 params: error.params,
                 severity: 'HIGH'
@@ -504,6 +530,15 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
     detectOpenAPIBreakingChanges(baseline, candidate) {
         const breaking = [];
         const nonBreaking = [];
+        // Handle string inputs
+        if (typeof baseline === 'string' || typeof candidate === 'string') {
+            breaking.push({
+                type: 'INVALID_SCHEMA_TYPE',
+                severity: 'CRITICAL',
+                message: 'OpenAPI schemas must be objects, not strings'
+            });
+            return { breaking, nonBreaking, hasBreakingChanges: true, summary: this.generateSummary(breaking, nonBreaking) };
+        }
         // Compare endpoints
         const baselinePaths = baseline.paths || {};
         const candidatePaths = candidate.paths || {};
@@ -517,8 +552,13 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
                 });
                 continue;
             }
-            for (const [method, operation] of Object.entries(methods)) {
-                if (!candidatePaths[path][method]) {
+            const pathItem = methods;
+            const candidatePathItem = candidatePaths[path];
+            for (const [method, operation] of Object.entries(pathItem)) {
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                const candidateOp = candidatePathItem[method];
+                if (!candidateOp) {
                     breaking.push({
                         type: 'METHOD_REMOVED',
                         severity: 'CRITICAL',
@@ -528,12 +568,14 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
                     });
                     continue;
                 }
+                const op = operation;
+                const candOp = candidateOp;
                 // Compare parameters
-                const paramChanges = this.compareParameters(operation.parameters || [], candidatePaths[path][method].parameters || []);
+                const paramChanges = this.compareParameters(op.parameters || [], candOp.parameters || []);
                 breaking.push(...paramChanges.breaking);
                 nonBreaking.push(...paramChanges.nonBreaking);
                 // Compare responses
-                const responseChanges = this.compareResponses(operation.responses || {}, candidatePaths[path][method].responses || {});
+                const responseChanges = this.compareResponses(op.responses || {}, candOp.responses || {});
                 breaking.push(...responseChanges.breaking.map(c => ({ ...c, endpoint: path, method: method.toUpperCase() })));
                 nonBreaking.push(...responseChanges.nonBreaking.map(c => ({ ...c, endpoint: path, method: method.toUpperCase() })));
             }
@@ -615,14 +657,16 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
                     });
                 }
                 // Check for type changes
-                if (param.schema?.type !== candidateParam.schema?.type) {
+                const baseType = param.schema?.type;
+                const candidateType = candidateParam.schema?.type;
+                if (baseType !== candidateType) {
                     breaking.push({
                         type: 'PARAM_TYPE_CHANGED',
                         severity: 'HIGH',
                         param: param.name,
-                        oldType: param.schema?.type,
-                        newType: candidateParam.schema?.type,
-                        message: `Parameter '${param.name}' type changed from ${param.schema?.type} to ${candidateParam.schema?.type}`
+                        oldType: Array.isArray(baseType) ? baseType.join('|') : baseType,
+                        newType: Array.isArray(candidateType) ? candidateType.join('|') : candidateType,
+                        message: `Parameter '${param.name}' type changed from ${baseType} to ${candidateType}`
                     });
                 }
             }
@@ -659,8 +703,10 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
             }
             else {
                 // Compare response schemas
-                const baselineSchema = response.content?.['application/json']?.schema;
-                const candidateSchema = candidate[status].content?.['application/json']?.schema;
+                const baselineResponse = response;
+                const candidateResponse = candidate[status];
+                const baselineSchema = baselineResponse.content?.['application/json']?.schema;
+                const candidateSchema = candidateResponse.content?.['application/json']?.schema;
                 if (baselineSchema && candidateSchema) {
                     const schemaChanges = this.compareResponseSchemas(baselineSchema, candidateSchema);
                     breaking.push(...schemaChanges.breaking.map(c => ({ ...c, status: parseInt(status) })));
@@ -698,15 +744,19 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
                         message: `Response field '${field}' was removed`
                     });
                 }
-                else if (fieldSchema.type !== candidateFieldSchema.type) {
-                    breaking.push({
-                        type: 'FIELD_TYPE_CHANGED',
-                        severity: 'HIGH',
-                        field,
-                        oldType: fieldSchema.type,
-                        newType: candidateFieldSchema.type,
-                        message: `Response field '${field}' type changed from ${fieldSchema.type} to ${candidateFieldSchema.type}`
-                    });
+                else {
+                    const baseType = fieldSchema.type;
+                    const candidateType = candidateFieldSchema.type;
+                    if (baseType !== candidateType) {
+                        breaking.push({
+                            type: 'FIELD_TYPE_CHANGED',
+                            severity: 'HIGH',
+                            field,
+                            oldType: Array.isArray(baseType) ? baseType.join('|') : baseType,
+                            newType: Array.isArray(candidateType) ? candidateType.join('|') : candidateType,
+                            message: `Response field '${field}' type changed from ${baseType} to ${candidateType}`
+                        });
+                    }
                 }
             }
             // New fields are non-breaking
@@ -848,36 +898,37 @@ class ApiContractValidatorAgent extends BaseAgent_1.BaseAgent {
     extractTaskMetrics(result) {
         const metrics = {};
         if (result && typeof result === 'object') {
+            const taskResult = result;
             // Validation results
-            metrics.is_valid = result.isValid ? 1 : 0;
-            metrics.total_errors = result.errors?.length || 0;
-            metrics.total_warnings = result.warnings?.length || 0;
+            metrics.is_valid = taskResult.isValid ? 1 : 0;
+            metrics.total_errors = taskResult.errors?.length || 0;
+            metrics.total_warnings = taskResult.warnings?.length || 0;
             // Breaking changes
-            if (result.breakingChanges && Array.isArray(result.breakingChanges)) {
-                metrics.breaking_changes = result.breakingChanges.length;
-                metrics.critical_changes = result.breakingChanges.filter((c) => c.severity === 'CRITICAL').length;
-                metrics.high_changes = result.breakingChanges.filter((c) => c.severity === 'HIGH').length;
+            if (taskResult.breakingChanges && Array.isArray(taskResult.breakingChanges)) {
+                metrics.breaking_changes = taskResult.breakingChanges.length;
+                metrics.critical_changes = taskResult.breakingChanges.filter((c) => c.severity === 'CRITICAL').length;
+                metrics.high_changes = taskResult.breakingChanges.filter((c) => c.severity === 'HIGH').length;
             }
             // Schema validation
-            if (result.schemaValidation) {
-                metrics.schema_valid = result.schemaValidation.valid ? 1 : 0;
-                metrics.schema_errors = result.schemaValidation.errors?.length || 0;
+            if (taskResult.schemaValidation) {
+                metrics.schema_valid = taskResult.schemaValidation.valid ? 1 : 0;
+                metrics.schema_errors = taskResult.schemaValidation.errors?.length || 0;
             }
             // Backward compatibility
-            if (typeof result.backwardCompatible === 'boolean') {
-                metrics.backward_compatible = result.backwardCompatible ? 1 : 0;
+            if (typeof taskResult.backwardCompatible === 'boolean') {
+                metrics.backward_compatible = taskResult.backwardCompatible ? 1 : 0;
             }
             // Consumer contracts
-            if (result.consumerContracts) {
-                metrics.contracts_satisfied = result.consumerContracts.satisfied || 0;
-                metrics.contracts_violated = result.consumerContracts.violated || 0;
+            if (taskResult.consumerContracts) {
+                metrics.contracts_satisfied = taskResult.consumerContracts.satisfied || 0;
+                metrics.contracts_violated = taskResult.consumerContracts.violated || 0;
             }
             // Confidence and coverage
-            if (typeof result.confidence === 'number') {
-                metrics.confidence = result.confidence;
+            if (typeof taskResult.confidence === 'number') {
+                metrics.confidence = taskResult.confidence;
             }
-            if (typeof result.coverage === 'number') {
-                metrics.coverage = result.coverage;
+            if (typeof taskResult.coverage === 'number') {
+                metrics.coverage = taskResult.coverage;
             }
         }
         return metrics;