Skip to content

Types

Data structures used throughout the CapiscIO SDK.


Validation Types

ValidationResult

from capiscio_sdk import ValidationResult

result: ValidationResult = await executor.validate_agent_card(url)

print(result.valid)       # bool
print(result.score)       # int (0-100)
print(result.issues)      # List[ValidationIssue]

ValidationIssue

from capiscio_sdk import ValidationIssue, ValidationSeverity

for issue in result.issues:
    print(issue.message)    # str
    print(issue.severity)   # ValidationSeverity
    print(issue.path)       # Optional[str] - JSON path to issue

ValidationSeverity

from capiscio_sdk import ValidationSeverity

# Enumeration values
ValidationSeverity.ERROR    # Blocks validation
ValidationSeverity.WARNING  # Advisory, doesn't block
ValidationSeverity.INFO     # Informational only

API Reference

capiscio_sdk.types.ValidationResult

Bases: BaseModel

Result of a validation operation with multi-dimensional scoring.

Provides three independent score dimensions: - compliance: A2A protocol specification adherence (0-100) - trust: Security and authenticity signals (0-100) - availability: Operational readiness (0-100, optional)

The legacy score field is maintained for backward compatibility and returns the compliance.total value.

score property

score: int

Legacy score property for backward compatibility.

Returns the compliance score total. This property is deprecated. Use result.compliance.total instead.

Returns:

Type Description
int

Compliance score (0-100)

recommendation property

recommendation: str

Get overall recommendation based on all score dimensions.

Returns:

Type Description
str

Human-readable recommendation string

errors property

errors: List[ValidationIssue]

Get only error-level issues.

warnings property

warnings: List[ValidationIssue]

Get only warning-level issues.

capiscio_sdk.types.ValidationIssue

Bases: BaseModel

A single validation issue.

capiscio_sdk.types.ValidationSeverity

Bases: str, Enum

Severity level for validation issues.