cayu.sessions.base

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.

Each definition in this module has its own page.

• ActiveModelCompletionStage: Verified snapshot of the model dispatch currently eligible to publish.
• checkpoint_root_field_projection_from_storage: Normalize bounded root-field evidence projected by a durable store.
• CheckpointRootFieldGuard: One runtime-owned validator to run inside a store read snapshot.
• CheckpointRootFieldProjection: Bounded opaque evidence for one runtime-selected root field.
• CheckpointTransform
• CompactSessionRequest: Request an explicit, application-owned compaction of durable session context.
• copy_session_user_metadata: Validate and detach a complete user-authored metadata replacement.
• DEFAULT_PENDING_ACTION_RESULT_MAX_BYTES
• DeferredInteractionInput: Source messages durably admitted but not yet visible in the transcript.
• DelegatedActionReference: Bounded discovery of a child-owned action; not resolution authority.
• EnqueueSessionMessageRequest: Submit durable user steering for an active session.
• EnqueueSessionMessageResult: Typed enqueue result, including the durable acceptance event.
• EventOrder
• EventQuery
• EventQueryResultTooLarge: A bounded event query would hydrate more serialized bytes than allowed.
• EventRecord
• EventSummary
• ForkExecutionProfileDecisionRecord: Bounded accepted policy evidence stored with a profiled fork.
• ForkExecutionProfileSelection: Select the immutable execution-profile baseline for a child session.
• ForkExecutionProfileSource: Durable parent authority from which the fork baseline was selected.
• ForkSessionRequest
• ForkSourceSnapshot: Exact, caller-visible authority for one safe session-fork source.
• ForkSystemPromptPolicy: Select which body’s system prompt becomes authoritative in a session fork.
• ForkSystemPromptReplacement: Store-boundary instruction to replace every inherited system message.
• IncompleteSessionRecoveryAction
• IncompleteSessionRecoveryRequest
• IncompleteSessionRecoveryResult
• IncompleteSessionsRecoveryPage: One bounded batch-recovery page and its continuation position.
• IncompleteSessionsRecoveryRequest: Select and bound one resumable incomplete-session recovery page.
• INITIAL_TRANSCRIPT_PENDING_CHECKPOINT_KEY
• InMemorySessionStore: In-process session store for tests, local development, and examples.
• InteractionTransitionReceiptResult: Read-only exact receipt evidence for one interaction transition.
• InteractionTransitionResult: Exact result of an atomic interaction-lifecycle/session transition.
• InteractionTransitionSpec: Complete caller-owned identity of one interaction transition.
• InterruptSessionRequest
• is_runtime_owned_session_metadata_key: Return whether a session metadata entry is owned by Cayu’s runtime.
• LabelSelectorOperator
• LabelSelectorRequirement
• MAX_INCOMPLETE_SESSIONS_RECOVERY_CURSOR_BYTES
• MAX_PENDING_ACTION_RESULT_BYTES
• MAX_SESSION_ID_BYTES
• MAX_SESSION_LIST_CURSOR_BYTES
• McpManifestBaseline: Authoritative accepted MCP manifest for one durable history identity.
• McpManifestBaselineLoadResult: Authoritative accepted baselines loaded from one durable store.
• McpManifestHistoryConflict: An MCP manifest check could not establish or fence authoritative history.
• McpManifestPublicationResult: Result of one atomic manifest-baseline compare-and-publication attempt.
• ModelCompletionManualRecoveryRequest: Runtime-owned terminal disposition for one ambiguous model dispatch.
• ModelCompletionManualRecoveryResult: Verified accounting and stage settlement from manual model recovery.
• ModelCompletionStage: Verified view assembled from append-only preparation and completion records.
• ModelCompletionStageAbandonment: Durable proof that an exact pre-dispatch preparation was abandoned.
• ModelCompletionStageAbandonmentResult: Result of a new abandonment or an exact durable replay.
• ModelCompletionStageDispatch: Append-only proof that one exact prepared request may reach its provider.
• ModelCompletionStageDisposition: Durable non-success outcome of one exact model-completion dispatch.
• ModelCompletionStageRequest: Immutable identity and accounting link prepared before provider dispatch.
• ModelCompletionStageResult: Result of preparing or terminally completing one immutable stage.
• ModelCompletionStageSettlement: Append-only proof that one exact prepared model effect is no longer active.
• ModelCompletionStageSettlementRequest: Exact authority required to terminally settle one active model stage.
• ModelFailoverPolicy: Bounded, explicit alternatives after an eligible ordinary model failure.
• ModelTarget: An application-selected provider and model pair for one session epoch.
• PendingActionIssue: Bounded visibility for a candidate that could not be materialized.
• PendingActionIssueCode: Why one pending-action candidate could not be projected safely.
• PendingActionKind
• PendingActionListResult: One stable page of pending actions and its candidate continuation cursor.
• PendingActionQuery: Bounded query for durable control-plane actions blocking a session.
• PendingActionRecord: One current action derived from a session checkpoint and its source event.
• PendingActionResultTooLarge: A pending-action page exceeded its caller-selected serialized byte ceiling.
• PendingActionSession: Bounded session identity embedded in pending-action query results.
• PersistedEventSideEffectClaim
• PersistedEventSideEffectClaimLost: A side-effect acknowledgement lost ownership to a replacement claim.
• PersistedEventSideEffectDelivery
• PersistedEventSideEffectStatus
• ProfiledSessionForkResult: Store-atomic child session and its ordered durable evidence.
• PromptAnatomyTransitionReceipt: Durable prompt-succession evidence that never contains prompt text.
• replace_session_user_metadata: Combine validated user metadata with the current runtime-owned entries.
• ResumeRequest: Continue a conversation; omitted loop controls inherit verified prior settings.
• RunnerObservedEventIdentity: Lightweight identity for one event drained by a runner-owned execution.
• RunRequest
• RUNTIME_BUILD_PROVENANCE_METADATA_KEY
• runtime_publication_checkpoint_mutation: Build a deterministic top-level CAS patch without fencing unrelated keys.
• runtime_publication_checkpoint_value_digest: Return the canonical digest used to fence one checkpoint value.
• runtime_publication_event_reference: Return an immutable ID-and-content reference for one exact event value.
• runtime_publication_operation_record_value_digest: Return the CAS digest used for one session-operation record value.
• RuntimePublicationCheckpointOperation: One independently fenced top-level checkpoint mutation.
• RuntimePublicationEventReference: Content-bound reference to one already-durable runtime event.
• RuntimePublicationMutation: Deterministic checkpoint patch committed with a publication.
• RuntimePublicationOperationRecordMutation: One CAS-protected session-operation record committed with a publication.
• RuntimePublicationReceipt: Store-owned, insert-only proof of one atomic runtime publication.
• RuntimePublicationRequest: Immutable input bundle for one logical model-step or tool-round publication.
• RuntimePublicationResult: Result of a new runtime publication or an exact durable replay.
• SerializedRecordSummary: Exact serialized-size totals for one kind of durable session record.
• Session
• session_fork_profile_relationship: Load and authenticate the immutable profile relationship of one child.
• session_invocation_for_run_request: Derive exact provenance inside the atomic store-create boundary.
• session_prompt_anatomy_transition: Return verified durable prompt-succession evidence for one descendant.
• SESSION_RUNTIME_METADATA_KEYS
• SESSION_RUNTIME_METADATA_PREFIX
• SessionAggregateFilter: Current session attributes that may scope a store-native aggregate.
• SessionBudgetInspection: Availability of durable budget and price-ledger evidence.
• SessionDebugState
• SessionExecutionInProgress: Continuation cannot establish that the current execution was abandoned.
• SessionForkProfileRelationship: Immutable, content-bound profile authority for one session fork.
• SessionIdentity
• SessionInspectionIdentity: Bounded, metadata-free identity used by operator inspection.
• SessionInspectionSummary: Bounded backend-neutral diagnostic overview for one durable session.
• SessionInspectionUsageSummary: Lossless usage totals for bounded operator inspection.
• SessionInvocationAdmission: One valid atomic admission of a profiled session invocation.
• SessionInvocationSnapshot: Bounded immutable invocation state for trusted task/dispatch boundaries.
• SessionLineageNode: Minimal byte-bounded identity used to enumerate one child branch.
• SessionLineageOrigin: Payload-free durable identity for one session start or fork event.
• SessionLineageQuery: One independently pageable, payload-free direct-child lineage read.
• SessionLineageResult: Backend-neutral bounded direct-child lineage page.
• SessionListResult: One page of a session listing plus its keyset cursor and (optional) total count.
• SessionMessageActionResult: Terminal queue mutation and its atomically persisted content-free event.
• SessionMessageDeliveryBatch: One bounded atomic queue-delivery batch at a fixed eligibility cutoff.
• SessionMessageDeliveryMode
• SessionMessageInspection: One protected delivery-priority page and its exact session instance.
• SessionMessageInspectionRecord: Safe row envelope: unreadable content never becomes deliverable input.
• SessionMessageQueueStatus
• SessionModelCompletionStageConflict: A logical model-completion stage conflicts with immutable durable evidence.
• SessionModelCompletionStageIncomplete: A logical model step was prepared but has no durable terminal completion.
• SessionModelTransition: Runtime-owned material committed with a clean-boundary model switch.
• SessionOperationalSnapshot: Exact current session counts captured by one store-local read snapshot.
• SessionOperationInitializer
• SessionOperationPublication: One atomic checkpoint/event publication plus terminal operation records.
• SessionOperationTransform
• SessionOrder
• SessionOutcome: Derived reason for the current session state.
• SessionQuery
• SessionQueuedMessage: One durable queued user message and its delivery state.
• SessionQueuedMessagesPending: Terminalization lost a race to durable queued session input.
• SessionRunFenced: A durable write was rejected because its run no longer owns the session epoch.
• SessionRuntimePublicationConflict: A runtime publication identity conflicts with its durable receipt.
• SessionStateSnapshot: Bounded session state for status polling and control-plane coordination.
• SessionStatus
• SessionStatusConflict: A session status transition was rejected because the session was not in an allowed source status (e.g. resuming a session another worker is already running). Subclasses ValueError so existing except ValueError handlers keep working; callers that need to react specifically (e.g. requeue) catch this.
• SessionStatusCounts: Complete current-session counts for every lifecycle status.
• SessionStore: Persistent store for sessions and append-only events.
• SessionTopologyBranch: One independently pageable direct-child branch.
• SessionTopologyCycle: Durable parent-session records contain a lineage cycle.
• SessionTopologyDepthExceeded: A focus session has more ancestors than the bounded topology contract.
• SessionTopologyNode: Bounded metadata-free identity for one session topology node.
• SessionTopologyQuery: One bounded ancestry plus batched child-branch read.
• SessionTopologyStoreResult: Backend-neutral bounded topology projection.
• StoreTimeCheckpointTransform
• StoreTimeSessionOperationTransform
• system_prompt_messages_sha256: Hash only the canonical system messages that define one prompt anatomy.
• TERMINAL_SESSION_EVIDENCE_DEFAULT_MAX_EVENTS
• TERMINAL_SESSION_EVIDENCE_DEFAULT_MAX_RECORD_BYTES
• TERMINAL_SESSION_EVIDENCE_DEFAULT_MAX_TOTAL_BYTES
• TERMINAL_SESSION_EVIDENCE_DEFAULT_MAX_TRANSCRIPT_RECORDS
• TERMINAL_SESSION_EVIDENCE_HARD_MAX_EVENTS
• TERMINAL_SESSION_EVIDENCE_HARD_MAX_RECORD_BYTES
• TERMINAL_SESSION_EVIDENCE_HARD_MAX_TOTAL_BYTES
• TERMINAL_SESSION_EVIDENCE_HARD_MAX_TRANSCRIPT_RECORDS
• TerminalPublicationMarker: Bounded projection of a still-pending terminal-publication operation.
• TerminalSessionEvidence: One exact, bounded store snapshot through a terminal run.
• TerminalSessionEvidenceBoundary: Completeness and working-set metadata for a terminal evidence snapshot.
• TerminalSessionEvidenceError: Bounded typed failure from load_terminal_session_evidence.
• TerminalSessionEvidenceErrorCode: Stable reason why a terminal-session snapshot cannot be returned.
• TerminalSessionEvidenceLimits: Caller-selected ceilings for one exact terminal-session snapshot.
• TranscriptPage: A retained-row page, not a logical-history extent.
• TranscriptQuery: Paginate retained matching rows in ascending absolute-index order.
• TranscriptRecord: One retained message with its zero-based absolute transcript index.
• TranscriptSearchHit: One exact transcript record matched through its non-thinking text parts.
• TranscriptSearchQuery: Bounded lexical search over explicitly selected authoritative transcripts.
• TranscriptSearchResult: One bounded transcript-search page and its exact continuation frontier.
• TranscriptSnapshot: Retained transcript records plus the permanent append cursor.
• UsageRollupQuery: Bounded event-time usage query with explicit current-session filtering.