Skip to content

cayu.runtime.execution_profiles

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.

build_execution_profile_identity

Section titled “build_execution_profile_identity”
from cayu import build_execution_profile_identity

Build a profile without retaining raw prompts, schemas, or tool names.

build_execution_profile_identity(*, runtime_name: str, runtime_version: str | None, provider_name: str, model: str, durable_system_prompt: str | None, direct_tools: Iterable[Mapping[str, Any]], tool_catalogue_revision: str, tool_implementations: Iterable[Mapping[str, Any]] | None=None, tool_implementations_process_local: bool=False, tool_implementations_application_versioned: bool=False, tool_view_grants: Mapping[str, Any] | None=None, execution_policies: Mapping[str, Any] | None=None, execution_policies_process_local: bool=False, execution_policies_application_versioned: bool=False, invocation_policies: Iterable[Mapping[str, Any]]=(), invocation_policies_process_local: bool=False, invocation_policies_application_versioned: bool=False, runtime_hooks: Iterable[Mapping[str, Any]]=(), runtime_hooks_process_local: bool=False, runtime_hooks_application_versioned: bool=False, execution_environment: Mapping[str, Any] | None=None, execution_environment_process_local: bool=False, execution_environment_application_versioned: bool=False, effect_authority: Mapping[str, Any] | None=None, egress_authority: EgressAuthorityIdentity | None=None, context_selection: Mapping[str, Any] | None=None, context_selection_process_local: bool=False, context_selection_application_versioned: bool=False, automatic_recall: Mapping[str, Any] | None=None, automatic_recall_process_local: bool=False, automatic_recall_application_versioned: bool=False, context_compaction: Mapping[str, Any] | None=None, context_compaction_process_local: bool=False, context_compaction_application_versioned: bool=False, live_state_projection: Mapping[str, Any] | None=None, provider_adapter: Mapping[str, Any] | None=None, provider_adapter_process_local: bool=False, provider_adapter_application_versioned: bool=False, provider_request_policy: Mapping[str, Any] | None=None, provider_request_policy_process_local: bool=False, provider_request_policy_application_versioned: bool=False, application_budget_policy: Mapping[str, Any] | None=None, invocation_budget_policy: Mapping[str, Any] | None=None, structured_output: Mapping[str, Any] | None=None, finalization: Mapping[str, Any] | None=None, runtime_build_provenance: RuntimeBuildProvenance | None=None) -> ExecutionProfileIdentity

Release source · Runtime guarantees · Capability guides

ExecutionProfileAdoptionRejected

Section titled “ExecutionProfileAdoptionRejected”
from cayu import ExecutionProfileAdoptionRejected

Raised after policy durably rejects an explicit adoption request.

Bases: ExecutionProfileMismatchError.

init (method)

Section titled “init (method)”
ExecutionProfileAdoptionRejected.__init__(*, session_id: str, expected_profile_fingerprint: str, candidate_profile_fingerprint: str, changed_component_classes: tuple[ExecutionProfileComponentClass, ...], expected_profile: ExecutionProfileIdentity | None=None, candidate_profile: ExecutionProfileIdentity | None=None) -> None

Release source · Runtime guarantees · Capability guides

ExecutionProfileMigrationRequired

Section titled “ExecutionProfileMigrationRequired”
from cayu import ExecutionProfileMigrationRequired

Raised after policy records that an explicit migration is required.

Bases: ExecutionProfileMismatchError.

init (method)

Section titled “init (method)”
ExecutionProfileMigrationRequired.__init__(*, session_id: str, expected_profile_fingerprint: str, candidate_profile_fingerprint: str, changed_component_classes: tuple[ExecutionProfileComponentClass, ...], expected_profile: ExecutionProfileIdentity | None=None, candidate_profile: ExecutionProfileIdentity | None=None) -> None

Release source · Runtime guarantees · Capability guides

ExecutionProfileMismatchError

Section titled “ExecutionProfileMismatchError”
from cayu import ExecutionProfileMismatchError

Raised after durable evidence rejects a changed execution profile.

Bases: RuntimeError.

init (method)

Section titled “init (method)”
ExecutionProfileMismatchError.__init__(*, session_id: str, expected_profile_fingerprint: str, candidate_profile_fingerprint: str, changed_component_classes: tuple[ExecutionProfileComponentClass, ...], expected_profile: ExecutionProfileIdentity | None=None, candidate_profile: ExecutionProfileIdentity | None=None) -> None

Release source · Runtime guarantees · Capability guides

ExecutionProfilePolicy

Section titled “ExecutionProfilePolicy”
from cayu import ExecutionProfilePolicy

Application-owned compatibility and adoption authority.

Bases: ABC.

identity (property)

Section titled “identity (property)”
ExecutionProfilePolicy.identity() -> str

Return a stable, versioned, non-secret policy identity.

decide (method)

Section titled “decide (method)”
async ExecutionProfilePolicy.decide(request: ExecutionProfilePolicyRequest) -> ExecutionProfilePolicyResult

Classify one non-equal profile before governed work begins.

Release source · Runtime guarantees · Capability guides

ExecutionProfilePolicyError

Section titled “ExecutionProfilePolicyError”
from cayu import ExecutionProfilePolicyError

Raised when configured profile policy cannot produce an authoritative decision.

Bases: RuntimeError.

This type’s implementation and inherited behavior are available in the linked release source.

Release source · Runtime guarantees · Capability guides