appam 0.1.1

High-throughput, traceable, reliable Rust agent framework for long-horizon AI sessions and easy extensibility
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

//! Tool utilities for Anthropic API.
//!
//! Helpers for creating and managing tools, including server tools.
//!
//! # Client Tools
//!
//! User-defined tools that execute on the client side.
//!
//! # Server Tools
//!
//! Anthropic-hosted tools that execute on their servers:
//! - Web Search: Search the web for information
//! - Web Fetch: Fetch and parse web page content
//! - Bash: Execute bash commands
//! - Code Execution: Run Python code
//! - Text Editor: Edit files with str_replace

use super::types::Tool;

/// Create a web search server tool.
///
/// # Parameters
///
/// - `max_uses`: Maximum number of searches in one request (optional)
///
/// # Examples
///
/// ```ignore
/// let tool = create_web_search_tool(Some(5));
/// ```
pub fn create_web_search_tool(max_uses: Option<u32>) -> Tool {
    Tool::web_search(max_uses)
}

/// Create a web fetch server tool.
///
/// Fetches and parses web page content.
pub fn create_web_fetch_tool() -> Tool {
    Tool::web_fetch()
}

/// Create a bash server tool.
///
/// Executes bash commands in a containerized environment.
pub fn create_bash_tool() -> Tool {
    Tool {
        tool_type: Some("bash_20250124".to_string()),
        name: "bash".to_string(),
        description: None,
        input_schema: None,
        cache_control: None,
        max_uses: None,
        allowed_domains: None,
        blocked_domains: None,
    }
}

/// Create a code execution server tool.
///
/// Executes Python code in a containerized environment.
pub fn create_code_execution_tool() -> Tool {
    Tool {
        tool_type: Some("code_execution_20250825".to_string()),
        name: "code_execution".to_string(),
        description: None,
        input_schema: None,
        cache_control: None,
        max_uses: None,
        allowed_domains: None,
        blocked_domains: None,
    }
}

/// Create a text editor server tool.
///
/// String-replace based file editing tool.
pub fn create_text_editor_tool() -> Tool {
    Tool {
        tool_type: Some("text_editor_20250728".to_string()),
        name: "str_replace_based_edit_tool".to_string(),
        description: None,
        input_schema: None,
        cache_control: None,
        max_uses: None,
        allowed_domains: None,
        blocked_domains: None,
    }
}

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

    #[test]
    fn test_create_web_search_tool() {
        let tool = create_web_search_tool(Some(5));
        assert_eq!(tool.name, "web_search");
        assert_eq!(tool.tool_type.as_ref().unwrap(), "web_search_20250305");
        assert_eq!(tool.max_uses, Some(5));
    }

    #[test]
    fn test_create_bash_tool() {
        let tool = create_bash_tool();
        assert_eq!(tool.name, "bash");
        assert_eq!(tool.tool_type.as_ref().unwrap(), "bash_20250124");
    }
}