serdes-ai-tools 0.2.2

Tool system for serdes-ai 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

# serdes-ai-tools

[![Crates.io](https://img.shields.io/crates/v/serdes-ai-tools.svg)](https://crates.io/crates/serdes-ai-tools)
[![Documentation](https://docs.rs/serdes-ai-tools/badge.svg)](https://docs.rs/serdes-ai-tools)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/janfeddersen-wq/serdesAI/blob/main/LICENSE)

> Tool system for serdes-ai agents

This crate provides the tool system for SerdesAI agents:

- `Tool` trait for defining callable tools
- `ToolDefinition` for JSON schema-based tool descriptions
- `SchemaBuilder` for easy parameter schema construction
- `ToolReturn` for structured tool responses

## Installation

```toml
[dependencies]
serdes-ai-tools = "0.1"
```

## Usage

```rust
use serdes_ai_tools::{Tool, ToolDefinition, ToolReturn, ToolResult, SchemaBuilder};

struct MyTool;

impl Tool<()> for MyTool {
    fn definition(&self) -> ToolDefinition {
        ToolDefinition::new("my_tool", "Does something useful")
            .with_parameters(
                SchemaBuilder::new()
                    .string("input", "The input value", true)
                    .build()
                    .unwrap()
            )
    }
    
    async fn call(
        &self,
        _ctx: &RunContext<()>,
        args: serde_json::Value,
    ) -> ToolResult {
        Ok(ToolReturn::text("Done!"))
    }
}
```

## Part of SerdesAI

This crate is part of the [SerdesAI](https://github.com/janfeddersen-wq/serdesAI) workspace.

For most use cases, you should use the main `serdes-ai` crate which re-exports these types.

## License

MIT License - see [LICENSE](https://github.com/janfeddersen-wq/serdesAI/blob/main/LICENSE) for details.