cayu.evals.process_inspection

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.

EvalProcessCaseInspectionV1

from cayu.evals import EvalProcessCaseInspectionV1

Bases: _Model.

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
worker_index	int | None	required
claim_state	Literal['queued', 'claimed', 'dispatching', 'completed'] | None	None
observed_state	Literal['not_observed', 'started', 'finished', 'interrupted']	'not_observed'
observed_trial_status	EvalStatus | None	None
observed_error	str | None	Field(default=None, max_length=4096)
observed_exception_type	str | None	Field(default=None, max_length=512)
result_status	EvalStatus | None	None
score	float | None	None
error	str | None	None
unavailable_reason	str | None	None
assertion_failures	tuple[dict[str, Any], ...]	()
session	EvalSessionReferenceV1 | None	None
session_inspection	EvalSessionInspectionV1 | None	None
limitations	tuple[str, ...]	()

Release source · Runtime guarantees · Capability guides

EvalProcessInspectionV1

from cayu.evals import EvalProcessInspectionV1

Bases: _Model.

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
launch_id	str	required
observed_at	datetime	required
phase	Literal['preparing', 'admitted', 'completed', 'incomplete']	required
target	str	required
started_at	datetime | None	None
suite_id	str | None	None
plan_fingerprint	str | None	None
plan_metadata	dict[str, Any]	Field(default_factory=dict)
max_concurrency	int	required
launch_scheduling	LaunchScheduling | None	None
case_timeout_seconds	float | None	required
supervisor_pid	int | None	None
python_version	str | None	None
runtime_build_provenance	RuntimeBuildProvenance | None	None
workers	tuple[EvalProcessWorkerInspectionV1, ...]	required
cases	tuple[EvalProcessCaseInspectionV1, ...]	required
result_status	EvalStatus | None	None
score	float | None	None
counts	dict[str, int]	required
limitations	tuple[str, ...]	()
incomplete_exception_type	str | None	None
owner_liveness	Literal['not_checked']	'not_checked'
automatic_replay	Literal[False]	False
observation_note	str	'Receipts and session reads are independent observations. Admission and PIDs do not prove a live owner. Trial observations are provisional until worker result admission. Only a validated completed marker and all admitted results establish run completion.'

Release source · Runtime guarantees · Capability guides

EvalProcessWorkerInspectionV1

from cayu.evals import EvalProcessWorkerInspectionV1

Bases: _Model.

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
index	int	required
pid	int | None	None
ready	bool	False
assigned_case_ids	tuple[str, ...]	()
result_run_id	str | None	None
progress_observed_at	datetime | None	None

Release source · Runtime guarantees · Capability guides

EvalSessionReferenceV1

from cayu.evals import EvalSessionReferenceV1

An explicit local inspection locator, never execution or recovery authority.

Bases: _Model.

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
session_id	str	Field(min_length=1, max_length=512)
sqlite_path	str | None	Field(default=None, min_length=1, max_length=4096)

absolute_path (method)

EvalSessionReferenceV1.absolute_path(value: str | None) -> str | None

Release source · Runtime guarantees · Capability guides

export_process_eval_run

from cayu.evals import export_process_eval_run

Export validated receipt/result bytes and hashes to a new private ZIP.

Only fixed native receipt names are included. Logs, databases, attachments, pending writes, and application files are not swept into the archive. The retained observation can be incomplete; export does not promote it.

export_process_eval_run(directory: str | Path, output: str | Path) -> EvalProcessInspectionV1

Release source · Runtime guarantees · Capability guides

inspect_process_eval_run

from cayu.evals import inspect_process_eval_run

Read exact native process receipts, optionally resolving explicit SQLite links.

This never imports the target factory, starts work, tests remote PIDs, or infers application-specific evidence paths. Older launches can supply a launch- and case-bound session-evidence manifest explicitly.

async inspect_process_eval_run(directory: str | Path, *, include_sessions: bool=False, session_evidence: str | Path | None=None, max_sessions: int=100, max_diagnostics: int=20, case_id: str | None=None) -> EvalProcessInspectionV1

Release source · Runtime guarantees · Capability guides