cayu.testing.ToolEffectVerification

Part of cayu.testing.base. Read the Python API overview and install the required extra.

from cayu.testing import ToolEffectVerification

Content-free evidence from one isolated-workspace tool invocation.

Bases: BaseModel.

Fields and attributes

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name	Type	Default
schema_version	Literal['1']	'1'
status	ToolEffectVerificationStatus	required
agent_name	str	required
tool_name	str	required
declared_effect	ToolEffect	required
observation_boundary	Literal['isolated_workspace']	_BOUNDARY_NAME
created_paths	tuple[str, ...]	()
updated_paths	tuple[str, ...]	()
deleted_paths	tuple[str, ...]	()
observed_mutation	StrictBool	required
execution_succeeded	StrictBool	required
result_is_error	StrictBool | None	None
exception_type	str | None	None
timeout_seconds	float	required
workspace_max_entries	int	required
workspace_max_files	int	required
workspace_max_file_bytes	int	required
workspace_max_total_bytes	int	required
unobserved_systems	tuple[str, ...]	required
limitations	tuple[str, ...]	_LIMITATIONS

validate_name (method)

ToolEffectVerification.validate_name(value: str, info) -> str

normalize_paths (method)

ToolEffectVerification.normalize_paths(value: tuple[str, ...], info) -> tuple[str, ...]

normalize_unobserved_systems (method)

ToolEffectVerification.normalize_unobserved_systems(value: tuple[str, ...]) -> tuple[str, ...]

validate_exception_type (method)

ToolEffectVerification.validate_exception_type(value: str | None) -> str | None

validate_limitations (method)

ToolEffectVerification.validate_limitations(value: tuple[str, ...]) -> tuple[str, ...]

validate_evidence (method)

ToolEffectVerification.validate_evidence() -> ToolEffectVerification

Release source · Runtime guarantees · Capability guides