cayu.tasks.graphs

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.

`TaskGraphConflict`

from cayu.tasks import TaskGraphConflict

A graph operation conflicts with retained identity or lifecycle authority.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides

`TaskGraphCreate`

from cayu.tasks import TaskGraphCreate

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
`graph_id`	`str`	`required`
`nodes`	`tuple[TaskGraphNode, ...]`	`Field(min_length=1, max_length=TASK_GRAPH_MAX_NODES)`

validate_identity (method)

TaskGraphCreate.validate_identity(value: str) -> str

copy_nodes (method)

TaskGraphCreate.copy_nodes(value: object) -> tuple[TaskGraphNode, ...]

validate_graph (method)

TaskGraphCreate.validate_graph() -> TaskGraphCreate

Release source · Runtime guarantees · Capability guides

`TaskGraphCreationReceipt`

from cayu.tasks import TaskGraphCreationReceipt

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`access_invocation`	`TaskInvocation \| None`	`Field(default=None, exclude_if=lambda v: v is None)`
`graph_id`	`GraphIdentifier`	`required`
`request_sha256`	`str`	`Field(pattern='^[0-9a-f]{64}$')`
`submitted_request_sha256`	`str`	`Field(pattern='^[0-9a-f]{64}$')`
`task_ids`	`GraphIdentifiers`	`Field(min_length=1)`
`accepted_at`	`datetime`	`required`

validate_time (method)

TaskGraphCreationReceipt.validate_time(value: datetime) -> datetime

Release source · Runtime guarantees · Capability guides

`TaskGraphEvent`

from cayu.tasks import TaskGraphEvent

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`graph_id`	`GraphIdentifier`	`required`
`sequence`	`StrictInt`	`Field(ge=1, le=MAX_PORTABLE_JSON_INTEGER)`
`type`	`TaskGraphEventType`	`required`
`occurred_at`	`datetime`	`required`
`task_id`	`GraphIdentifier \| None`	`None`
`status`	`TaskStatus \| None`	`None`
`prerequisite_task_ids`	`GraphIdentifiers`	`()`

validate_time (method)

TaskGraphEvent.validate_time(value: datetime) -> datetime

validate_event (method)

TaskGraphEvent.validate_event() -> TaskGraphEvent

Release source · Runtime guarantees · Capability guides

`TaskGraphEventType`

from cayu.tasks import TaskGraphEventType

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`WAITING_GROUP`	`class attribute`	`'task.group_waiting'`
`CREATED`	`class attribute`	`'task.graph_created'`
`WAITING`	`class attribute`	`'task.dependency_waiting'`
`READY`	`class attribute`	`'task.dependencies_satisfied'`
`SKIPPED`	`class attribute`	`'task.dependency_skipped'`
`TERMINAL`	`class attribute`	`'task.graph_member_terminal'`

Release source · Runtime guarantees · Capability guides

`TaskGraphMember`

from cayu.tasks import TaskGraphMember

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`task_id`	`GraphIdentifier`	`required`
`prerequisite_task_ids`	`GraphIdentifiers`	`required`
`status`	`TaskStatus`	`required`
`failed_prerequisite_task_ids`	`GraphIdentifiers`	`()`

validate_member (method)

TaskGraphMember.validate_member() -> TaskGraphMember

Release source · Runtime guarantees · Capability guides

`TaskGraphNode`

from cayu.tasks import TaskGraphNode

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`task`	`TaskCreate`	`required`
`prerequisite_task_ids`	`tuple[str, ...]`	`Field(default=(), max_length=TASK_GRAPH_MAX_NODES)`

copy_task_request (method)

TaskGraphNode.copy_task_request(value: object) -> TaskCreate

canonical_prerequisites (method)

TaskGraphNode.canonical_prerequisites(value: tuple[str, ...]) -> tuple[str, ...]

Release source · Runtime guarantees · Capability guides

`TaskGraphSnapshot`

from cayu.tasks import TaskGraphSnapshot

Bases: BaseModel.

Fields and attributes

Name	Type	Default
`receipt`	`TaskGraphCreationReceipt`	`required`
`members`	`tuple[TaskGraphMember, ...]`	`Field(min_length=1, max_length=TASK_GRAPH_MAX_NODES)`
`last_sequence`	`StrictInt`	`Field(ge=1, le=MAX_PORTABLE_JSON_INTEGER)`

validate_snapshot (method)

TaskGraphSnapshot.validate_snapshot() -> TaskGraphSnapshot

Release source · Runtime guarantees · Capability guides

`TaskGraphUnavailable`

from cayu.tasks import TaskGraphUnavailable

Complete authoritative graph evidence is unavailable.

Bases: ValueError.

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

Release source · Runtime guarantees · Capability guides