agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2a/agent-cards/validator.d.ts

@@ -0,0 +1,514 @@
+/**
+ * A2A Agent Card Validator
+ *
+ * JSON Schema validation for A2A v0.3 Agent Capability Cards.
+ * Provides comprehensive validation with detailed error reporting.
+ *
+ * @module adapters/a2a/agent-cards/validator
+ */
+/**
+ * Severity level for validation issues
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * A single validation issue
+ */
+export interface ValidationIssue {
+    /** Issue severity */
+    readonly severity: ValidationSeverity;
+    /** JSON path to the problematic field */
+    readonly path: string;
+    /** Human-readable error message */
+    readonly message: string;
+    /** Error code for programmatic handling */
+    readonly code: string;
+    /** Actual value that caused the issue */
+    readonly value?: unknown;
+    /** Expected value or pattern */
+    readonly expected?: string;
+}
+/**
+ * Result of validation
+ */
+export interface ValidationResult {
+    /** Whether the validation passed (no errors) */
+    readonly valid: boolean;
+    /** List of validation issues found */
+    readonly issues: ValidationIssue[];
+    /** Summary counts by severity */
+    readonly summary: {
+        readonly errors: number;
+        readonly warnings: number;
+        readonly info: number;
+    };
+}
+/**
+ * Validation options
+ */
+export interface ValidatorOptions {
+    /** Include warnings in validation result */
+    readonly includeWarnings?: boolean;
+    /** Include info messages in validation result */
+    readonly includeInfo?: boolean;
+    /** Validate QE-specific metadata */
+    readonly validateQEMetadata?: boolean;
+    /** Strict mode - treat warnings as errors */
+    readonly strict?: boolean;
+    /** Custom URL pattern for agent endpoints */
+    readonly urlPattern?: RegExp;
+    /** Custom version pattern */
+    readonly versionPattern?: RegExp;
+}
+/**
+ * Default validator options
+ */
+export declare const DEFAULT_VALIDATOR_OPTIONS: Required<ValidatorOptions>;
+/**
+ * Validation error codes
+ */
+export declare const ValidationErrorCode: {
+    readonly MISSING_REQUIRED: "MISSING_REQUIRED";
+    readonly INVALID_TYPE: "INVALID_TYPE";
+    readonly INVALID_URL: "INVALID_URL";
+    readonly INVALID_VERSION: "INVALID_VERSION";
+    readonly INVALID_SKILL_ID: "INVALID_SKILL_ID";
+    readonly INVALID_TAG: "INVALID_TAG";
+    readonly EMPTY_STRING: "EMPTY_STRING";
+    readonly EMPTY_ARRAY: "EMPTY_ARRAY";
+    readonly DUPLICATE_SKILL_ID: "DUPLICATE_SKILL_ID";
+    readonly DUPLICATE_TAG: "DUPLICATE_TAG";
+    readonly INVALID_SECURITY_SCHEME: "INVALID_SECURITY_SCHEME";
+    readonly MISSING_OAUTH_FLOW: "MISSING_OAUTH_FLOW";
+    readonly MISSING_TOKEN_URL: "MISSING_TOKEN_URL";
+    readonly INVALID_DOMAIN: "INVALID_DOMAIN";
+    readonly INVALID_MEMORY_NAMESPACE: "INVALID_MEMORY_NAMESPACE";
+    readonly MISSING_PROVIDER: "MISSING_PROVIDER";
+    readonly MISSING_DOCUMENTATION: "MISSING_DOCUMENTATION";
+    readonly MISSING_EXAMPLES: "MISSING_EXAMPLES";
+    readonly MISSING_TAGS: "MISSING_TAGS";
+    readonly NO_STREAMING: "NO_STREAMING";
+};
+/**
+ * JSON Schema for A2A Agent Card v0.3
+ */
+export declare const AGENT_CARD_JSON_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://a2a-protocol.org/schema/agent-card/v0.3";
+    readonly title: "A2A Agent Card";
+    readonly description: "Agent Capability Card per A2A Protocol v0.3";
+    readonly type: "object";
+    readonly required: readonly ["name", "description", "url", "version", "capabilities", "skills"];
+    readonly properties: {
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Human-readable agent name";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Detailed agent description";
+        };
+        readonly url: {
+            readonly type: "string";
+            readonly format: "uri";
+            readonly description: "Service endpoint URL";
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+            readonly description: "Semantic version";
+        };
+        readonly provider: {
+            readonly type: "object";
+            readonly properties: {
+                readonly organization: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                };
+            };
+            readonly required: readonly ["organization"];
+        };
+        readonly documentationUrl: {
+            readonly type: "string";
+            readonly format: "uri";
+        };
+        readonly capabilities: {
+            readonly type: "object";
+            readonly properties: {
+                readonly streaming: {
+                    readonly type: "boolean";
+                };
+                readonly pushNotifications: {
+                    readonly type: "boolean";
+                };
+                readonly stateTransitionHistory: {
+                    readonly type: "boolean";
+                };
+            };
+        };
+        readonly skills: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["id", "name", "description"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z0-9-]+$";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly examples: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly inputModes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly outputModes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                };
+            };
+        };
+        readonly defaultInputModes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly defaultOutputModes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly securitySchemes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["apiKey", "http", "oauth2", "openIdConnect", "mutualTLS"];
+                    };
+                };
+            };
+        };
+        readonly authentication: {
+            readonly type: "object";
+            readonly properties: {
+                readonly schemes: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly credentials: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly supportsAuthenticatedExtendedCard: {
+            readonly type: "boolean";
+        };
+    };
+};
+/**
+ * JSON Schema for QE Agent Card extension
+ */
+export declare const QE_AGENT_CARD_JSON_SCHEMA: {
+    readonly $id: "https://agentic-qe.github.io/schema/qe-agent-card/v3";
+    readonly title: "QE Agent Card";
+    readonly description: "QE-specific Agent Card extension";
+    readonly properties: {
+        readonly qeMetadata: {
+            readonly type: "object";
+            readonly properties: {
+                readonly domain: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly v2Compatibility: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly deprecatedIn: {
+                            readonly type: "string";
+                        };
+                        readonly removedIn: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly memoryReads: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly memoryWrites: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly relatedAgents: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly implementationStatus: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly working: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly partial: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly planned: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Human-readable agent name";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Detailed agent description";
+        };
+        readonly url: {
+            readonly type: "string";
+            readonly format: "uri";
+            readonly description: "Service endpoint URL";
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+            readonly description: "Semantic version";
+        };
+        readonly provider: {
+            readonly type: "object";
+            readonly properties: {
+                readonly organization: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                };
+            };
+            readonly required: readonly ["organization"];
+        };
+        readonly documentationUrl: {
+            readonly type: "string";
+            readonly format: "uri";
+        };
+        readonly capabilities: {
+            readonly type: "object";
+            readonly properties: {
+                readonly streaming: {
+                    readonly type: "boolean";
+                };
+                readonly pushNotifications: {
+                    readonly type: "boolean";
+                };
+                readonly stateTransitionHistory: {
+                    readonly type: "boolean";
+                };
+            };
+        };
+        readonly skills: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["id", "name", "description"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z0-9-]+$";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly examples: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly inputModes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                    readonly outputModes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                    };
+                };
+            };
+        };
+        readonly defaultInputModes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly defaultOutputModes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly securitySchemes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["type"];
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["apiKey", "http", "oauth2", "openIdConnect", "mutualTLS"];
+                    };
+                };
+            };
+        };
+        readonly authentication: {
+            readonly type: "object";
+            readonly properties: {
+                readonly schemes: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly credentials: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly supportsAuthenticatedExtendedCard: {
+            readonly type: "boolean";
+        };
+    };
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly type: "object";
+    readonly required: readonly ["name", "description", "url", "version", "capabilities", "skills"];
+};
+/**
+ * Validator for A2A Agent Cards
+ */
+export declare class AgentCardValidator {
+    private readonly options;
+    constructor(options?: Partial<ValidatorOptions>);
+    /**
+     * Validate an agent card
+     */
+    validate(card: unknown): ValidationResult;
+    /**
+     * Validate multiple agent cards
+     */
+    validateAll(cards: Map<string, unknown>): Map<string, ValidationResult>;
+    /**
+     * Check if a card is valid (has no errors)
+     */
+    isValid(card: unknown): boolean;
+    /**
+     * Get JSON Schema for validation
+     */
+    getJsonSchema(): typeof AGENT_CARD_JSON_SCHEMA | typeof QE_AGENT_CARD_JSON_SCHEMA;
+    /**
+     * Build validation result from issues
+     */
+    private buildResult;
+}
+/**
+ * Create an Agent Card Validator instance
+ */
+export declare function createAgentCardValidator(options?: Partial<ValidatorOptions>): AgentCardValidator;
+/**
+ * Validate an agent card (convenience function)
+ */
+export declare function validateAgentCard(card: unknown, options?: Partial<ValidatorOptions>): ValidationResult;
+/**
+ * Check if an agent card is valid (convenience function)
+ */
+export declare function isValidAgentCard(card: unknown, options?: Partial<ValidatorOptions>): boolean;
+//# sourceMappingURL=validator.d.ts.map

package/v3/dist/adapters/a2a/agent-cards/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2a/agent-cards/validator.ts"],"names":[],"mappings":"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"}