tools.rs

  1mod context_server_registry;
  2mod copy_path_tool;
  3mod create_directory_tool;
  4mod delete_path_tool;
  5mod diagnostics_tool;
  6mod edit_file_tool;
  7mod fetch_tool;
  8mod find_path_tool;
  9mod grep_tool;
 10mod list_directory_tool;
 11mod move_path_tool;
 12mod now_tool;
 13mod open_tool;
 14mod read_file_tool;
 15mod restore_file_from_disk_tool;
 16mod save_file_tool;
 17mod streaming_edit_file_tool;
 18mod subagent_tool;
 19mod terminal_tool;
 20mod tool_permissions;
 21mod web_search_tool;
 22
 23use crate::AgentTool;
 24use language_model::{LanguageModelRequestTool, LanguageModelToolSchemaFormat};
 25
 26pub use context_server_registry::*;
 27pub use copy_path_tool::*;
 28pub use create_directory_tool::*;
 29pub use delete_path_tool::*;
 30pub use diagnostics_tool::*;
 31pub use edit_file_tool::*;
 32pub use fetch_tool::*;
 33pub use find_path_tool::*;
 34pub use grep_tool::*;
 35pub use list_directory_tool::*;
 36pub use move_path_tool::*;
 37pub use now_tool::*;
 38pub use open_tool::*;
 39pub use read_file_tool::*;
 40pub use restore_file_from_disk_tool::*;
 41pub use save_file_tool::*;
 42pub use streaming_edit_file_tool::*;
 43pub use subagent_tool::*;
 44pub use terminal_tool::*;
 45pub use tool_permissions::*;
 46pub use web_search_tool::*;
 47
 48macro_rules! tools {
 49    ($($tool:ty),* $(,)?) => {
 50        /// Every built-in tool name, determined at compile time.
 51        pub const ALL_TOOL_NAMES: &[&str] = &[
 52            $(<$tool>::NAME,)*
 53        ];
 54
 55        const _: () = {
 56            const fn str_eq(a: &str, b: &str) -> bool {
 57                let a = a.as_bytes();
 58                let b = b.as_bytes();
 59                if a.len() != b.len() {
 60                    return false;
 61                }
 62                let mut i = 0;
 63                while i < a.len() {
 64                    if a[i] != b[i] {
 65                        return false;
 66                    }
 67                    i += 1;
 68                }
 69                true
 70            }
 71
 72            const NAMES: &[&str] = ALL_TOOL_NAMES;
 73            let mut i = 0;
 74            while i < NAMES.len() {
 75                let mut j = i + 1;
 76                while j < NAMES.len() {
 77                    if str_eq(NAMES[i], NAMES[j]) {
 78                        panic!("Duplicate tool name in tools! macro");
 79                    }
 80                    j += 1;
 81                }
 82                i += 1;
 83            }
 84        };
 85
 86        /// Returns whether the tool with the given name supports the given provider.
 87        pub fn tool_supports_provider(name: &str, provider: &language_model::LanguageModelProviderId) -> bool {
 88            $(
 89                if name == <$tool>::NAME {
 90                    return <$tool>::supports_provider(provider);
 91                }
 92            )*
 93            false
 94        }
 95
 96        /// A list of all built-in tools
 97        pub fn built_in_tools() -> impl Iterator<Item = LanguageModelRequestTool> {
 98            fn language_model_tool<T: AgentTool>() -> LanguageModelRequestTool {
 99                LanguageModelRequestTool {
100                    name: T::NAME.to_string(),
101                    description: T::description().to_string(),
102                    input_schema: T::input_schema(LanguageModelToolSchemaFormat::JsonSchema).to_value(),
103                }
104            }
105            [
106                $(
107                    language_model_tool::<$tool>(),
108                )*
109            ]
110            .into_iter()
111        }
112    };
113}
114
115tools! {
116    CopyPathTool,
117    CreateDirectoryTool,
118    DeletePathTool,
119    DiagnosticsTool,
120    EditFileTool,
121    FetchTool,
122    FindPathTool,
123    GrepTool,
124    ListDirectoryTool,
125    MovePathTool,
126    NowTool,
127    OpenTool,
128    ReadFileTool,
129    RestoreFileFromDiskTool,
130    SaveFileTool,
131    SubagentTool,
132    TerminalTool,
133    WebSearchTool,
134}