feat: add Guardian denial semantics

Co-authored-by: Codex noreply@openai.com
This commit is contained in:
viyatb-oai
2026-06-04 00:07:25 -07:00
co-authored by Codex noreply@openai.com
parent a2a9e767f7
commit 3bd85a2bd6
34 changed files with 450 additions and 15 deletions
+53
View File
@@ -108,6 +108,14 @@ pub enum GuardianAssessmentOutcome {
Deny,
}
/// Whether a Guardian denial is eligible for an explicit user-approved retry.
#[derive(Debug, Clone, Copy, Deserialize, Serialize, PartialEq, Eq, JsonSchema, TS)]
#[serde(rename_all = "lowercase")]
pub enum GuardianDenialKind {
Soft,
Denial,
}
#[derive(Debug, Clone, Copy, Deserialize, Serialize, PartialEq, Eq, JsonSchema, TS)]
#[serde(rename_all = "snake_case")]
pub enum GuardianAssessmentStatus {
@@ -206,6 +214,10 @@ pub struct GuardianAssessmentEvent {
#[serde(default, skip_serializing_if = "Option::is_none")]
#[ts(optional)]
pub rationale: Option<String>,
/// Whether a denied action can be explicitly approved for one retry.
#[serde(default, skip_serializing_if = "Option::is_none")]
#[ts(optional)]
pub denial_kind: Option<GuardianDenialKind>,
/// Source that produced the terminal assessment decision.
#[serde(default, skip_serializing_if = "Option::is_none")]
#[ts(optional)]
@@ -214,6 +226,13 @@ pub struct GuardianAssessmentEvent {
pub action: GuardianAssessmentAction,
}
impl GuardianAssessmentEvent {
pub fn is_explicit_retry_eligible(&self) -> bool {
self.status == GuardianAssessmentStatus::Denied
&& self.denial_kind == Some(GuardianDenialKind::Soft)
}
}
#[derive(Debug, Clone, Deserialize, Serialize, JsonSchema, TS)]
pub struct ExecApprovalRequestEvent {
/// Identifier for the associated command execution item.
@@ -448,4 +467,38 @@ mod tests {
}
);
}
#[test]
fn only_soft_denials_are_eligible_for_explicit_retry() {
let mut event = GuardianAssessmentEvent {
id: "guardian-1".to_string(),
target_item_id: None,
turn_id: "turn-1".to_string(),
started_at_ms: 0,
completed_at_ms: Some(1),
status: GuardianAssessmentStatus::Denied,
risk_level: None,
user_authorization: None,
rationale: None,
denial_kind: Some(GuardianDenialKind::Soft),
decision_source: None,
action: GuardianAssessmentAction::Command {
source: GuardianCommandSource::Shell,
command: "rm -f /tmp/example".to_string(),
cwd: test_path_buf("/tmp").abs(),
},
};
assert!(event.is_explicit_retry_eligible());
event.denial_kind = Some(GuardianDenialKind::Denial);
assert!(!event.is_explicit_retry_eligible());
event.denial_kind = None;
assert!(!event.is_explicit_retry_eligible());
event.denial_kind = Some(GuardianDenialKind::Soft);
event.status = GuardianAssessmentStatus::Approved;
assert!(!event.is_explicit_retry_eligible());
}
}
+1
View File
@@ -70,6 +70,7 @@ pub use crate::approvals::GuardianAssessmentEvent;
pub use crate::approvals::GuardianAssessmentOutcome;
pub use crate::approvals::GuardianAssessmentStatus;
pub use crate::approvals::GuardianCommandSource;
pub use crate::approvals::GuardianDenialKind;
pub use crate::approvals::GuardianRiskLevel;
pub use crate::approvals::GuardianUserAuthorization;
pub use crate::approvals::NetworkApprovalContext;