# hhstreamd configuration — the app allowlist. # # This is the main security control (DESIGN.md §8 item 1). Without it, # `hhstream session start /bin/sh` would make every other control decorative. # # The daemon reads this at startup from --config / $HHSTREAM_CONFIG, defaulting # to /etc/hhstream/config.toml. A missing file is not an error: the allowlist is # then empty and every `start` is refused with exit 6, naming the file it looked # for. A misconfigured deployment must not look like a crash. [defaults] # The maximum number of live sessions. With no cgroup caps available (see # DESIGN.md §3.3), this is the primary containment control against a looping # agent spawning browsers, so it is a real setting and not a tuning knob. max_sessions = 4 # Default idle timeout, in seconds. A session with no `touch` for this long is # reaped. `touch` is the only thing that resets the clock. idle_timeout_s = 10800 # 3h # The largest idle timeout a caller may ask for. max_idle_timeout_s = 86400 # 24h # How long `kill` waits between SIGTERM and SIGKILL, by default. grace_s = 10 # How long `start` will wait for readiness before returning exit 7. The session # is left alive either way. wait_ready_s = 15 # --------------------------------------------------------------------------- # Apps. The key is the name a caller passes to `start`; it is never a path. # --------------------------------------------------------------------------- [apps.chromium] # Absolute path, always. Resolution against PATH is refused. exec = "/run/current-system/sw/bin/chromium" # Caller-supplied arguments must each match one of these fnmatch patterns. # An app with no `args_allow` accepts no caller arguments at all. args_allow = ["--new-window", "--app=*", "--user-data-dir=*"] [apps.foot] exec = "/run/current-system/sw/bin/foot" [apps.blender] exec = "/run/current-system/sw/bin/blender" # Fixed arguments, always prepended, never supplied by the caller. args = ["--factory-startup"] args_allow = ["*.blend"] # A per-app default idle timeout, overridden by --idle-timeout. idle_timeout_s = 7200