cayu.sessions.child_results

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.

`CHILD_SESSION_RESULT_PROJECTION_VERSION`

from cayu.sessions import CHILD_SESSION_RESULT_PROJECTION_VERSION

CHILD_SESSION_RESULT_PROJECTION_VERSION = 'cayu.child-session-result.v1'

Release source · Runtime guarantees · Capability guides

`ChildSessionResultProjection`

from cayu.sessions import ChildSessionResultProjection

A separately authorized, bounded terminal child-result read.

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
`schema_version`	`Literal['cayu.child-session-result.v1']`	`CHILD_SESSION_RESULT_PROJECTION_VERSION`
`parent_session_id`	`str`	`Field(max_length=CHILD_SESSION_PUBLIC_ALIAS_MAX_CHARS)`
`child_session_id`	`str`	`Field(max_length=CHILD_SESSION_PUBLIC_ALIAS_MAX_CHARS)`
`terminal_occurrence_id`	`str`	`Field(max_length=CHILD_SESSION_PUBLIC_OCCURRENCE_ID_MAX_CHARS)`
`state`	`ChildSessionLifecycleState`	`required`
`result_text`	`str`	`Field(max_length=MAX_CHILD_SESSION_RESULT_MAX_CHARS)`
`result_truncated`	`StrictBool`	`required`
`result_chars`	`StrictInt`	`Field(ge=0, le=MAX_CHILD_SESSION_RESULT_MAX_CHARS)`
`max_chars`	`StrictInt`	`Field(ge=1, le=MAX_CHILD_SESSION_RESULT_MAX_CHARS)`

validate_identity (method)

ChildSessionResultProjection.validate_identity(value: str, info: Any) -> str

validate_terminal_occurrence_id (method)

ChildSessionResultProjection.validate_terminal_occurrence_id(value: str) -> str

validate_terminal_bound (method)

ChildSessionResultProjection.validate_terminal_bound() -> ChildSessionResultProjection

Release source · Runtime guarantees · Capability guides

`ChildSessionResultUnavailable`

from cayu.sessions import ChildSessionResultUnavailable

The requested child result is absent, stale, or outside parent authority.

Bases: LookupError.

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

Release source · Runtime guarantees · Capability guides

`DEFAULT_CHILD_SESSION_RESULT_MAX_CHARS`

from cayu.sessions import DEFAULT_CHILD_SESSION_RESULT_MAX_CHARS

DEFAULT_CHILD_SESSION_RESULT_MAX_CHARS = 12000

Release source · Runtime guarantees · Capability guides

`MAX_CHILD_SESSION_RESULT_MAX_CHARS`

from cayu.sessions import MAX_CHILD_SESSION_RESULT_MAX_CHARS

MAX_CHILD_SESSION_RESULT_MAX_CHARS = LATEST_TRANSCRIPT_TEXT_MAX_CHARS

Release source · Runtime guarantees · Capability guides

`project_terminal_child_session_result`

from cayu.sessions import project_terminal_child_session_result

Resolve one exact terminal occurrence under direct-parent authority.

reference is a locator, not a capability. The caller must supply the private parent session authority, and this function revalidates the current direct-parent relationship and exact canonical terminal event before it reads any child content.

async project_terminal_child_session_result(session_store: SessionStore, *, parent_session_id: str, reference: ChildSessionResultReference, max_chars: int=DEFAULT_CHILD_SESSION_RESULT_MAX_CHARS) -> ChildSessionResultProjection

Release source · Runtime guarantees · Capability guides