cayu.runtime.human_attention

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.

`HumanAttentionObservation`

from cayu import HumanAttentionObservation

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
`attention_id`	`str`	`required`
`state`	`AttentionState`	`required`
`observed_at`	`datetime`	`required`
`reason`	`AttentionReason`	`required`

Release source · Runtime guarantees · Capability guides

`HumanAttentionReference`

from cayu import HumanAttentionReference

Trusted SDK correlation data, not a bearer credential or decision receipt.

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`attention_id`	`str`	`Field(pattern='^attention_[0-9a-f]{64}$')`
`session_id`	`str`	`Field(min_length=1, max_length=2048)`
`session_instance_id`	`str`	`Field(min_length=1, max_length=512)`
`kind`	`AttentionKind`	`required`
`action_id`	`str`	`Field(min_length=1, max_length=4096)`
`round_id`	`str \| None`	`Field(default=None, max_length=512)`
`tool_call_id`	`str \| None`	`Field(default=None, max_length=512)`
`source_sequence`	`int`	`Field(ge=1)`

validate_identity (method)

HumanAttentionReference.validate_identity()

Release source · Runtime guarantees · Capability guides

`HumanAttentionRequest`

from cayu import HumanAttentionRequest

Safe default summary. Detailed human disclosure remains policy-controlled.

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`reference`	`HumanAttentionReference`	`required`
`summary`	`Literal['User input required.', 'Tool approval required.', 'Manual recovery required.']`	`required`

from_pending_action (method)

HumanAttentionRequest.from_pending_action(action: PendingActionRecord) -> HumanAttentionRequest | None

Project canonical query results; delegated rows are navigation only.

Release source · Runtime guarantees · Capability guides