From 4560a7727e617e9c95bb3535413613e608fb5fba Mon Sep 17 00:00:00 2001
From: kevin zhao <zhao@openai.com>
Date: Tue, 18 Nov 2025 12:38:32 -0800
Subject: [PATCH] adding docstrings for ApprovalRequirement

---
 codex-rs/core/src/tools/sandboxing.rs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/codex-rs/core/src/tools/sandboxing.rs b/codex-rs/core/src/tools/sandboxing.rs
index 739c743765..fbbabefeae 100644
--- a/codex-rs/core/src/tools/sandboxing.rs
+++ b/codex-rs/core/src/tools/sandboxing.rs
@@ -86,10 +86,14 @@ pub(crate) struct ApprovalCtx<'a> {
     pub risk: Option<SandboxCommandAssessment>,
 }
 
+// Specifies what tool orchestrator should do with a given tool call.
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub(crate) enum ApprovalRequirement {
+    // No approval required for this tool call
     Skip,
+    // Approval required for this tool call
     NeedsApproval { reason: Option<String> },
+    // Execution forbidden for this tool call
     Forbidden { reason: String },
 }