Struct SessionApprovalCache 

pub struct SessionApprovalCache { /* private fields */ }

Available on crate feature human-loop only.

会话级审批缓存

线程安全，使用 std::sync::RwLock 保护内部数据。 Key 的生成方式：

• Session scope: tool_name + args_key（默认完整 JSON；启用 hash 模式时使用 SHA256）
• SessionAllTools scope: tool_name（所有参数均匹配）

支持可选 TTL：缓存条目超过 TTL 后自动失效。

Implementations

impl SessionApprovalCache

pub fn new() -> SessionApprovalCache

创建空的审批缓存（永不过期，向后兼容）

pub fn with_ttl(ttl: Duration) -> SessionApprovalCache

创建带 TTL 的审批缓存

缓存条目超过 ttl 后自动失效。 参考：Claude Code 使用 1h（Max）/ 5min（Pro）TTL。

pub fn with_hash_args() -> SessionApprovalCache

创建使用 SHA256 哈希模式缓存参数 key 的实例

当工具参数很大时，使用 SHA256 哈希值作为缓存 key 而非完整 JSON 字符串，显著减少内存占用。

pub fn set_hash_args(&mut self, enabled: bool)

启用/禁用 SHA256 哈希参数 key 模式

pub fn with_max_entries(self, max: usize) -> SessionApprovalCache

设置最大条目数

pub fn is_approved(&self, tool_name: &str, args: &Value) -> bool

检查工具调用是否已被缓存审批

pub fn record_approval( &self, tool_name: &str, args: &Value, scope: ApprovalScope, )

记录一个审批决策

pub fn revoke(&self, tool_name: &str)

撤销某个工具的所有缓存审批

pub fn clear(&self)

清空所有缓存

pub fn cleanup_expired(&self) -> usize

清理过期条目

扫描并移除所有超过 TTL 的缓存条目。 如果未设置 TTL，此方法无操作。

返回清理的条目数。

pub fn stats(&self) -> CacheStats

获取缓存统计信息

Trait Implementations

impl Clone for SessionApprovalCache

fn clone(&self) -> SessionApprovalCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionApprovalCache

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

Formats the value using the given formatter.

impl Default for SessionApprovalCache

fn default() -> SessionApprovalCache

Returns the “default value” for a type.