autoagents-guardrails 0.3.7

Agent Framework for Building Autonomous Agents
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

use std::sync::Arc;

use crate::guard::{GuardContext, GuardViolation, GuardedInput, GuardedOutput};

/// Function signature used to sanitize guarded input payloads.
pub type InputSanitizer =
    dyn Fn(&mut GuardedInput, &GuardViolation, &GuardContext) + Send + Sync + 'static;

/// Function signature used to sanitize guarded output payloads.
pub type OutputSanitizer =
    dyn Fn(&mut GuardedOutput, &GuardViolation, &GuardContext) + Send + Sync + 'static;

/// Shared input sanitizer handle.
pub type SharedInputSanitizer = Arc<InputSanitizer>;

/// Shared output sanitizer handle.
pub type SharedOutputSanitizer = Arc<OutputSanitizer>;

/// Default input sanitizer used by guardrails engine.
///
/// Behavior: redact all input text fields.
pub fn default_input_sanitizer() -> SharedInputSanitizer {
    Arc::new(redact_input_payload)
}

/// Default output sanitizer used by guardrails engine.
///
/// Behavior: redact all output text fields and clear optional chat metadata.
pub fn default_output_sanitizer() -> SharedOutputSanitizer {
    Arc::new(redact_output_payload)
}

/// Built-in input sanitizer: redact every input text field.
pub fn redact_input_payload(
    input: &mut GuardedInput,
    _violation: &GuardViolation,
    _context: &GuardContext,
) {
    input.redact_all();
}

/// Built-in output sanitizer: redact every output text field and clear optional
/// chat metadata.
pub fn redact_output_payload(
    output: &mut GuardedOutput,
    _violation: &GuardViolation,
    _context: &GuardContext,
) {
    output.redact_all();
}

/// Built-in output sanitizer: redact only text while preserving chat metadata.
pub fn redact_output_text_only_payload(
    output: &mut GuardedOutput,
    _violation: &GuardViolation,
    _context: &GuardContext,
) {
    output.redact_text_only();
}

/// Built-in no-op input sanitizer.
pub fn noop_input_payload(
    _input: &mut GuardedInput,
    _violation: &GuardViolation,
    _context: &GuardContext,
) {
}

/// Built-in no-op output sanitizer.
pub fn noop_output_payload(
    _output: &mut GuardedOutput,
    _violation: &GuardViolation,
    _context: &GuardContext,
) {
}

/// Convenience constructor for no-op input sanitization.
pub fn noop_input_sanitizer() -> SharedInputSanitizer {
    Arc::new(noop_input_payload)
}

/// Convenience constructor for no-op output sanitization.
pub fn noop_output_sanitizer() -> SharedOutputSanitizer {
    Arc::new(noop_output_payload)
}

/// Convenience constructor for text-only output redaction.
pub fn redact_output_text_only_sanitizer() -> SharedOutputSanitizer {
    Arc::new(redact_output_text_only_payload)
}