cayu.evals.external_private_memory_ablation

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.

EXTERNAL_PRIVATE_MEMORY_ABLATION_COMPLETION_FILENAME

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_COMPLETION_FILENAME

EXTERNAL_PRIVATE_MEMORY_ABLATION_COMPLETION_FILENAME = 'COMPLETE'

Release source · Runtime guarantees · Capability guides

external_private_memory_ablation_destination

from cayu.evals import external_private_memory_ablation_destination

Authorize existing private state and one new private artifact directory.

external_private_memory_ablation_destination(*, state_storage_id: str, destination_id: str, approved_private_root: str | Path, state_directory: str | Path, artifact_directory: str | Path) -> ExternalPrivateMemoryAblationDestination

Release source · Runtime guarantees · Capability guides

external_private_memory_ablation_experiment_revision

from cayu.evals import external_private_memory_ablation_experiment_revision

Return the immutable pre-execution experiment contract revision.

external_private_memory_ablation_experiment_revision(experiment: MemoryExperimentReportRequest) -> str

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_ARTIFACT_BYTES

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_ARTIFACT_BYTES

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_ARTIFACT_BYTES = 64 << 20

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_REPORT_EVIDENCE_BYTES_PER_TRIAL

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_REPORT_EVIDENCE_BYTES_PER_TRIAL

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_REPORT_EVIDENCE_BYTES_PER_TRIAL = 4 << 20

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_SUPPLEMENTAL_BYTES_PER_TRIAL

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_SUPPLEMENTAL_BYTES_PER_TRIAL

EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_SUPPLEMENTAL_BYTES_PER_TRIAL = 64 << 10

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_METHODOLOGY_FILENAME

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_METHODOLOGY_FILENAME

EXTERNAL_PRIVATE_MEMORY_ABLATION_METHODOLOGY_FILENAME = 'methodology.json'

Release source · Runtime guarantees · Capability guides

external_private_memory_ablation_methodology_to_json

from cayu.evals import external_private_memory_ablation_methodology_to_json

external_private_memory_ablation_methodology_to_json(methodology: ExternalPrivateMemoryAblationMethodology) -> str

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_MIN_REPORT_EVIDENCE_BYTES_PER_TRIAL

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_MIN_REPORT_EVIDENCE_BYTES_PER_TRIAL

EXTERNAL_PRIVATE_MEMORY_ABLATION_MIN_REPORT_EVIDENCE_BYTES_PER_TRIAL = MEMORY_INTERVENTION_EXECUTION_MAX_RECORD_BYTES + 256

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_REPORT_FILENAME

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_REPORT_FILENAME

EXTERNAL_PRIVATE_MEMORY_ABLATION_REPORT_FILENAME = 'memory-experiment-report.json'

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION

EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION = 1

Release source · Runtime guarantees · Capability guides

EXTERNAL_PRIVATE_MEMORY_ABLATION_TRIAL_BUDGET_KEY

from cayu.evals import EXTERNAL_PRIVATE_MEMORY_ABLATION_TRIAL_BUDGET_KEY

EXTERNAL_PRIVATE_MEMORY_ABLATION_TRIAL_BUDGET_KEY = 'cayu:private-memory:trial-budget'

Release source · Runtime guarantees · Capability guides

ExternalPrivateEvalCorpus

from cayu.evals import ExternalPrivateEvalCorpus

One bounded standard Evals corpus loaded from an approved private root.

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

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
document	EvalCorpusDocument	required
source_path	Path	required
approved_private_root	Path	required
source_sha256	str	required

close (method)

ExternalPrivateEvalCorpus.close() -> None

Release process-local filesystem authority retained by this corpus.

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationArtifactPaths

from cayu.evals import ExternalPrivateMemoryAblationArtifactPaths

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

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_directory	Path	required
report_path	Path	required
methodology_path	Path	required
completion_path	Path	required

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationAuthorization

from cayu.evals import ExternalPrivateMemoryAblationAuthorization

Application-owned authority and hard ceilings checked before provider work.

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]	EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION
authorization_id	StrictStr	Field(max_length=256)
valid_from	datetime	required
valid_through	datetime	required
corpus_revision	StrictStr	Field(min_length=71, max_length=71)
suite_id	StrictStr	Field(max_length=128)
experiment_revision	StrictStr	Field(min_length=71, max_length=71)
schedule_policy_revision	StrictStr	Field(min_length=71, max_length=71)
target_key	StrictStr	Field(max_length=128)
application_release_id	StrictStr	Field(max_length=256)
app_manifest_fingerprint	StrictStr	Field(min_length=64, max_length=64)
snapshot_fingerprint	StrictStr	Field(min_length=64, max_length=64)
evaluator_fingerprint	StrictStr	Field(min_length=64, max_length=64)
provider_name	StrictStr	Field(max_length=256)
model	StrictStr	Field(max_length=256)
provider_configuration_fingerprint	StrictStr	Field(min_length=64, max_length=64)
evidence_collector_fingerprint	StrictStr | None	Field(default=None, min_length=64, max_length=64)
evidence_policy_revision	StrictStr	Field(min_length=71, max_length=71)
pricing_profile_fingerprint	StrictStr | None	Field(default=None, min_length=71, max_length=71)
redaction_policy_revision	StrictStr	Field(min_length=71, max_length=71)
retention_policy_revision	StrictStr	Field(min_length=71, max_length=71)
state_storage_id	StrictStr	Field(max_length=256)
report_destination_id	StrictStr	Field(max_length=256)
report_destination_fingerprint	StrictStr	Field(min_length=64, max_length=64)
execution_mode	ExternalPrivateMemoryAblationExecutionMode	required
context_preparation	Literal['none', 'compact_then_resume']	'none'
live_execution_authorization_id	StrictStr | None	Field(default=None, max_length=256)
allowed_variant_ids	tuple[StrictStr, ...]	Field(min_length=2, max_length=128)
allowed_variant_kinds	tuple[MemoryInterventionKind, ...]	Field(min_length=2, max_length=len(MemoryInterventionKind))
minimum_cases	StrictInt	Field(ge=1, le=1000)
maximum_cases	StrictInt	Field(ge=1, le=1000)
minimum_repetitions	StrictInt	Field(ge=1, le=1000)
maximum_repetitions	StrictInt	Field(ge=1, le=1000)
maximum_total_trials	StrictInt	Field(ge=2, le=100000)
maximum_concurrency	Literal[1]	1
maximum_timeout_seconds	StrictInt	Field(ge=1, le=86400)
maximum_model_steps	StrictInt	Field(ge=1, le=256)
maximum_report_evidence_bytes_per_trial	StrictInt	Field(ge=EXTERNAL_PRIVATE_MEMORY_ABLATION_MIN_REPORT_EVIDENCE_BYTES_PER_TRIAL, le=EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_REPORT_EVIDENCE_BYTES_PER_TRIAL)
maximum_total_tokens_per_trial	StrictInt | None	Field(default=None, ge=1, le=MAX_DURABLE_JSON_INTEGER)
maximum_estimated_cost_total	Decimal | None	Field(default=None, gt=Decimal(0))
cost_currency	StrictStr | None	Field(default=None, min_length=3, max_length=16)
maximum_supplemental_evidence_bytes_per_trial	StrictInt | None	Field(default=None, ge=1, le=EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_SUPPLEMENTAL_BYTES_PER_TRIAL)
cache_evidence_policy	ExternalPrivateMemoryAblationCacheEvidencePolicy	required

validate_integer_fields (method)

ExternalPrivateMemoryAblationAuthorization.validate_integer_fields(value: object, info) -> object

validate_identity_text (method)

ExternalPrivateMemoryAblationAuthorization.validate_identity_text(value: str | None, info) -> str | None

validate_fingerprints (method)

ExternalPrivateMemoryAblationAuthorization.validate_fingerprints(value: str | None, info) -> str | None

validate_revisions (method)

ExternalPrivateMemoryAblationAuthorization.validate_revisions(value: str | None, info) -> str | None

validate_datetimes (method)

ExternalPrivateMemoryAblationAuthorization.validate_datetimes(value: datetime, info) -> datetime

validate_variant_ids (method)

ExternalPrivateMemoryAblationAuthorization.validate_variant_ids(value: object) -> object

validate_variant_kinds (method)

ExternalPrivateMemoryAblationAuthorization.validate_variant_kinds(value: object) -> object

validate_currency (method)

ExternalPrivateMemoryAblationAuthorization.validate_currency(value: str | None) -> str | None

validate_total_cost_ceiling (method)

ExternalPrivateMemoryAblationAuthorization.validate_total_cost_ceiling(value: Decimal | None) -> Decimal | None

validate_authority (method)

ExternalPrivateMemoryAblationAuthorization.validate_authority() -> Self

fingerprint (property)

ExternalPrivateMemoryAblationAuthorization.fingerprint() -> str

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationCacheEvidencePolicy

from cayu.evals import ExternalPrivateMemoryAblationCacheEvidencePolicy

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
REQUIRED	class attribute	'required'
BEST_EFFORT	class attribute	'best_effort'
UNAVAILABLE	class attribute	'unavailable'

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationCacheEvidenceState

from cayu.evals import ExternalPrivateMemoryAblationCacheEvidenceState

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

ExternalPrivateMemoryAblationDestination

from cayu.evals import ExternalPrivateMemoryAblationDestination

Private state authority plus one not-yet-created artifact directory.

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

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_storage_id	str	required
destination_id	str	required
approved_private_root	Path	required
state_directory	Path	required
artifact_directory	Path	required

close (method)

ExternalPrivateMemoryAblationDestination.close() -> None

Release process-local filesystem authority retained by this destination.

fingerprint (property)

ExternalPrivateMemoryAblationDestination.fingerprint() -> str

Bind the application identity to the exact canonical private paths.

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationEvidenceCollector

from cayu.evals import ExternalPrivateMemoryAblationEvidenceCollector

Application adapter for bounded cost, cache, retry, and overhead evidence.

Bases: ABC.

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
collector_fingerprint	str	required

collect (method)

async ExternalPrivateMemoryAblationEvidenceCollector.collect(*, trial: ExternalPrivateMemoryAblationTrial, outcome: MemoryInterventionTrialOutcome) -> ExternalPrivateMemoryAblationSupplementalEvidence

Project safe operational evidence for one terminal trial.

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationExecutionMode

from cayu.evals import ExternalPrivateMemoryAblationExecutionMode

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
HERMETIC	class attribute	'hermetic'
LIVE	class attribute	'live'

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationLimitation

from cayu.evals import ExternalPrivateMemoryAblationLimitation

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
ACCOUNTING_EVIDENCE_UNAVAILABLE	class attribute	'accounting_evidence_unavailable'
CACHE_EVIDENCE_UNAVAILABLE	class attribute	'cache_evidence_unavailable'
INCOMPLETE_TRIAL_MATRIX	class attribute	'incomplete_trial_matrix'
MEMORY_OVERHEAD_UNAVAILABLE	class attribute	'memory_overhead_unavailable'
REPORT_EVIDENCE_FAILED	class attribute	'report_evidence_failed'
REPORT_EVIDENCE_OMITTED	class attribute	'report_evidence_omitted'
RUNNER_STOPPED	class attribute	'runner_stopped'

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationMethodology

from cayu.evals import ExternalPrivateMemoryAblationMethodology

Bounded, content-free methodology sidecar for one private campaign report.

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.external-private-memory-ablation-methodology']	'cayu.external-private-memory-ablation-methodology'
schema_version	Literal[1]	EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION
revision	StrictStr	Field(min_length=71, max_length=71)
preflight_revision	StrictStr	Field(min_length=71, max_length=71)
authorization_id	StrictStr	Field(max_length=256)
authorization_fingerprint	StrictStr	Field(min_length=64, max_length=64)
corpus_origin	Literal['external_private']	'external_private'
corpus_revision	StrictStr	Field(min_length=71, max_length=71)
corpus_source_sha256	StrictStr	Field(min_length=64, max_length=64)
suite_id	StrictStr	Field(max_length=128)
experiment_id	StrictStr	Field(max_length=128)
experiment_revision	StrictStr	Field(min_length=71, max_length=71)
schedule_policy_revision	StrictStr	Field(min_length=71, max_length=71)
target_key	StrictStr	Field(max_length=128)
application_release_id	StrictStr	Field(max_length=256)
app_manifest_fingerprint	StrictStr	Field(min_length=64, max_length=64)
snapshot_fingerprint	StrictStr	Field(min_length=64, max_length=64)
provider_name	StrictStr	Field(max_length=256)
model	StrictStr	Field(max_length=256)
provider_configuration_fingerprint	StrictStr	Field(min_length=64, max_length=64)
executor_authority_fingerprint	StrictStr	Field(min_length=64, max_length=64)
executor_binding_revision	StrictStr	Field(min_length=71, max_length=71)
evidence_collector_fingerprint	StrictStr | None	Field(default=None, min_length=64, max_length=64)
evidence_policy_revision	StrictStr	Field(min_length=71, max_length=71)
pricing_profile_fingerprint	StrictStr | None	Field(default=None, min_length=71, max_length=71)
redaction_policy_revision	StrictStr	Field(min_length=71, max_length=71)
retention_policy_revision	StrictStr	Field(min_length=71, max_length=71)
state_storage_id	StrictStr	Field(max_length=256)
state_files_revision	StrictStr	Field(min_length=71, max_length=71)
report_destination_id	StrictStr	Field(max_length=256)
report_destination_fingerprint	StrictStr	Field(min_length=64, max_length=64)
execution_mode	ExternalPrivateMemoryAblationExecutionMode	required
live_execution_authorization_id	StrictStr | None	Field(default=None, max_length=256)
schedule_policy	ExternalPrivateMemoryAblationSchedulePolicy	required
started_at	datetime	required
completed_at	datetime	required
status	ExternalPrivateMemoryAblationRunStatus	required
run_failure_code	ExternalPrivateMemoryAblationRunFailureCode | None	None
failure_ordinal	StrictInt | None	Field(default=None, ge=1, le=100000)
report_revision	StrictStr	Field(min_length=71, max_length=71)
trials	tuple[ExternalPrivateMemoryAblationTrialMethodology, ...]	Field(min_length=2, max_length=100000)
limitations	tuple[ExternalPrivateMemoryAblationLimitation, ...]	Field(default=(), max_length=EXTERNAL_PRIVATE_MEMORY_ABLATION_MAX_LIMITATIONS)

validate_integer_fields (method)

ExternalPrivateMemoryAblationMethodology.validate_integer_fields(value: object, info) -> object

validate_text (method)

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

validate_fingerprints (method)

ExternalPrivateMemoryAblationMethodology.validate_fingerprints(value: str | None, info) -> str | None

validate_revisions (method)

ExternalPrivateMemoryAblationMethodology.validate_revisions(value: str | None, info) -> str | None

validate_datetimes (method)

ExternalPrivateMemoryAblationMethodology.validate_datetimes(value: datetime, info) -> datetime

copy_schedule_policy (method)

ExternalPrivateMemoryAblationMethodology.copy_schedule_policy(value: object) -> object

validate_limitations (method)

ExternalPrivateMemoryAblationMethodology.validate_limitations(value: object) -> object

validate_methodology (method)

ExternalPrivateMemoryAblationMethodology.validate_methodology() -> Self

create (method)

ExternalPrivateMemoryAblationMethodology.create(**values: Any) -> ExternalPrivateMemoryAblationMethodology

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationResult

from cayu.evals import ExternalPrivateMemoryAblationResult

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

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
report	MemoryExperimentReport	required
methodology	ExternalPrivateMemoryAblationMethodology	required

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationRunFailureCode

from cayu.evals import ExternalPrivateMemoryAblationRunFailureCode

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
AUTHORIZATION_EXPIRED	class attribute	'authorization_expired'
EXECUTION_AUTHORITY_CHANGED	class attribute	'execution_authority_changed'
EXECUTION_FAILED	class attribute	'execution_failed'
EVIDENCE_COLLECTION_FAILED	class attribute	'evidence_collection_failed'
REPORT_EVIDENCE_FAILED	class attribute	'report_evidence_failed'
REQUIRED_EVIDENCE_UNAVAILABLE	class attribute	'required_evidence_unavailable'
TARGET_IDENTITY_CHANGED	class attribute	'target_identity_changed'

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationRunStatus

from cayu.evals import ExternalPrivateMemoryAblationRunStatus

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

ExternalPrivateMemoryAblationScheduleEntry

from cayu.evals import ExternalPrivateMemoryAblationScheduleEntry

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
ordinal	StrictInt	Field(ge=1, le=100000)
case_id	StrictStr	Field(max_length=128)
case_revision	StrictStr	Field(min_length=71, max_length=71)
repetition	StrictInt	Field(ge=1, le=1000)
variant_id	StrictStr	Field(max_length=128)
execution_id	StrictStr	Field(min_length=64, max_length=64)

validate_integers (method)

ExternalPrivateMemoryAblationScheduleEntry.validate_integers(value: object, info) -> object

validate_ids (method)

ExternalPrivateMemoryAblationScheduleEntry.validate_ids(value: str, info) -> str

validate_case_revision (method)

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

validate_execution_id (method)

ExternalPrivateMemoryAblationScheduleEntry.validate_execution_id(value: str, info) -> str

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationSchedulePolicy

from cayu.evals import ExternalPrivateMemoryAblationSchedulePolicy

Versioned policy that deterministically realizes one exact trial order.

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]	EXTERNAL_PRIVATE_MEMORY_ABLATION_SCHEMA_VERSION
strategy	ExternalPrivateMemoryAblationScheduleStrategy	required
seed_fingerprint	StrictStr | None	Field(default=None, min_length=64, max_length=64)
max_concurrency	Literal[1]	1

validate_integer_literals (method)

ExternalPrivateMemoryAblationSchedulePolicy.validate_integer_literals(value: object, info) -> object

validate_seed (method)

ExternalPrivateMemoryAblationSchedulePolicy.validate_seed(value: str | None, info) -> str | None

validate_strategy (method)

ExternalPrivateMemoryAblationSchedulePolicy.validate_strategy() -> Self

revision (property)

ExternalPrivateMemoryAblationSchedulePolicy.revision() -> str

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationScheduleStrategy

from cayu.evals import ExternalPrivateMemoryAblationScheduleStrategy

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
FIXED	class attribute	'fixed'
DETERMINISTIC_RANDOMIZED	class attribute	'deterministic_randomized'
COUNTERBALANCED	class attribute	'counterbalanced'

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationSupplementalEvidence

from cayu.evals import ExternalPrivateMemoryAblationSupplementalEvidence

Application-projected operational evidence; never raw provider or prompt data.

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
accounting_side	PairedCostQualitySide | None	None
memory_overhead	MemoryPreparationOverheadEvidence | None	None
cache_evidence_state	ExternalPrivateMemoryAblationCacheEvidenceState	required
cache_read_tokens	StrictInt | None	Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
cache_write_tokens	StrictInt | None	Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
provider_retry_count	StrictInt	Field(default=0, ge=0, le=MAX_DURABLE_JSON_INTEGER)

validate_integer_fields (method)

ExternalPrivateMemoryAblationSupplementalEvidence.validate_integer_fields(value: object, info) -> object

copy_accounting_side (method)

ExternalPrivateMemoryAblationSupplementalEvidence.copy_accounting_side(value: object) -> object

copy_memory_overhead (method)

ExternalPrivateMemoryAblationSupplementalEvidence.copy_memory_overhead(value: object) -> object

validate_cache_evidence (method)

ExternalPrivateMemoryAblationSupplementalEvidence.validate_cache_evidence() -> Self

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationTrial

from cayu.evals import ExternalPrivateMemoryAblationTrial

Process-private input for one exact experiment matrix coordinate.

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

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	str	required
repetition	int	required
variant_id	str	required
request	MemoryInterventionTrialRequest	required

coordinate (property)

ExternalPrivateMemoryAblationTrial.coordinate() -> tuple[str, int, str]

Release source · Runtime guarantees · Capability guides

ExternalPrivateMemoryAblationTrialMethodology

from cayu.evals import ExternalPrivateMemoryAblationTrialMethodology

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
ordinal	StrictInt	Field(ge=1, le=100000)
case_id	StrictStr	Field(max_length=128)
case_revision	StrictStr	Field(min_length=71, max_length=71)
repetition	StrictInt	Field(ge=1, le=1000)
variant_id	StrictStr	Field(max_length=128)
execution_id	StrictStr	Field(min_length=64, max_length=64)
execution_status	MemoryInterventionExecutionStatus | None	None
availability	MemoryTrialAvailability	required
cache_evidence_state	ExternalPrivateMemoryAblationCacheEvidenceState	required
cache_read_tokens	StrictInt | None	Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
cache_write_tokens	StrictInt | None	Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
provider_retry_count	StrictInt | None	Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
accounting_evidence_available	StrictBool	required
memory_overhead_available	StrictBool	required

validate_integer_fields (method)

ExternalPrivateMemoryAblationTrialMethodology.validate_integer_fields(value: object, info) -> object

validate_ids (method)

ExternalPrivateMemoryAblationTrialMethodology.validate_ids(value: str, info) -> str

validate_case_revision (method)

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

validate_execution_id (method)

ExternalPrivateMemoryAblationTrialMethodology.validate_execution_id(value: str, info) -> str

validate_evidence (method)

ExternalPrivateMemoryAblationTrialMethodology.validate_evidence() -> Self

Release source · Runtime guarantees · Capability guides

load_external_private_memory_ablation_corpus

from cayu.evals import load_external_private_memory_ablation_corpus

Load one standard bounded Evals document without publishing its private bytes.

load_external_private_memory_ablation_corpus(path: str | Path, *, approved_private_root: str | Path) -> ExternalPrivateEvalCorpus

Release source · Runtime guarantees · Capability guides

prepare_external_private_memory_ablation

from cayu.evals import prepare_external_private_memory_ablation

Resolve the complete private campaign authority before provider work.

prepare_external_private_memory_ablation(*, corpus: ExternalPrivateEvalCorpus, target: CorpusTarget, snapshot: AgentSnapshot, experiment: MemoryExperimentReportRequest, trials: Sequence[ExternalPrivateMemoryAblationTrial], executor: MemoryInterventionExecutor, authorization: ExternalPrivateMemoryAblationAuthorization, schedule_policy: ExternalPrivateMemoryAblationSchedulePolicy, destination: ExternalPrivateMemoryAblationDestination, now: datetime | None=None) -> PreparedExternalPrivateMemoryAblation

Release source · Runtime guarantees · Capability guides

PreparedExternalPrivateMemoryAblation

from cayu.evals import PreparedExternalPrivateMemoryAblation

Fully validated process-local authority ready for bounded execution.

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

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
corpus	ExternalPrivateEvalCorpus	required
target	CorpusTarget	required
target_identity	EvaluationTargetIdentity	required
snapshot	AgentSnapshot	required
experiment	MemoryExperimentReportRequest	required
authorization	ExternalPrivateMemoryAblationAuthorization	required
schedule_policy	ExternalPrivateMemoryAblationSchedulePolicy	required
destination	ExternalPrivateMemoryAblationDestination	required
scheduled_trials	tuple[ExternalPrivateMemoryAblationTrial, ...]	required
schedule	tuple[ExternalPrivateMemoryAblationScheduleEntry, ...]	required
executor_authority	MemoryInterventionExecutorAuthority	required
executor_binding_revision	str	required
state_files_revision	str	required
preflight_revision	str	required

close (method)

PreparedExternalPrivateMemoryAblation.close() -> None

Release the campaign-owned corpus and destination authority leases.

Release source · Runtime guarantees · Capability guides

run_external_private_memory_ablation

from cayu.evals import run_external_private_memory_ablation

Execute the exact preflight schedule and retain every terminal or missing row.

async run_external_private_memory_ablation(prepared: PreparedExternalPrivateMemoryAblation, executor: MemoryInterventionExecutor, *, evidence_collector: ExternalPrivateMemoryAblationEvidenceCollector | None=None, clock: Callable[[], datetime] | None=None) -> ExternalPrivateMemoryAblationResult

Release source · Runtime guarantees · Capability guides

write_external_private_memory_ablation_artifacts

from cayu.evals import write_external_private_memory_ablation_artifacts

Publish a complete local private artifact directory exactly once.

write_external_private_memory_ablation_artifacts(result: ExternalPrivateMemoryAblationResult, destination: ExternalPrivateMemoryAblationDestination) -> ExternalPrivateMemoryAblationArtifactPaths

Release source · Runtime guarantees · Capability guides