cayu.evals.browser_acceptance

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

BROWSER_ACCEPTANCE_HTML_MAX_BYTES

from cayu.evals import BROWSER_ACCEPTANCE_HTML_MAX_BYTES

BROWSER_ACCEPTANCE_HTML_MAX_BYTES = 32 << 20

Release source · Runtime guarantees · Capability guides

BROWSER_ACCEPTANCE_MANIFEST_MAX_BYTES

from cayu.evals import BROWSER_ACCEPTANCE_MANIFEST_MAX_BYTES

BROWSER_ACCEPTANCE_MANIFEST_MAX_BYTES = 8 << 20

Release source · Runtime guarantees · Capability guides

browser_acceptance_report_from_json

from cayu.evals import browser_acceptance_report_from_json

browser_acceptance_report_from_json(source: str | bytes) -> BrowserAcceptanceReportV1

Release source · Runtime guarantees · Capability guides

BROWSER_ACCEPTANCE_REPORT_MAX_BYTES

from cayu.evals import BROWSER_ACCEPTANCE_REPORT_MAX_BYTES

BROWSER_ACCEPTANCE_REPORT_MAX_BYTES = 32 << 20

Release source · Runtime guarantees · Capability guides

browser_acceptance_report_to_json

from cayu.evals import browser_acceptance_report_to_json

browser_acceptance_report_to_json(report: BrowserAcceptanceReportV1) -> str

Release source · Runtime guarantees · Capability guides

BROWSER_ACCEPTANCE_SCHEMA_VERSION

from cayu.evals import BROWSER_ACCEPTANCE_SCHEMA_VERSION

BROWSER_ACCEPTANCE_SCHEMA_VERSION = 1

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceAccessState

from cayu.evals import BrowserAcceptanceAccessState

Bases: StrEnum.

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
AVAILABLE	class attribute	'available'
BLOCKED	class attribute	'blocked'
UNKNOWN	class attribute	'unknown'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceAgentReportState

from cayu.evals import BrowserAcceptanceAgentReportState

Bases: StrEnum.

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
CLAIMED_SUCCESS	class attribute	'claimed_success'
CLAIMED_FAILURE	class attribute	'claimed_failure'
ABSENT	class attribute	'absent'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceAggregateV1

from cayu.evals import BrowserAcceptanceAggregateV1

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
overall_status	BrowserAcceptanceConformance	required
total_rows	StrictInt	Field(ge=1)
conforming_rows	StrictInt	Field(ge=0)
incomplete_rows	StrictInt	Field(ge=0)
state_counts	dict[BrowserAcceptanceState, StrictInt]	required
semantic_counts	dict[BrowserAcceptanceSemanticState, StrictInt]	required
access_state_counts	dict[BrowserAcceptanceAccessState, StrictInt]	required
error_counts	dict[StrictStr, StrictInt]	required
truncation_counts	dict[StrictStr, StrictInt]	required
total_model_steps	StrictInt | None	Field(default=None, ge=0)
total_browser_operations	StrictInt | None	Field(default=None, ge=0)
total_input_tokens	StrictInt | None	Field(default=None, ge=0)
total_output_tokens	StrictInt | None	Field(default=None, ge=0)
total_tokens	StrictInt | None	Field(default=None, ge=0)
estimated_costs	dict[str, StrictStr]	Field(default_factory=dict)
unpriced_model_steps	dict[str, StrictInt]	Field(default_factory=dict)
total_artifact_bytes	StrictInt | None	Field(default=None, ge=0)
total_elapsed_ms	StrictInt	Field(ge=0)
limit_violations	tuple[StrictStr, ...]	Field(default=(), max_length=16)

validate_counts (method)

BrowserAcceptanceAggregateV1.validate_counts(value: dict[Any, int], info) -> dict[Any, int]

copy_costs (method)

BrowserAcceptanceAggregateV1.copy_costs(value: object) -> dict[str, Any]

copy_unpriced_steps (method)

BrowserAcceptanceAggregateV1.copy_unpriced_steps(value: object) -> dict[str, Any]

validate_limit_violations (method)

BrowserAcceptanceAggregateV1.validate_limit_violations(value: tuple[str, ...], info) -> tuple[str, ...]

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceArtifactEvidenceV1

from cayu.evals import BrowserAcceptanceArtifactEvidenceV1

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
artifact_id	StrictStr	required
artifact_revision	StrictStr	required
kind	StrictStr	required
content_type	StrictStr	required
size_bytes	StrictInt	Field(ge=0)

validate_revision (method)

BrowserAcceptanceArtifactEvidenceV1.validate_revision(value: str, info) -> str

validate_text (method)

BrowserAcceptanceArtifactEvidenceV1.validate_text(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceAuthenticationPhaseV1

from cayu.evals import BrowserAcceptanceAuthenticationPhaseV1

Validated phase-local site evidence bound to its durable observation.

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
phase	Literal['handback', 'restoration']	required
browser_session_revision	StrictStr	required
observation_revision	StrictStr	required
authenticated_requests	StrictInt	Field(ge=0, le=1 << 20)

validate_revision (method)

BrowserAcceptanceAuthenticationPhaseV1.validate_revision(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceCaseAggregateV1

from cayu.evals import BrowserAcceptanceCaseAggregateV1

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
case_id	StrictStr	required
case_revision	StrictStr	required
variability	BrowserAcceptanceVariabilityState	required
total_trials	StrictInt	Field(ge=0)
conforming_trials	StrictInt	Field(ge=0)
incomplete_trials	StrictInt	Field(ge=0)

validate_case_id (method)

BrowserAcceptanceCaseAggregateV1.validate_case_id(value: str, info) -> str

validate_case_revision (method)

BrowserAcceptanceCaseAggregateV1.validate_case_revision(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceCaseCategory

from cayu.evals import BrowserAcceptanceCaseCategory

Bases: StrEnum.

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
SUCCESS	class attribute	'success'
REFUSAL	class attribute	'refusal'
LIMIT	class attribute	'limit'
CRASH	class attribute	'crash'
CANCELLATION	class attribute	'cancellation'
RECOVERY	class attribute	'recovery'
AMBIGUITY	class attribute	'ambiguity'
ADVERSARIAL	class attribute	'adversarial'
CAPABILITY	class attribute	'capability'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceCaseV1

from cayu.evals import BrowserAcceptanceCaseV1

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
case_id	StrictStr	required
revision	StrictStr	required
category	BrowserAcceptanceCaseCategory	required
expected_state	BrowserAcceptanceState	required
semantic_oracle	BrowserAcceptanceSemanticOracle	required
semantic_success_required	StrictBool	True
fault_scenario	BrowserAcceptanceFaultScenario | None	None
required	StrictBool	True
fixture_route	StrictStr | None	None
operations	tuple[StrictStr, ...]	Field(min_length=1, max_length=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_CASE)
screenshot_checkpoints	tuple[StrictStr, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_CHECKPOINTS_PER_CASE)
oracle_parameters	dict[str, Any]	Field(default_factory=dict)

validate_case_id (method)

BrowserAcceptanceCaseV1.validate_case_id(value: str, info) -> str

validate_revision (method)

BrowserAcceptanceCaseV1.validate_revision(value: str, info) -> str

validate_fixture_route (method)

BrowserAcceptanceCaseV1.validate_fixture_route(value: str | None, info) -> str | None

validate_operations (method)

BrowserAcceptanceCaseV1.validate_operations(value: tuple[str, ...], info) -> tuple[str, ...]

validate_checkpoints (method)

BrowserAcceptanceCaseV1.validate_checkpoints(value: tuple[str, ...], info) -> tuple[str, ...]

copy_oracle_parameters (method)

BrowserAcceptanceCaseV1.copy_oracle_parameters(value: object) -> dict[str, Any]

validate_case (method)

BrowserAcceptanceCaseV1.validate_case() -> Self

build (method)

BrowserAcceptanceCaseV1.build(**values: Any) -> BrowserAcceptanceCaseV1

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceCompletionState

from cayu.evals import BrowserAcceptanceCompletionState

Bases: StrEnum.

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
COMPLETE	class attribute	'complete'
INCOMPLETE	class attribute	'incomplete'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceConformance

from cayu.evals import BrowserAcceptanceConformance

Bases: StrEnum.

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
PASSED	class attribute	'passed'
FAILED	class attribute	'failed'
INCOMPLETE	class attribute	'incomplete'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceDiagnosticState

from cayu.evals import BrowserAcceptanceDiagnosticState

Bases: StrEnum.

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
CAPTURED	class attribute	'captured'
UNAVAILABLE	class attribute	'unavailable'
NOT_REQUESTED	class attribute	'not_requested'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceDiagnosticV1

from cayu.evals import BrowserAcceptanceDiagnosticV1

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
state	BrowserAcceptanceDiagnosticState	required
error_code	StrictStr | None	None
fixture_route_observed	StrictBool | None	None
fixture_route_request_count	StrictInt | None	Field(default=None, ge=0)
fixture_authenticated_request_count	StrictInt | None	Field(default=None, ge=0, le=1 << 20)
browser_dispatches	StrictInt | None	Field(default=None, ge=0, le=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_ROW)
fixture_effects	dict[StrictStr, StrictInt]	Field(default_factory=dict)
chromium_identity	StrictStr | None	None
fault	BrowserAcceptanceFaultEvidenceV1 | None	None
profile	BrowserAcceptanceProfileEvidenceV1 | None	None
operator	BrowserAcceptanceOperatorEvidenceV1 | None	None
authentication_phases	tuple[BrowserAcceptanceAuthenticationPhaseV1, ...]	Field(default=(), max_length=2)
operations	tuple[BrowserAcceptanceOperationEvidenceV1, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_ROW)
requests	tuple[BrowserAcceptanceRequestSummaryV1, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_REQUEST_SUMMARIES_PER_ROW)
truncated_categories	tuple[StrictStr, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_TRUNCATION_CATEGORIES)

validate_error_code (method)

BrowserAcceptanceDiagnosticV1.validate_error_code(value: str | None, info) -> str | None

validate_chromium_identity (method)

BrowserAcceptanceDiagnosticV1.validate_chromium_identity(value: str | None, info) -> str | None

copy_operations (method)

BrowserAcceptanceDiagnosticV1.copy_operations(value: object) -> object

copy_fault (method)

BrowserAcceptanceDiagnosticV1.copy_fault(value: object) -> object

copy_profile (method)

BrowserAcceptanceDiagnosticV1.copy_profile(value: object) -> object

copy_operator (method)

BrowserAcceptanceDiagnosticV1.copy_operator(value: object) -> object

copy_authentication_phases (method)

BrowserAcceptanceDiagnosticV1.copy_authentication_phases(value: object) -> object

copy_requests (method)

BrowserAcceptanceDiagnosticV1.copy_requests(value: object) -> object

validate_truncation (method)

BrowserAcceptanceDiagnosticV1.validate_truncation(value: tuple[str, ...], info) -> tuple[str, ...]

copy_fixture_effects (method)

BrowserAcceptanceDiagnosticV1.copy_fixture_effects(value: object) -> dict[str, Any]

validate_state (method)

BrowserAcceptanceDiagnosticV1.validate_state() -> Self

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceFaultEvidenceV1

from cayu.evals import BrowserAcceptanceFaultEvidenceV1

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
scenario	BrowserAcceptanceFaultScenario	required
boundary_observed	StrictBool	required
cancellation_delivered	StrictBool	False
process_loss_observed	StrictBool	False
recovered_in_fresh_app	StrictBool	False
browser_dispatches	StrictInt	Field(ge=0, le=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_CASE)
quarantined_tool_calls	StrictInt	Field(default=0, ge=0, le=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_CASE)

validate_signal (method)

BrowserAcceptanceFaultEvidenceV1.validate_signal() -> Self

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceFaultScenario

from cayu.evals import BrowserAcceptanceFaultScenario

Bases: StrEnum.

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
SECRET_BEFORE_CAPTURE	class attribute	'secret_before_capture'
CANCEL_AFTER_INTENT	class attribute	'cancel_after_intent'
CANCEL_AFTER_DISPATCHED	class attribute	'cancel_after_dispatched'
CANCEL_BEFORE_TERMINAL	class attribute	'cancel_before_terminal'
CANCEL_AFTER_ARTIFACT	class attribute	'cancel_after_artifact'
CANCEL_AFTER_TERMINAL	class attribute	'cancel_after_terminal'
PROCESS_AFTER_INTENT	class attribute	'process_after_intent'
PROCESS_AFTER_DISPATCHED	class attribute	'process_after_dispatched'
PROCESS_BEFORE_TERMINAL	class attribute	'process_before_terminal'
PROCESS_AFTER_ARTIFACT	class attribute	'process_after_artifact'
PROCESS_AFTER_TERMINAL	class attribute	'process_after_terminal'
BROWSER_BEFORE_DISPATCH	class attribute	'browser_before_dispatch'
BROWSER_ALLOCATION_LOSS	class attribute	'browser_allocation_loss'
BROWSER_DURING_EXECUTION	class attribute	'browser_during_execution'
BROWSER_AFTER_EFFECT	class attribute	'browser_after_effect'
BROWSER_DURING_CLEANUP	class attribute	'browser_during_cleanup'
BROWSER_ACTIVE_PAGE_CRASH	class attribute	'browser_active_page_crash'
BROWSER_BACKGROUND_PAGE_CRASH	class attribute	'browser_background_page_crash'
BROWSER_UPLOAD_DISCONNECTION	class attribute	'browser_upload_disconnection'
BROWSER_UPLOAD_ACKNOWLEDGEMENT_LOSS	class attribute	'browser_upload_acknowledgement_loss'
ACKNOWLEDGEMENT_LOSS	class attribute	'acknowledgement_loss'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceInfrastructureState

from cayu.evals import BrowserAcceptanceInfrastructureState

Bases: StrEnum.

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
AVAILABLE	class attribute	'available'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceLimitsV1

from cayu.evals import BrowserAcceptanceLimitsV1

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
max_destinations	StrictInt	Field(ge=1, le=64)
max_browser_operations	StrictInt	Field(ge=1, le=16384)
max_model_steps	StrictInt	Field(ge=1, le=1024)
max_wall_time_ms	StrictInt	Field(ge=1, le=3600000)
max_artifact_bytes	StrictInt	Field(ge=1, le=1 << 30)
max_concurrency	StrictInt	Field(ge=1, le=32)
max_input_tokens	StrictInt | None	Field(default=None, ge=1)
max_output_tokens	StrictInt | None	Field(default=None, ge=1)
max_estimated_cost	StrictStr | None	Field(default=None, max_length=128)

validate_cost (method)

BrowserAcceptanceLimitsV1.validate_cost(value: str | None, info) -> str | None

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceManifestV1

from cayu.evals import BrowserAcceptanceManifestV1

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
record_type	Literal['cayu.browser-acceptance-manifest']	'cayu.browser-acceptance-manifest'
schema_version	Literal[1]	BROWSER_ACCEPTANCE_SCHEMA_VERSION
revision	StrictStr	required
corpus_revision	StrictStr	required
suite_id	StrictStr	required
mode	BrowserAcceptanceMode	required
enabled	StrictBool	True
trial_count	StrictInt	Field(ge=1, le=BROWSER_ACCEPTANCE_MAX_TRIALS)
allowed_origins	tuple[StrictStr, ...]	Field(min_length=1, max_length=BROWSER_ACCEPTANCE_MAX_ORIGINS)
limits	BrowserAcceptanceLimitsV1	required
cases	tuple[BrowserAcceptanceCaseV1, ...]	Field(min_length=1, max_length=BROWSER_ACCEPTANCE_MAX_CASES)

validate_revision (method)

BrowserAcceptanceManifestV1.validate_revision(value: str, info) -> str

validate_suite_id (method)

BrowserAcceptanceManifestV1.validate_suite_id(value: str, info) -> str

validate_origins (method)

BrowserAcceptanceManifestV1.validate_origins(value: tuple[str, ...], info) -> tuple[str, ...]

copy_limits (method)

BrowserAcceptanceManifestV1.copy_limits(value: object) -> object

copy_cases (method)

BrowserAcceptanceManifestV1.copy_cases(value: object) -> object

validate_manifest (method)

BrowserAcceptanceManifestV1.validate_manifest() -> Self

build (method)

BrowserAcceptanceManifestV1.build(**values: Any) -> BrowserAcceptanceManifestV1

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceMode

from cayu.evals import BrowserAcceptanceMode

Bases: StrEnum.

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
DETERMINISTIC	class attribute	'deterministic'
LIVE_PUBLIC	class attribute	'live_public'
LIVE_AUTHENTICATED	class attribute	'live_authenticated'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceOperationEvidenceV1

from cayu.evals import BrowserAcceptanceOperationEvidenceV1

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
sequence	StrictInt	Field(ge=1, le=BROWSER_ACCEPTANCE_MAX_OPERATIONS_PER_ROW)
invocation_revision	StrictStr	required
operation	StrictStr	required
state	BrowserAcceptanceOperationState	required
error_category	StrictStr | None	None
allocation_disposition	BrowserAllocationDisposition	required
browser_session_revision	StrictStr | None	None
target_revision	StrictStr | None	None
observed_target_revision	StrictStr | None	None
observation_revision	StrictStr | None	None
ref_count	StrictInt | None	Field(default=None, ge=0)
snapshot_bytes	StrictInt | None	Field(default=None, ge=0)
load_state	StrictStr | None	None
access_state	BrowserAcceptanceAccessState | None	None
truncation	tuple[StrictStr, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_TRUNCATION_CATEGORIES)
artifacts	tuple[BrowserAcceptanceArtifactEvidenceV1, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_ARTIFACTS_PER_ROW)

validate_invocation_revision (method)

BrowserAcceptanceOperationEvidenceV1.validate_invocation_revision(value: str, info) -> str

validate_target_revision (method)

BrowserAcceptanceOperationEvidenceV1.validate_target_revision(value: str | None, info) -> str | None

validate_text (method)

BrowserAcceptanceOperationEvidenceV1.validate_text(value: str | None, info) -> str | None

validate_truncation (method)

BrowserAcceptanceOperationEvidenceV1.validate_truncation(value: tuple[str, ...], info) -> tuple[str, ...]

copy_artifacts (method)

BrowserAcceptanceOperationEvidenceV1.copy_artifacts(value: object) -> object

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceOperationState

from cayu.evals import BrowserAcceptanceOperationState

Bases: StrEnum.

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
INTENT	class attribute	'intent'
DISPATCHED	class attribute	'dispatched'
TERMINAL	class attribute	'terminal'
OPERATION_NOT_DISPATCHED	class attribute	'operation_not_dispatched'
OUTCOME_AMBIGUOUS	class attribute	'outcome_ambiguous'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceOperatorEvidenceV1

from cayu.evals import BrowserAcceptanceOperatorEvidenceV1

Content-free projection of one durable browser-control allocation.

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
identity_revision	StrictStr	required
browser_session_revision	StrictStr	required
state	BrowserControlState	required
control_epoch	StrictInt	Field(ge=1, le=MAX_DURABLE_JSON_INTEGER)
acquired_epoch	StrictInt | None	Field(default=None, ge=1, le=MAX_DURABLE_JSON_INTEGER)
handed_back_epoch	StrictInt | None	Field(default=None, ge=1, le=MAX_DURABLE_JSON_INTEGER)
acquisition_revision	StrictStr | None	None
handback_revision	StrictStr | None	None
fresh_observation_revision	StrictStr | None	None
restored_observation_revision	StrictStr | None	None
restored_browser_session_revision	StrictStr | None	None
settled_inputs	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
input_pending	StrictBool	required
fresh_observation_required	StrictBool	required
sensitive_entry_pending	StrictBool	required
mutation_uncertain	StrictBool	required

validate_revision (method)

BrowserAcceptanceOperatorEvidenceV1.validate_revision(value: str | None, info) -> str | None

Release source · Runtime guarantees · Capability guides

BrowserAcceptancePlanV1

from cayu.evals import BrowserAcceptancePlanV1

Trusted application plan loaded by the repository acceptance command.

Decorators: @dataclass(frozen=True, slots=True).

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
manifest	BrowserAcceptanceManifestV1	required
eval_plan	EvalPlan	required
bridge	WebBridge	required
authenticated	BrowserAcceptanceAuthenticatedConfigV1 | None	None
authenticated_request_count	Callable[[], int] | None	None
authentication_collector	BrowserAcceptanceAuthenticationCollector | None	None
case_bridges	tuple[tuple[str, WebBridge], ...]	()
case_apps	tuple[tuple[str, Any], ...]	()
pricing	PriceBook | None	None
cost_currencies	tuple[str, ...]	()
scenario_executor_revision	str | None	None
scenario_executor	Callable[[BrowserAcceptanceCaseV1, int, int, float], Awaitable[BrowserAcceptanceScenarioExecutionV1]] | None	None

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceProfileEvidenceV1

from cayu.evals import BrowserAcceptanceProfileEvidenceV1

Bounded store inspection evidence; no profile plaintext or application labels.

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
store_kind	Literal['memory', 'sqlite', 'custom']	required
status	BrowserProfileStatus	required
authority_fingerprint	StrictStr	required
generation_before	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
generation_after	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
active_writer	StrictBool	required
cookie_count	StrictInt	Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
checkpoint_receipt_revision	StrictStr | None	None
restore_receipt_revision	StrictStr | None	None

validate_authority (method)

BrowserAcceptanceProfileEvidenceV1.validate_authority(value: str) -> str

validate_receipt (method)

BrowserAcceptanceProfileEvidenceV1.validate_receipt(value: str | None, info) -> str | None

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceReportV1

from cayu.evals import BrowserAcceptanceReportV1

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
record_type	Literal['cayu.browser-acceptance-report']	'cayu.browser-acceptance-report'
schema_version	Literal[1]	BROWSER_ACCEPTANCE_SCHEMA_VERSION
revision	StrictStr	required
run_identity_revision	StrictStr	required
manifest	BrowserAcceptanceManifestV1	required
runtime_identity	BrowserAcceptanceRuntimeIdentityV1	required
started_at	datetime	required
completed_at	datetime	required
rows	tuple[BrowserAcceptanceTrialReceiptV1, ...]	Field(min_length=1, max_length=BROWSER_ACCEPTANCE_MAX_ROWS)
prior_rows	tuple[BrowserAcceptanceTrialReceiptV1, ...]	Field(default=(), max_length=BROWSER_ACCEPTANCE_MAX_ROWS)
cases	tuple[BrowserAcceptanceCaseAggregateV1, ...]	required
aggregate	BrowserAcceptanceAggregateV1	required
source_report_revision	StrictStr | None	None

validate_revision (method)

BrowserAcceptanceReportV1.validate_revision(value: str | None, info) -> str | None

validate_timestamp (method)

BrowserAcceptanceReportV1.validate_timestamp(value: datetime, info) -> datetime

copy_manifest (method)

BrowserAcceptanceReportV1.copy_manifest(value: object) -> object

copy_runtime_identity (method)

BrowserAcceptanceReportV1.copy_runtime_identity(value: object) -> object

copy_rows (method)

BrowserAcceptanceReportV1.copy_rows(value: object) -> object

copy_prior_rows (method)

BrowserAcceptanceReportV1.copy_prior_rows(value: object) -> object

copy_case_aggregates (method)

BrowserAcceptanceReportV1.copy_case_aggregates(value: object) -> object

copy_aggregate (method)

BrowserAcceptanceReportV1.copy_aggregate(value: object) -> object

validate_report (method)

BrowserAcceptanceReportV1.validate_report() -> Self

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceRequestSummaryV1

from cayu.evals import BrowserAcceptanceRequestSummaryV1

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
sequence	StrictInt	Field(ge=1, le=BROWSER_ACCEPTANCE_MAX_REQUEST_SUMMARIES_PER_ROW)
method	StrictStr	required
destination_revision	StrictStr	required
route_revision	StrictStr	required
outcome	StrictStr	required
status_code	StrictInt | None	Field(default=None, ge=100, le=599)
request_bytes	StrictInt | None	Field(default=None, ge=0)
response_bytes	StrictInt | None	Field(default=None, ge=0)
truncated	StrictBool	False

validate_revision (method)

BrowserAcceptanceRequestSummaryV1.validate_revision(value: str, info) -> str

validate_text (method)

BrowserAcceptanceRequestSummaryV1.validate_text(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceRuntimeIdentityV1

from cayu.evals import BrowserAcceptanceRuntimeIdentityV1

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
revision	StrictStr	required
runtime_build_provenance	RuntimeBuildProvenance	required
browser_protocol	StrictStr	required
browser_worker_version	StrictStr	required
playwright_version	StrictStr	required
chromium_identity	StrictStr | None	None
runner_fingerprint	StrictStr	required
workload_fingerprint	StrictStr	required
egress_fingerprint	StrictStr	required
artifact_store_fingerprint	StrictStr	required
execution_profile_fingerprint	StrictStr	required
execution_suite_fingerprint	StrictStr	required
provider_name	StrictStr	required
model	StrictStr	required
pricing_profile_fingerprint	StrictStr | None	None
cost_currencies	tuple[StrictStr, ...]	Field(default=(), max_length=32)
platform_system	StrictStr	required
platform_machine	StrictStr	required
python_version	StrictStr	required

validate_revision (method)

BrowserAcceptanceRuntimeIdentityV1.validate_revision(value: str, info) -> str

validate_fingerprint (method)

BrowserAcceptanceRuntimeIdentityV1.validate_fingerprint(value: str | None, info) -> str | None

validate_text (method)

BrowserAcceptanceRuntimeIdentityV1.validate_text(value: str | None, info) -> str | None

validate_cost_currencies (method)

BrowserAcceptanceRuntimeIdentityV1.validate_cost_currencies(value: tuple[str, ...], info) -> tuple[str, ...]

copy_build_provenance (method)

BrowserAcceptanceRuntimeIdentityV1.copy_build_provenance(value: object) -> object

validate_identity (method)

BrowserAcceptanceRuntimeIdentityV1.validate_identity() -> Self

build (method)

BrowserAcceptanceRuntimeIdentityV1.build(**values: Any) -> BrowserAcceptanceRuntimeIdentityV1

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceScenarioExecutionV1

from cayu.evals import BrowserAcceptanceScenarioExecutionV1

Decorators: @dataclass(frozen=True, slots=True).

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
app	Any	required
trial	EvalTrialResult	required
fault	BrowserAcceptanceFaultEvidenceV1	required
execution_profile_fingerprint	str	required
recovered_tool_calls	tuple[ToolCallEvidenceV1, ...]	()

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceSemanticOracle

from cayu.evals import BrowserAcceptanceSemanticOracle

Bases: StrEnum.

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
QUARANTINED_RECOVERY	class attribute	'quarantined_recovery'
OBSERVATION	class attribute	'observation'
FIXTURE_EFFECT	class attribute	'fixture_effect'
ARTIFACT	class attribute	'artifact'
STABLE_ERROR	class attribute	'stable_error'
PUBLIC_SCHEMA_UNSUPPORTED	class attribute	'public_schema_unsupported'
RECOVERY_STATE	class attribute	'recovery_state'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceSemanticState

from cayu.evals import BrowserAcceptanceSemanticState

Bases: StrEnum.

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
PASSED	class attribute	'passed'
FAILED	class attribute	'failed'
NOT_APPLICABLE	class attribute	'not_applicable'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceState

from cayu.evals import BrowserAcceptanceState

Bases: StrEnum.

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
SUPPORTED	class attribute	'supported'
UNSUPPORTED	class attribute	'unsupported'
PASSED	class attribute	'passed'
FAILED	class attribute	'failed'
REFUSED	class attribute	'refused'
AMBIGUOUS	class attribute	'ambiguous'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceTrialReceiptV1

from cayu.evals import BrowserAcceptanceTrialReceiptV1

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
record_type	Literal['cayu.browser-acceptance-trial']	'cayu.browser-acceptance-trial'
schema_version	Literal[1]	BROWSER_ACCEPTANCE_SCHEMA_VERSION
revision	StrictStr	required
row_id	StrictStr	required
run_identity_revision	StrictStr	required
case_id	StrictStr	required
case_revision	StrictStr	required
trial_number	StrictInt	Field(ge=1, le=BROWSER_ACCEPTANCE_MAX_TRIALS)
attempt_number	StrictInt	Field(default=1, ge=1, le=1000)
expected_state	BrowserAcceptanceState	required
observed_state	BrowserAcceptanceState	required
conformance	BrowserAcceptanceConformance	required
semantic_state	BrowserAcceptanceSemanticState	required
infrastructure_state	BrowserAcceptanceInfrastructureState	required
completion_state	BrowserAcceptanceCompletionState	required
agent_report_state	BrowserAcceptanceAgentReportState	required
started_at	datetime	required
completed_at	datetime	required
elapsed_ms	StrictInt	Field(ge=0)
usage	BrowserAcceptanceUsageV1	required
error_categories	dict[StrictStr, StrictInt]	Field(default_factory=dict)
truncation_categories	dict[StrictStr, StrictInt]	Field(default_factory=dict)
diagnostic	BrowserAcceptanceDiagnosticV1	required

validate_revision (method)

BrowserAcceptanceTrialReceiptV1.validate_revision(value: str, info) -> str

validate_case_id (method)

BrowserAcceptanceTrialReceiptV1.validate_case_id(value: str, info) -> str

validate_timestamp (method)

BrowserAcceptanceTrialReceiptV1.validate_timestamp(value: datetime, info) -> datetime

copy_usage (method)

BrowserAcceptanceTrialReceiptV1.copy_usage(value: object) -> object

copy_diagnostic (method)

BrowserAcceptanceTrialReceiptV1.copy_diagnostic(value: object) -> object

copy_count_map (method)

BrowserAcceptanceTrialReceiptV1.copy_count_map(value: object, info) -> dict[str, Any]

validate_receipt (method)

BrowserAcceptanceTrialReceiptV1.validate_receipt() -> Self

build (method)

BrowserAcceptanceTrialReceiptV1.build(**values: Any) -> BrowserAcceptanceTrialReceiptV1

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceUsageV1

from cayu.evals import BrowserAcceptanceUsageV1

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
model_steps	StrictInt | None	Field(default=None, ge=0)
browser_operations	StrictInt | None	Field(default=None, ge=0)
input_tokens	StrictInt | None	Field(default=None, ge=0)
output_tokens	StrictInt | None	Field(default=None, ge=0)
total_tokens	StrictInt | None	Field(default=None, ge=0)
estimated_costs	dict[str, StrictStr]	Field(default_factory=dict)
unpriced_model_steps	dict[str, StrictInt]	Field(default_factory=dict)

copy_cost_evidence (method)

BrowserAcceptanceUsageV1.copy_cost_evidence(value: object, info) -> dict[str, Any]

Release source · Runtime guarantees · Capability guides

BrowserAcceptanceVariabilityState

from cayu.evals import BrowserAcceptanceVariabilityState

Bases: StrEnum.

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
NOT_APPLICABLE	class attribute	'not_applicable'
STABLE	class attribute	'stable'
VARIABLE	class attribute	'variable'
INCOMPLETE	class attribute	'incomplete'

Release source · Runtime guarantees · Capability guides

BrowserAllocationDisposition

from cayu.evals import BrowserAllocationDisposition

Bases: StrEnum.

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
LIVE	class attribute	'live'
RETIRED	class attribute	'retired'
UNCERTAIN	class attribute	'uncertain'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

build_browser_acceptance_report

from cayu.evals import build_browser_acceptance_report

build_browser_acceptance_report(*, manifest: BrowserAcceptanceManifestV1, runtime_identity: BrowserAcceptanceRuntimeIdentityV1, started_at: datetime, completed_at: datetime, rows: tuple[BrowserAcceptanceTrialReceiptV1, ...], prior_rows: tuple[BrowserAcceptanceTrialReceiptV1, ...]=(), source_report_revision: str | None=None) -> BrowserAcceptanceReportV1

Release source · Runtime guarantees · Capability guides

build_browser_acceptance_retry_report

from cayu.evals import build_browser_acceptance_retry_report

Replace selected latest rows while retaining every immutable prior attempt.

build_browser_acceptance_retry_report(previous: BrowserAcceptanceReportV1, *, retry_rows: tuple[BrowserAcceptanceTrialReceiptV1, ...], completed_at: datetime, runtime_identity: BrowserAcceptanceRuntimeIdentityV1 | None=None) -> BrowserAcceptanceReportV1

Release source · Runtime guarantees · Capability guides

inspect_browser_acceptance_runtime_identity

from cayu.evals import inspect_browser_acceptance_runtime_identity

Derive the report identity from the exact registered public execution path.

async inspect_browser_acceptance_runtime_identity(plan: BrowserAcceptancePlanV1, *, evidence_views: tuple[AssertionEvidenceView, ...]=()) -> BrowserAcceptanceRuntimeIdentityV1

Release source · Runtime guarantees · Capability guides

project_browser_acceptance_diagnostic

from cayu.evals import project_browser_acceptance_diagnostic

Project the already-bounded eval evidence into browser-only diagnostics.

project_browser_acceptance_diagnostic(evidence: AssertionEvidenceView, *, fixture_route_observed: bool | None=None, fixture_route_request_count: int | None=None, fixture_authenticated_request_count: int | None=None, browser_dispatches: int | None=None, fixture_effects: Mapping[str, int] | None=None, request_summaries: tuple[BrowserAcceptanceRequestSummaryV1, ...]=(), request_summaries_truncated: bool=False, capture_error_code: str | None=None, fault: BrowserAcceptanceFaultEvidenceV1 | None=None, profile: BrowserAcceptanceProfileEvidenceV1 | None=None, operator: BrowserAcceptanceOperatorEvidenceV1 | None=None, authentication_phases: tuple[BrowserAcceptanceAuthenticationPhaseV1, ...]=(), recovered_tool_calls: tuple[ToolCallEvidenceV1, ...]=()) -> BrowserAcceptanceDiagnosticV1

Release source · Runtime guarantees · Capability guides

project_browser_acceptance_trial

from cayu.evals import project_browser_acceptance_trial

Create one immutable browser receipt from generic eval evidence.

project_browser_acceptance_trial(*, case: BrowserAcceptanceCaseV1, run_identity_revision: str, trial: EvalTrialResult, evidence: AssertionEvidenceView, fixture_route_observed: bool | None=None, fixture_route_request_count: int | None=None, fixture_authenticated_request_count: int | None=None, fixture_effects: Mapping[str, int] | None=None, public_operations: frozenset[str]=frozenset(), request_summaries: tuple[BrowserAcceptanceRequestSummaryV1, ...]=(), request_summaries_truncated: bool=False, agent_report_state: BrowserAcceptanceAgentReportState=BrowserAcceptanceAgentReportState.UNAVAILABLE, diagnostic_capture_error: str | None=None, fault: BrowserAcceptanceFaultEvidenceV1 | None=None, profile: BrowserAcceptanceProfileEvidenceV1 | None=None, operator: BrowserAcceptanceOperatorEvidenceV1 | None=None, authentication_phases: tuple[BrowserAcceptanceAuthenticationPhaseV1, ...]=(), recovered_tool_calls: tuple[ToolCallEvidenceV1, ...]=(), attempt_number: int=1, required_cost_currencies: tuple[str, ...]=()) -> BrowserAcceptanceTrialReceiptV1

Release source · Runtime guarantees · Capability guides

render_browser_acceptance_html

from cayu.evals import render_browser_acceptance_html

render_browser_acceptance_html(report: BrowserAcceptanceReportV1) -> str

Release source · Runtime guarantees · Capability guides

run_browser_acceptance

from cayu.evals import run_browser_acceptance

Run one browser manifest through the public eval/application surface.

async run_browser_acceptance(plan: BrowserAcceptancePlanV1, *, deterministic_fixture: BrowserAcceptanceFixtureV1 | None=None, receipt_directory: str | Path | None=None, previous_report: BrowserAcceptanceReportV1 | None=None, retry_trials: tuple[tuple[str, int], ...]=()) -> BrowserAcceptanceReportV1

Release source · Runtime guarantees · Capability guides

write_browser_acceptance_report

from cayu.evals import write_browser_acceptance_report

write_browser_acceptance_report(report: BrowserAcceptanceReportV1, output_directory: str | Path) -> tuple[Path, Path]

Release source · Runtime guarantees · Capability guides