claude-sdk 2.1.0

Native Rust SDK for the Claude API with streaming support and tool execution
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

//! Server tools example demonstrating built-in Claude tools
//!
//! This example shows how to use server-side tools that Claude
//! executes directly (web search, code execution) alongside
//! custom client-side tools.
//!
//! Run with:
//! ```bash
//! cargo run --example server_tools
//! ```

use claude_sdk::server_tools::{CodeExecutionTool, WebSearchTool};
use claude_sdk::{CustomTool, Message, MessagesRequest, ToolDefinition};
use serde_json::json;

fn main() {
    println!("Claude SDK - Server Tools Example");
    println!("=====================================\n");

    // 1. Web search with domain filtering
    let web_search = WebSearchTool::new()
        .with_allowed_domains(vec!["docs.rs".into(), "crates.io".into()])
        .with_max_uses(5);

    println!("Web Search Tool:");
    println!("  Type: {}", web_search.tool_type);
    println!("  Allowed domains: {:?}", web_search.allowed_domains);
    println!("  Max uses: {:?}\n", web_search.max_uses);

    // 2. Code execution (sandboxed Python)
    let code_exec = CodeExecutionTool::new();

    println!("Code Execution Tool:");
    println!("  Type: {}\n", code_exec.tool_type);

    // 3. Custom tool alongside server tools
    let custom_tool = CustomTool::new(
        "format_output",
        "Format data into a specific output structure",
        json!({
            "type": "object",
            "properties": {
                "title": {"type": "string"},
                "data": {"type": "array", "items": {"type": "string"}}
            },
            "required": ["title", "data"]
        }),
    )
    .programmatic()
    .with_strict();

    println!("Custom Tool:");
    println!("  Name: {}", custom_tool.name);
    println!("  Strict: {:?}\n", custom_tool.strict);

    // 4. Build request with all three tool types
    let request = MessagesRequest::new(
        "claude-sonnet-4-5-20250929",
        4096,
        vec![Message::user(
            "Search for the latest version of the tokio crate, \
             then write Python code to calculate how many days \
             since its release date, and format the results.",
        )],
    )
    .with_tools(vec![
        ToolDefinition::from(web_search),
        ToolDefinition::from(code_exec),
        ToolDefinition::Custom(custom_tool),
    ]);

    // Print the request JSON to show the structure
    println!("Request JSON (tools section):");
    let json = serde_json::to_string_pretty(&request.tools.as_ref().unwrap()).unwrap();
    println!("{}\n", json);

    println!("To send this request, set ANTHROPIC_API_KEY and use:");
    println!("  let response = client.send_message(request).await?;");
}