Skip to content

cayu.collaboration.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.

from cayu.collaboration import CollaborationStore

Trusted owner API. Public authentication belongs to the application boundary.

Implementations must provide atomic native transactions, exact immutable receipts and cancellation settlement. No raw record write API is public.

Bases: ABC.

async CollaborationStore.close() -> None
CollaborationStore.capabilities(owner: OwnerRef) -> CapabilityDescriptor
async CollaborationStore.initialize(binding: CollaborationBootstrap, *, redactor: SecretRedactor) -> CollaborationInitialization
async CollaborationStore.register_wait(initialized, wait, *, redactor: SecretRedactor)
async CollaborationStore.load_wait(initialized, wait, *, redactor: SecretRedactor, wait_for_settlement=False)
async CollaborationStore.record_wait_evidence(initialized, wait, evidence, *, redactor: SecretRedactor, wait_for_settlement=False)
async CollaborationStore.release_wait_sources(initialized, wait, *, redactor: SecretRedactor, wait_for_settlement=False)
async CollaborationStore.record_wait_delivery(initialized, wait, *, receipt_digest: str, delivery: Literal['accepted', 'excluded']='accepted', redactor: SecretRedactor, wait_for_settlement=False)
async CollaborationStore.cancel_wait(initialized, wait, *, expired: bool, redactor: SecretRedactor)
async CollaborationStore.lookup(initialized: CollaborationInitialization, expected: ExpectedOperation[ParticipantIntent], *, redactor: SecretRedactor) -> ExactLookup[ParticipantReceipt]
async CollaborationStore.apply(initialized: CollaborationInitialization, expected: ExpectedOperation[ParticipantIntent], *, redactor: SecretRedactor) -> ParticipantReceipt
async CollaborationStore.inspect_namespace(initialized: CollaborationInitialization, *, redactor: SecretRedactor) -> NamespaceInspection
async CollaborationStore.inspect_retirement(initialized: CollaborationInitialization, namespace: NamespaceRef, *, redactor: SecretRedactor) -> NamespaceRetirementEvidence | None
async CollaborationStore.scan_obligations(initialized: CollaborationInitialization, participant: ParticipantRef, *, after: int, limit: int, pending_only: bool, retention_revision: int | None, redactor: SecretRedactor) -> tuple[int, tuple[ParticipantObligation, ...]]
async CollaborationStore.apply_lifecycle(initialized: CollaborationInitialization, expected: LifecycleCommand, *, redactor: SecretRedactor) -> LifecycleReceipt
async CollaborationStore.lookup_lifecycle(initialized: CollaborationInitialization, expected: LifecycleCommand, *, redactor: SecretRedactor) -> ExactLookup[LifecycleReceipt]
async CollaborationStore.inspect(initialized: CollaborationInitialization, participant: ParticipantRef, *, redactor: SecretRedactor) -> ParticipantInspection
async CollaborationStore.resolve_alias(initialized: CollaborationInitialization, alias: str, *, redactor: SecretRedactor) -> ParticipantAlias | None
async CollaborationStore.scan(initialized: CollaborationInitialization, *, table: Literal['participants', 'events'], after: str | int, limit: int, allowed: tuple[ParticipantRef, ...] | None, redactor: SecretRedactor) -> tuple[ParticipantSnapshot | ParticipantEvent, ...]
async CollaborationStore.scan_events(initialized: CollaborationInitialization, *, after: int, limit: int, allowed: tuple[ParticipantRef, ...] | None, retention_revision: int | None, redactor: SecretRedactor) -> tuple[int, tuple[ParticipantEvent, ...]]

Release source · Runtime guarantees · Capability guides