組み込みツールの実装

crates/tools/src/lib.rs

@@ -0,0 +1,52 @@
+//! Built-in tools for the Insomnia LLM agent.
+//!
+//! Implements Read / Write / Edit / Glob / Grep on top of the `llm-worker`
+//! `Tool` infrastructure. Filesystem access is mediated by two orthogonal
+//! concerns:
+//!
+//! - [`ScopedFs`] — pod-lifetime, expresses the write-block boundary for
+//!   the current scope. Derived from the manifest and shareable across
+//!   sessions.
+//! - [`ReadTracker`] — session-lifetime, enforces the "read before edit"
+//!   policy via content hashes. Recreated fresh per session.
+//!
+//! The Pod layer owns both instances and passes them to
+//! [`builtin_tools`] when registering tools on a `Worker`.
+
+pub mod error;
+pub mod read_tracker;
+pub mod scoped_fs;
+
+mod edit;
+mod glob;
+mod grep;
+mod read;
+mod write;
+
+pub use edit::edit_tool;
+pub use error::ToolsError;
+pub use glob::glob_tool;
+pub use grep::grep_tool;
+pub use read::read_tool;
+pub use read_tracker::ReadTracker;
+pub use scoped_fs::ScopedFs;
+pub use write::write_tool;
+
+/// Register all builtin tools, wiring them to a shared `ScopedFs`
+/// (pod-lifetime) and `ReadTracker` (session-lifetime).
+///
+/// All returned factories share the same tracker instance so that
+/// `Read` / `Write` / `Edit` see a consistent history across tool
+/// invocations within a single session.
+pub fn builtin_tools(
+    fs: ScopedFs,
+    tracker: ReadTracker,
+) -> Vec<llm_worker::tool::ToolDefinition> {
+    vec![
+        read_tool(fs.clone(), tracker.clone()),
+        write_tool(fs.clone(), tracker.clone()),
+        edit_tool(fs.clone(), tracker.clone()),
+        glob_tool(fs.clone()),
+        grep_tool(fs),
+    ]
+}