claude-agent 0.2.25

Rust SDK for building AI agents with Anthropic's Claude - Direct API, no CLI dependency
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

//! Schema transformation utilities for structured outputs.

use serde_json::Value;

/// Properties not supported by Claude API structured outputs.
///
/// Per Claude API docs (2025-11-13):
/// - Numerical constraints: minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf
/// - String constraints: minLength, maxLength
/// - Array constraints: minItems (only 0,1 supported), maxItems
/// - Object constraints: minProperties, maxProperties
///
/// Supported but kept:
/// - default: supported for all types
/// - format: supported for date-time, time, date, duration, email, hostname, uri, ipv4, ipv6, uuid
/// - pattern: supported for simple regex (no backreferences, lookahead, word boundaries)
const UNSUPPORTED_PROPERTIES: &[&str] = &[
    // Numerical constraints
    "minimum",
    "maximum",
    "exclusiveMinimum",
    "exclusiveMaximum",
    "multipleOf",
    // String constraints
    "minLength",
    "maxLength",
    // Array constraints (minItems only supports 0,1; maxItems not supported)
    "minItems",
    "maxItems",
    // Object constraints
    "minProperties",
    "maxProperties",
];

/// Transform a schema for strict mode compatibility.
///
/// This function prepares a JSON schema for Claude's structured outputs:
/// - Adds `additionalProperties: false` to all objects
/// - Auto-generates `required` array if not present (all properties become required)
/// - Removes unsupported constraints (see `UNSUPPORTED_PROPERTIES`)
///
/// Supported properties are preserved: `default`, `format`, `pattern`, `enum`, `const`.
pub fn transform_for_strict(schema: Value) -> Value {
    transform_object(schema)
}

fn transform_object(mut value: Value) -> Value {
    if let Value::Object(ref mut map) = value {
        // Remove unsupported properties
        for prop in UNSUPPORTED_PROPERTIES {
            map.remove(*prop);
        }

        if map.get("type") == Some(&Value::String("object".to_string())) {
            map.insert("additionalProperties".to_string(), Value::Bool(false));

            if !map.contains_key("required")
                && let Some(Value::Object(props)) = map.get("properties")
            {
                let keys: Vec<Value> = props.keys().map(|k| Value::String(k.clone())).collect();
                if !keys.is_empty() {
                    map.insert("required".to_string(), Value::Array(keys));
                }
            }
        }

        for (_, v) in map.iter_mut() {
            *v = transform_object(std::mem::take(v));
        }
    }

    if let Value::Array(ref mut arr) = value {
        for v in arr.iter_mut() {
            *v = transform_object(std::mem::take(v));
        }
    }

    value
}

/// Generate a strict schema from a Rust type using schemars.
pub fn strict_schema<T: schemars::JsonSchema>() -> Value {
    let schema = schemars::schema_for!(T);
    let value = serde_json::to_value(schema).unwrap_or_default();
    transform_for_strict(value)
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::json;

    #[test]
    fn test_transform_adds_additional_properties() {
        let schema = json!({
            "type": "object",
            "properties": {
                "name": {"type": "string"}
            }
        });

        let result = transform_for_strict(schema);

        assert_eq!(result["additionalProperties"], false);
        assert!(
            result["required"]
                .as_array()
                .unwrap()
                .contains(&json!("name"))
        );
    }

    #[test]
    fn test_transform_nested_objects() {
        let schema = json!({
            "type": "object",
            "properties": {
                "person": {
                    "type": "object",
                    "properties": {
                        "name": {"type": "string"}
                    }
                }
            }
        });

        let result = transform_for_strict(schema);

        assert_eq!(result["additionalProperties"], false);
        assert_eq!(
            result["properties"]["person"]["additionalProperties"],
            false
        );
    }

    #[test]
    fn test_transform_preserves_existing_required() {
        let schema = json!({
            "type": "object",
            "properties": {
                "name": {"type": "string"},
                "age": {"type": "integer"}
            },
            "required": ["name"]
        });

        let result = transform_for_strict(schema);

        assert_eq!(result["required"], json!(["name"]));
    }
}