Merge pull request #4 from senamakel/move-openhuman-core

feat(tools): add model exposure classification

Author: senamakel

crates/tinytools/src/lib.rs

@@ -116,5 +116,5 @@ pub use naming::{
 pub use permission::PermissionLevel;
 pub use result::{ToolContent, ToolResult};
 pub use spec::ToolSpec;
-pub use tool::Tool;
+pub use tool::{Tool, ToolExposure};
 pub use workspace::{SandboxMode, WorkspaceDescriptor};

crates/tinytools/src/tool/mod.rs

@@ -2,7 +2,7 @@
 
 mod types;
 
-pub use types::Tool;
+pub use types::{Tool, ToolExposure};
 
 #[cfg(test)]
 mod test;

crates/tinytools/src/tool/types.rs

@@ -13,6 +13,19 @@ use crate::permission::PermissionLevel;
 use crate::result::ToolResult;
 use crate::spec::ToolSpec;
 
+/// Whether a tool is advertised directly, discoverable on demand, or kept
+/// internal to a host-owned composite capability.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+pub enum ToolExposure {
+    /// Include the tool in the model's initial catalogue.
+    #[default]
+    Direct,
+    /// Omit it initially but allow a tool-search index to reveal it.
+    Deferred,
+    /// Never advertise or index it; only host code may invoke it.
+    Hidden,
+}
+
 /// A capability an agent can invoke.
 ///
 /// Everything beyond [`Self::name`], [`Self::description`],
@@ -149,6 +162,11 @@ pub trait Tool: Send + Sync {
         ToolCategory::System
     }
 
+    /// How this tool enters the model-visible catalogue.
+    fn exposure(&self) -> ToolExposure {
+        ToolExposure::Direct
+    }
+
     /// Whether two concurrent invocations are safe to run in parallel within a
     /// single model turn.
     ///