converge-policy 3.7.0

Cedar-based Policy Decision Point for Converge gate model
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

//! Domain types for policy decisions.
//!
//! These map to Converge's governance model:
//! - Principals are agent personas with authority levels
//! - Resources are flows/commitments with phase and gate state
//! - Context carries decision-relevant facts

use serde::{Deserialize, Serialize};

use converge_core::{AuthorityLevel, FlowAction, FlowPhase};
use converge_pack::{DomainId, GateId, PolicyVersionId, PrincipalId, ResourceId, ResourceKind};

/// Suggestor persona — the principal in Converge policy decisions.
///
/// Maps to converge-personas definitions. Authority levels determine
/// what actions the agent can perform without escalation.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PrincipalIn {
    /// Suggestor identifier (e.g., `agent:strategic_analyst`)
    pub id: PrincipalId,
    /// Authority level: advisory, supervisory, participatory, sovereign
    pub authority: AuthorityLevel,
    /// Domains this agent operates in
    pub domains: Vec<DomainId>,
    /// Policy version binding (e.g., `enterprise_v2.3`)
    pub policy_version: Option<PolicyVersionId>,
}

/// Flow or commitment — the resource being acted upon.
///
/// Represents a converging flow at a specific phase, with its
/// gate evaluation history.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ResourceIn {
    /// Flow/commitment identifier (e.g., `flow:quote-2025-0042`)
    pub id: ResourceId,
    /// Commitment type: quote, spend, contract, invoice
    #[serde(rename = "type")]
    pub resource_type: Option<ResourceKind>,
    /// Current phase: intent, framing, exploration, tension, convergence, commitment
    pub phase: Option<FlowPhase>,
    /// Gates that have been passed
    pub gates_passed: Option<Vec<GateId>>,
}

/// Decision context — facts about the action being attempted.
///
/// The caller pre-joins these facts from the business context,
/// keeping the policy engine free of data-fetching side effects.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ContextIn {
    /// Type of commitment (quote, spend, contract, invoice)
    pub commitment_type: Option<String>,
    /// Monetary amount (if applicable)
    pub amount: Option<i64>,
    /// Whether a human has explicitly approved this action
    pub human_approval_present: Option<bool>,
    /// Whether all required gates for the current phase are met
    pub required_gates_met: Option<bool>,
}

/// Full decision request
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DecideRequest {
    pub principal: PrincipalIn,
    pub resource: ResourceIn,
    /// Action: propose, validate, promote, commit, `advance_phase`
    pub action: FlowAction,
    pub context: Option<ContextIn>,
    /// Optional delegation token for fast-path elevated authority
    pub delegation_b64: Option<String>,
}