microloop 0.2.0

Ultra-fast runtime safety layer for autonomous agents — detects agent tool call loops before they burn API credits
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

extern crate alloc;

use alloc::string::String;
use alloc::vec::Vec;
use serde::Deserialize;

#[derive(Deserialize, Debug, Clone, PartialEq)]
#[serde(rename_all = "snake_case")]
pub enum Strictness {
    Lenient,
    Balanced,
    Strict,
}

#[derive(Deserialize, Debug, Clone)]
pub struct JsonSchemaSubset {
    pub required: Option<Vec<String>>,
    #[serde(rename = "type")]
    pub schema_type: Option<String>,
}

#[derive(Deserialize, Debug, Clone)]
#[serde(tag = "type")]
#[serde(rename_all = "snake_case")]
pub enum RuleConfig {
    Regex { pattern: String },
    Exact { value: String },
    JsonSchema(JsonSchemaSubset),
}

#[derive(Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(rename_all = "snake_case")]
pub enum CountMode {
    #[default]
    All,
    ErrorsOnly,
}

#[derive(Deserialize, Debug, Clone)]
pub struct TrajectoryGateDefaults {
    #[serde(default = "default_max_repeats")]
    pub max_repeats: usize,
    #[serde(default)]
    pub count_mode: CountMode,
}

#[derive(Deserialize, Debug, Clone)]
pub struct MicroloopDefaults {
    pub trajectory_gate: TrajectoryGateDefaults,
}

#[derive(Deserialize, Debug, Clone)]
pub struct ErrorDetectionCfg {
    pub json_path: Option<String>,
    pub status_field: Option<String>,
    pub status_not_in: Option<Vec<u16>>,
    pub regex: Option<String>,
}

#[derive(Deserialize, Debug, Clone)]
pub struct ToolTrajectoryGate {
    pub max_repeats: Option<usize>,
    pub count_mode: Option<CountMode>,
    #[serde(default)]
    pub volatile_fields: Vec<String>,
    pub error_detection: Option<ErrorDetectionCfg>,
}

#[derive(Deserialize, Debug, Clone)]
pub struct ToolConfig {
    pub name: String,
    pub trajectory_gate: ToolTrajectoryGate,
}

#[derive(Deserialize, Debug, Clone)]
pub struct MicroloopConfig {
    #[serde(default = "default_strictness")]
    pub strictness: Strictness,
    #[serde(default = "default_max_repeats")]
    pub max_repeats: usize,
    #[serde(default)]
    pub ignore_args: bool,
    pub history_window: Option<usize>,

    #[serde(default)]
    pub rules: Vec<RuleConfig>,

    pub defaults: Option<MicroloopDefaults>,
    #[serde(default)]
    pub tools: Vec<ToolConfig>,
}

impl MicroloopConfig {
    pub fn from_yaml(yaml_str: &str) -> Result<Self, alloc::string::String> {
        serde_yaml::from_str(yaml_str).map_err(|e| alloc::format!("YAML parsing error: {}", e))
    }
}

fn default_strictness() -> Strictness {
    Strictness::Balanced
}

fn default_max_repeats() -> usize {
    3
}