feat(tools): integrate Seltz as a direct-API search tool (tinyhumansai#1717)

Author: amallia

.env.example

@@ -99,6 +99,17 @@ OPENHUMAN_WEB_SEARCH_MAX_RESULTS=5
 # [optional] Default: 10
 OPENHUMAN_WEB_SEARCH_TIMEOUT_SECS=10
 
+# ---------------------------------------------------------------------------
+# Seltz search (direct API — https://seltz.ai)
+# ---------------------------------------------------------------------------
+# [optional] API key from https://console.seltz.ai. When set, enables the
+# seltz_search agent tool. Fast (<200ms), independent index, domain/date filters.
+# SELTZ_API_KEY=
+# [optional] Override API base URL (default: https://api.seltz.ai/v1)
+# SELTZ_API_URL=
+# [optional] Default max results per query (1-20, default 10)
+# OPENHUMAN_SELTZ_MAX_RESULTS=10
+
 # ---------------------------------------------------------------------------
 # Proxy
 # ---------------------------------------------------------------------------

src/openhuman/config/schema/load.rs

@@ -872,6 +872,27 @@ impl Config {
             }
         }
 
+        // Seltz direct-API search.
+        if let Some(key) = env.get_any(&["OPENHUMAN_SELTZ_API_KEY", "SELTZ_API_KEY"]) {
+            if !key.is_empty() {
+                self.seltz.api_key = Some(key);
+                // Auto-enable when the key is set via env.
+                self.seltz.enabled = true;
+            }
+        }
+        if let Some(url) = env.get_any(&["OPENHUMAN_SELTZ_API_URL", "SELTZ_API_URL"]) {
+            if !url.is_empty() {
+                self.seltz.api_url = Some(url);
+            }
+        }
+        if let Some(max) = env.get_any(&["OPENHUMAN_SELTZ_MAX_RESULTS", "SELTZ_MAX_RESULTS"]) {
+            if let Ok(n) = max.parse::<usize>() {
+                if (1..=20).contains(&n) {
+                    self.seltz.max_results = n;
+                }
+            }
+        }
+
         // `OPENHUMAN_WEB_SEARCH_ENABLED` is intentionally ignored —
         // web search is unconditionally registered in the tool set.
         // Only the result/timeout budget knobs remain environment-configurable.

src/openhuman/config/schema/mod.rs

@@ -64,7 +64,7 @@ pub use storage_memory::{
 pub use tools::{
     BrowserComputerUseConfig, BrowserConfig, ComposioConfig, ComputerControlConfig, CurlConfig,
     GitbooksConfig, HttpRequestConfig, IntegrationToggle, IntegrationsConfig, MultimodalConfig,
-    SecretsConfig, WebSearchConfig,
+    SecretsConfig, SeltzConfig, WebSearchConfig,
 };
 pub use update::{UpdateConfig, UpdateRestartStrategy};
 mod voice_server;

src/openhuman/config/schema/tools.rs

@@ -223,6 +223,47 @@ impl Default for GitbooksConfig {
     }
 }
 
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
+#[serde(default)]
+pub struct SeltzConfig {
+    /// When `true`, register `seltz_search` as an agent tool.
+    #[serde(default)]
+    pub enabled: bool,
+    /// Seltz API key. Can also be set via `SELTZ_API_KEY` or
+    /// `OPENHUMAN_SELTZ_API_KEY` env var.
+    #[serde(default)]
+    pub api_key: Option<String>,
+    /// Override the Seltz API base URL (default: `https://api.seltz.ai/v1`).
+    #[serde(default)]
+    pub api_url: Option<String>,
+    /// Max results per query (1–20, default 10).
+    #[serde(default = "default_seltz_max_results")]
+    pub max_results: usize,
+    /// Per-request timeout in seconds (default 15).
+    #[serde(default = "default_seltz_timeout_secs")]
+    pub timeout_secs: u64,
+}
+
+fn default_seltz_max_results() -> usize {
+    10
+}
+
+fn default_seltz_timeout_secs() -> u64 {
+    15
+}
+
+impl Default for SeltzConfig {
+    fn default() -> Self {
+        Self {
+            enabled: false,
+            api_key: None,
+            api_url: None,
+            max_results: default_seltz_max_results(),
+            timeout_secs: default_seltz_timeout_secs(),
+        }
+    }
+}
+
 #[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
 #[serde(default)]
 pub struct WebSearchConfig {

src/openhuman/config/schema/types.rs

@@ -142,6 +142,9 @@ pub struct Config {
     #[serde(default)]
     pub multimodal: MultimodalConfig,
 
+    #[serde(default)]
+    pub seltz: SeltzConfig,
+
     #[serde(default)]
     pub web_search: WebSearchConfig,
 
@@ -317,6 +320,7 @@ impl Default for Config {
             curl: CurlConfig::default(),
             gitbooks: GitbooksConfig::default(),
             multimodal: MultimodalConfig::default(),
+            seltz: SeltzConfig::default(),
             web_search: WebSearchConfig::default(),
             proxy: ProxyConfig::default(),
             cost: CostConfig::default(),

src/openhuman/integrations/mod.rs

@@ -8,6 +8,7 @@ pub mod apify;
 pub mod client;
 pub mod google_places;
 pub mod parallel;
+pub mod seltz;
 pub mod stock_prices;
 pub mod twilio;
 pub mod types;
@@ -19,6 +20,7 @@ pub use parallel::{
     ParallelChatTool, ParallelDatasetTool, ParallelEnrichTool, ParallelExtractTool,
     ParallelResearchTool, ParallelSearchTool,
 };
+pub use seltz::SeltzSearchTool;
 pub use stock_prices::{
     StockCommodityTool, StockCryptoSeriesTool, StockExchangeRateTool, StockOptionsTool,
     StockQuoteTool,