Struct Policy 

pub struct Policy {
    pub id: PolicyId,
    pub title: String,
    pub action: PolicyAction,
    pub decision: PolicyDecision,
    pub reason: Option<String>,
}

Fields

id: PolicyId

title: String

action: PolicyAction

decision: PolicyDecision

reason: Option<String>

Implementations

impl Policy

pub fn require_approval( id: PolicyId, title: impl Into<String>, action: PolicyAction, ) -> Self

Examples found in repository

examples/policy_approval.rs (lines 11-15)

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let state = YoAgentState::load(MemoryEventStore::new()).await?;
    let mut runtime = YoAgentRuntime::new(state.clone());
    runtime.register_policy(Policy::require_approval(
        PolicyId::new("policy_create_node_review"),
        "Creating graph nodes requires review",
        PolicyAction::CreateNode,
    ));

    let result = runtime
        .create_typed_node(
            ActorRef::agent("demo"),
            NodeId::new("sensitive_node"),
            "memory",
            json!({ "title": "Potentially sensitive memory" }),
        )
        .await;

    match result {
        Err(StateError::PolicyDenied(message)) => println!("blocked: {message}"),
        other => println!("unexpected: {other:?}"),
    }

    let approvals = state
        .graph()
        .await
        .nodes
        .values()
        .filter(|node| node.kind == "approval_request")
        .count();
    println!("approval_requests={approvals}");
    Ok(())
}

Trait Implementations

impl Clone for Policy

fn clone(&self) -> Policy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Policy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Policy

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Policy

fn eq(&self, other: &Policy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Policy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Policy