cayu.runtime.execution_units

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.

`BudgetLimitIdentity`

from cayu import BudgetLimitIdentity

Opaque runtime identity of one effective configured budget limit.

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
`budget_limit_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`

validate_budget_limit_id (method)

BudgetLimitIdentity.validate_budget_limit_id(value: str) -> str

payload (method)

BudgetLimitIdentity.payload() -> dict[str, str]

Release source · Runtime guarantees · Capability guides

`copy_model_attempt_identity`

from cayu import copy_model_attempt_identity

copy_model_attempt_identity(identity: ModelAttemptIdentity) -> ModelAttemptIdentity

Release source · Runtime guarantees · Capability guides

`copy_model_step_identity`

from cayu import copy_model_step_identity

copy_model_step_identity(identity: ModelStepIdentity) -> ModelStepIdentity

Release source · Runtime guarantees · Capability guides

`copy_tool_round_identity`

from cayu import copy_tool_round_identity

copy_tool_round_identity(identity: ToolRoundIdentity) -> ToolRoundIdentity

Release source · Runtime guarantees · Capability guides

`ModelAttemptIdentity`

from cayu import ModelAttemptIdentity

Runtime-owned identity of one actual provider-dispatch attempt.

Bases: ModelStepIdentity.

Fields and attributes

Name	Type	Default
`model_step_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`
`model_attempt_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`

validate_model_step_id (method)

ModelAttemptIdentity.validate_model_step_id(value: str) -> str

payload (method)

ModelAttemptIdentity.payload() -> dict[str, str]

new_attempt (method)

ModelAttemptIdentity.new_attempt() -> ModelAttemptIdentity

validate_model_attempt_id (method)

ModelAttemptIdentity.validate_model_attempt_id(value: str) -> str

new_tool_round (method)

ModelAttemptIdentity.new_tool_round() -> ToolRoundIdentity

Release source · Runtime guarantees · Capability guides

`ModelStepIdentity`

from cayu import ModelStepIdentity

Runtime-owned identity of one logical model-loop decision.

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`model_step_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`

validate_model_step_id (method)

ModelStepIdentity.validate_model_step_id(value: str) -> str

payload (method)

ModelStepIdentity.payload() -> dict[str, str]

new_attempt (method)

ModelStepIdentity.new_attempt() -> ModelAttemptIdentity

Release source · Runtime guarantees · Capability guides

`new_model_step_identity`

from cayu import new_model_step_identity

Allocate a globally unique logical model-step identity.

new_model_step_identity() -> ModelStepIdentity

Release source · Runtime guarantees · Capability guides

`ToolRoundIdentity`

from cayu import ToolRoundIdentity

Runtime-owned identity of one tool group requested by a model attempt.

Bases: ModelAttemptIdentity.

Fields and attributes

Name	Type	Default
`model_step_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`
`model_attempt_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`
`tool_round_id`	`str`	`Field(max_length=EXECUTION_UNIT_ID_MAX_CHARS)`

validate_model_step_id (method)

ToolRoundIdentity.validate_model_step_id(value: str) -> str

payload (method)

ToolRoundIdentity.payload() -> dict[str, str]

new_attempt (method)

ToolRoundIdentity.new_attempt() -> ModelAttemptIdentity

validate_model_attempt_id (method)

ToolRoundIdentity.validate_model_attempt_id(value: str) -> str

new_tool_round (method)

ToolRoundIdentity.new_tool_round() -> ToolRoundIdentity

validate_tool_round_id (method)

ToolRoundIdentity.validate_tool_round_id(value: str) -> str

matches_payload (method)

ToolRoundIdentity.matches_payload(payload: Mapping[str, object]) -> bool

Return whether a payload carries this complete, unmodified identity.

Release source · Runtime guarantees · Capability guides