Struct ContractSister 

pub struct ContractSister { /* private fields */ }

Contract facade wrapping the ContractEngine with SDK trait implementations.

Contract is session-scoped: policies and governance rules are loaded into a session context and can be queried, grounded, and audited.

Trait Implementations

impl EventEmitter for ContractSister

fn subscribe(&self, _filter: EventFilter) -> EventReceiver

Subscribe to events with optional filter.

fn recent_events(&self, limit: usize) -> Vec<SisterEvent>

Get recent events.

fn emit(&self, event: SisterEvent)

Emit an event (for internal use).

impl FileFormatReader for ContractSister

fn read_file(path: &Path) -> SisterResult<Self>

where Self: Sized,

Read a file with version handling

fn can_read(path: &Path) -> SisterResult<FileInfo>

Check if a file is readable (without full parse). Returns file info for quick inspection

fn file_version(path: &Path) -> SisterResult<Version>

Get file version without full parse

fn migrate(_data: &[u8], _from_version: Version) -> SisterResult<Vec<u8>>

Migrate old version data to current format (in memory). Returns the migrated bytes

impl FileFormatWriter for ContractSister

fn write_file(&self, path: &Path) -> SisterResult<()>

Write to a file path

fn to_bytes(&self) -> SisterResult<Vec<u8>>

Serialize the content to bytes

impl Grounding for ContractSister

fn ground(&self, claim: &str) -> SisterResult<GroundingResult>

Verify a claim against stored evidence.

fn evidence( &self, query: &str, max_results: usize, ) -> SisterResult<Vec<EvidenceDetail>>

Get detailed evidence for a query.

fn suggest( &self, _query: &str, limit: usize, ) -> SisterResult<Vec<GroundingSuggestion>>

Find similar items when an exact match fails.

impl Queryable for ContractSister

fn query(&self, query: Query) -> SisterResult<QueryResult>

Execute a query.

fn supports_query(&self, query_type: &str) -> bool

Check if a query type is supported.

fn query_types(&self) -> Vec<QueryTypeInfo>

List supported query types.

fn search(&self, text: &str) -> Result<QueryResult, SisterError>

Execute a simple search query.

fn recent(&self, count: usize) -> Result<QueryResult, SisterError>

Get recent items.

fn list(&self, limit: usize, offset: usize) -> Result<QueryResult, SisterError>

List items with pagination.

impl ReceiptIntegration for ContractSister

fn create_receipt(&self, action: ActionRecord) -> SisterResult<ReceiptId>

Create a receipt for an action (via Identity).

fn get_receipt(&self, id: ReceiptId) -> SisterResult<Receipt>

Get receipt by ID (from Identity).

fn list_receipts(&self, _filter: ReceiptFilter) -> SisterResult<Vec<Receipt>>

List receipts for this sister.

fn receipt_count(&self) -> Result<u64, SisterError>

Get receipt count.

fn receipts_for_action( &self, action_type: &str, ) -> Result<Vec<Receipt>, SisterError>

Get receipts for a specific action type.

impl SessionManagement for ContractSister

fn start_session(&mut self, name: &str) -> SisterResult<ContextId>

Start a new session. Returns the session ID. The previous session (if any) is automatically ended

fn end_session(&mut self) -> SisterResult<()>

End the current session. After this, a new session must be started before operations

fn current_session(&self) -> Option<ContextId>

Get the current session ID. Returns None if no session is active

fn current_session_info(&self) -> SisterResult<ContextInfo>

Get info about the current session

fn list_sessions(&self) -> SisterResult<Vec<ContextSummary>>

List all past sessions (most recent first)

fn export_session(&self, _id: ContextId) -> SisterResult<ContextSnapshot>

Export a session as a snapshot (for backup/transfer)

fn import_session( &mut self, snapshot: ContextSnapshot, ) -> SisterResult<ContextId>

Import a session from a snapshot

fn start_session_with_metadata( &mut self, name: &str, metadata: HashMap<String, Value>, ) -> Result<ContextId, SisterError>

Start a new session with metadata

fn get_session_info(&self, id: ContextId) -> Result<ContextInfo, SisterError>

Get info about a specific past session

impl Sister for ContractSister

const SISTER_TYPE: SisterType = SisterType::Contract

The type of this sister

const FILE_EXTENSION: &'static str = "acon"

File extension for this sister’s format (without dot)

fn init(config: SisterConfig) -> SisterResult<Self>

where Self: Sized,

Initialize the sister with configuration

fn health(&self) -> HealthStatus

Check health status

fn version(&self) -> Version

Get current version

fn shutdown(&mut self) -> SisterResult<()>

Shutdown gracefully

fn capabilities(&self) -> Vec<Capability>

Get capabilities this sister provides

fn sister_type(&self) -> SisterType

Get the sister type

fn file_extension(&self) -> &'static str

Get the file extension

fn is_healthy(&self) -> bool

Check if the sister is healthy

fn name(&self) -> String

Get a human-readable name

fn mcp_prefix(&self) -> &'static str

Get MCP tool prefix