trinkets 0.1.0

Tool registry and execution system for AI agents - goblin loot and treasures
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

# 🎁 Trinkets

Tool registry and execution system for AI agents - goblin loot and treasures.

[![Crates.io](https://img.shields.io/crates/v/trinkets.svg)](https://crates.io/crates/trinkets)
[![Documentation](https://docs.rs/trinkets/badge.svg)](https://docs.rs/trinkets)
[![License](https://img.shields.io/crates/l/trinkets.svg)](LICENSE)

## Overview

Trinkets provides a unified system for AI agents to discover and execute tools:

- **Tool Trait**: Simple interface for implementing tools
- **Registry**: Central registry for tool discovery
- **Router**: Routes tool calls to appropriate handlers
- **Orchestrator**: Coordinates parallel/sequential execution

## Features

- 🔧 Easy-to-implement `Tool` trait
- 📋 JSON Schema support for LLM function calling
- ⚡ Parallel tool execution with concurrency limits
- 🔒 Risk-based approval system
- 🛠️ Built-in tools (shell, file, search)

## Installation

```toml
[dependencies]
trinkets = "0.1"
```

## Usage

```rust
use trinkets::{Tool, ToolRegistry, ToolContext, ToolOutput};
use async_trait::async_trait;
use serde_json::{json, Value};

struct MyTool;

#[async_trait]
impl Tool for MyTool {
    fn name(&self) -> &str { "my_tool" }
    fn description(&self) -> &str { "Does something useful" }
    
    fn parameters_schema(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "input": { "type": "string" }
            }
        })
    }
    
    async fn execute(
        &self, 
        ctx: &ToolContext, 
        args: Value
    ) -> Result<ToolOutput, trinkets::ToolError> {
        Ok(ToolOutput::success("Done!"))
    }
}

// Register and use
let mut registry = ToolRegistry::new();
registry.register(MyTool);

let schemas = registry.schemas(); // For LLM function calling
```

## Built-in Tools

- `shell` - Execute shell commands
- `read_file` - Read file contents
- `write_file` - Write to files
- `list_files` - List directory contents
- `grep` - Search with ripgrep
- `glob` - Find files by pattern

## Part of the Goblin Family

- [warhorn](https://crates.io/crates/warhorn) - Protocol types
- **trinkets** - Tool registry (you are here)
- [wardstone](https://crates.io/crates/wardstone) - Sandboxing
- [skulk](https://crates.io/crates/skulk) - MCP connections
- [hutch](https://crates.io/crates/hutch) - Checkpoints
- [ambush](https://crates.io/crates/ambush) - Task planning
- [cabal](https://crates.io/crates/cabal) - Orchestration

## License

MIT OR Apache-2.0