anyclaw-sdk-tool 0.3.10

//! Tool SDK for anyclaw.
//!
//! Provides the [`Tool`] trait for building MCP-compatible tools and
//! [`ToolServer`] for serving them over stdio.
//!
//! # Stability
//!
//! This crate is **unstable** — APIs may change between releases.
//! Enums marked `#[non_exhaustive]` will have new variants added; match arms must include `_`.
#![warn(missing_docs)]

/// Error types for tool SDK operations.
pub mod error;
/// Media delivery trait for direct channel delivery (Phase 6).
pub mod media_delivery;
/// MCP tool server that dispatches to [`Tool`] implementations.
// D-03 boundary: Tool I/O is inherently dynamic — JSON Schema input, arbitrary JSON output.
// All Value usages in server.rs flow from the Tool trait contract being Value-based.
#[allow(clippy::disallowed_types)]
pub mod server;
/// The [`Tool`] trait that tool authors implement.
// D-03 boundary: Tool I/O uses Value because tool input is defined by a JSON Schema
// (no fixed Rust type) and tool output is arbitrary JSON. See trait_def.rs doc comments.
#[allow(clippy::disallowed_types)]
pub mod trait_def;
/// Workspace access trait for scoped filesystem and exec operations.
pub mod workspace_exec;

pub use error::ToolSdkError;
pub use media_delivery::{DynMediaDelivery, MediaDelivery, NoopMediaDelivery};
pub use server::ToolServer;
pub use trait_def::{DynTool, Tool, ToolContext};
pub use workspace_exec::{DynWorkspaceExec, ExecOutput, WorkspaceExec};

#[cfg(test)]
mod tests {
    use super::*;
    use rstest::rstest;

    #[rstest]
    fn when_tool_sdk_error_reexported_then_accessible() {
        let err = ToolSdkError::ExecutionFailed("test".into());
        assert!(err.to_string().contains("test"));
    }

    #[rstest]
    fn when_tool_trait_reexported_then_accessible() {
        // Verify Tool trait is usable as a bound through the re-export
        fn _accepts_tool<T: Tool>(_t: &T) {}
    }

    #[rstest]
    fn when_dyn_tool_alias_reexported_then_accessible() {
        // Verify DynTool is a valid trait object type through the re-export
        fn _accepts_dyn_tool(_t: &dyn DynTool) {}
    }

    #[rstest]
    fn when_media_delivery_reexported_then_accessible() {
        // Verify MediaDelivery types are usable through re-exports
        fn _accepts_dyn_media(_d: &dyn DynMediaDelivery) {}
        let _noop = NoopMediaDelivery;
    }
}