Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

feat(config): add OPENHUMAN_INBOUND_DEBOUNCE_* env overlay

oxoxDev7741bc40c09d
diff --git a/crates/openhuman-core/src/config/schema/load/env_overlay.rs b/crates/openhuman-core/src/config/schema/load/env_overlay.rs
index cd4d8b94f7..07ff3ad58f 100644
--- a/crates/openhuman-core/src/config/schema/load/env_overlay.rs
+++ b/crates/openhuman-core/src/config/schema/load/env_overlay.rs
@@ -6,6 +6,7 @@
mod components;
mod context;
mod embeddings;
+mod inbound_debounce;
mod modules;
mod observability;
mod proxy;
@@ -247,6 +248,7 @@ impl Config {
self.apply_search_env(env);
self.apply_proxy_env(env);
self.apply_runtime_env(env);
+ self.apply_inbound_debounce_env(env);
self.apply_observability_env(env);
self.apply_embedding_env(env);
self.apply_update_env(env);
diff --git a/crates/openhuman-core/src/config/schema/load/env_overlay/inbound_debounce.rs b/crates/openhuman-core/src/config/schema/load/env_overlay/inbound_debounce.rs
new file mode 100644
index 0000000000..d07b92af3b
--- /dev/null
+++ b/crates/openhuman-core/src/config/schema/load/env_overlay/inbound_debounce.rs
@@ -0,0 +1,56 @@
+//! Env overrides for inbound message batching (`[inbound_debounce]`).
+
+use crate::config::schema::load::env::parse_env_bool;
+use crate::config::schema::load::env::EnvLookup;
+use crate::config::schema::Config;
+
+fn parse_ms(name: &str, raw: &str) -> Option<u64> {
+ let trimmed = raw.trim();
+ if trimmed.is_empty() {
+ return None;
+ }
+ match trimmed.parse::<u64>() {
+ Ok(ms) => Some(ms),
+ Err(_) => {
+ tracing::warn!(
+ env = name,
+ value = trimmed,
+ "[config][inbound_debounce] expected milliseconds as an unsigned integer; ignored"
+ );
+ None
+ }
+ }
+}
+
+impl Config {
+ pub(super) fn apply_inbound_debounce_env<E: EnvLookup + ?Sized>(&mut self, env: &E) {
+ const ENABLED: &str = "OPENHUMAN_INBOUND_DEBOUNCE_ENABLED";
+ if let Some(raw) = env.get(ENABLED) {
+ if !raw.trim().is_empty() {
+ if let Some(enabled) = parse_env_bool(ENABLED, &raw) {
+ self.inbound_debounce.enabled = enabled;
+ }
+ }
+ }
+ let targets: [(&str, &mut u64); 3] = [
+ (
+ "OPENHUMAN_INBOUND_DEBOUNCE_MS",
+ &mut self.inbound_debounce.debounce_ms,
+ ),
+ (
+ "OPENHUMAN_INBOUND_DEBOUNCE_MEDIA_MS",
+ &mut self.inbound_debounce.media_debounce_ms,
+ ),
+ (
+ "OPENHUMAN_INBOUND_DEBOUNCE_MAX_WAIT_MS",
+ &mut self.inbound_debounce.max_wait_ms,
+ ),
+ ];
+ for (name, target) in targets {
+ if let Some(ms) = env.get(name).and_then(|raw| parse_ms(name, &raw)) {
+ tracing::debug!(env = name, ms, "[config][inbound_debounce] env override");
+ *target = ms;
+ }
+ }
+ }
+}
diff --git a/crates/openhuman-core/src/config/schema/load_env_overlay_tests.rs b/crates/openhuman-core/src/config/schema/load_env_overlay_tests.rs
index 4976400cbe..d13daa0c16 100644
--- a/crates/openhuman-core/src/config/schema/load_env_overlay_tests.rs
+++ b/crates/openhuman-core/src/config/schema/load_env_overlay_tests.rs
@@ -553,3 +553,34 @@ fn legacy_disable_channel_listeners_env_folds_into_channels_component() {
cfg.apply_env_overlay_with(&env);
assert!(cfg.components.channels, "explicit component env wins");
}
+
+#[test]
+fn env_overlay_inbound_debounce_applies_and_ignores_garbage() {
+ let mut cfg = Config::default();
+ cfg.apply_env_overlay_with(
+ &HashMapEnv::new()
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_ENABLED", "false")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MS", "800")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MEDIA_MS", " 3000 ")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MAX_WAIT_MS", "9000"),
+ );
+ assert!(!cfg.inbound_debounce.enabled);
+ assert_eq!(cfg.inbound_debounce.debounce_ms, 800);
+ assert_eq!(cfg.inbound_debounce.media_debounce_ms, 3000);
+ assert_eq!(cfg.inbound_debounce.max_wait_ms, 9000);
+
+ cfg.apply_env_overlay_with(
+ &HashMapEnv::new()
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_ENABLED", "maybe")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MS", "-1")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MEDIA_MS", "")
+ .with("OPENHUMAN_INBOUND_DEBOUNCE_MAX_WAIT_MS", "soon"),
+ );
+ assert!(!cfg.inbound_debounce.enabled);
+ assert_eq!(cfg.inbound_debounce.debounce_ms, 800);
+ assert_eq!(cfg.inbound_debounce.media_debounce_ms, 3000);
+ assert_eq!(cfg.inbound_debounce.max_wait_ms, 9000);
+
+ cfg.apply_env_overlay_with(&HashMapEnv::new().with("OPENHUMAN_INBOUND_DEBOUNCE_ENABLED", "on"));
+ assert!(cfg.inbound_debounce.enabled);
+}