Releases: nnemirovsky/sluice
Release list
v0.13.1
Bug Fixes
Hermes deployment fixes that emerged from running v0.13.0 in production. All six are real correctness or compatibility issues, not just polish.
- OAuth response handler: now decompresses gzip/br/deflate before parsing the token JSON, and is wrapped in a deferred recover with snapshot/rollback so a malformed body cannot panic the proxy or leave a half-rewritten response with stripped encoding headers. Reproduced live against
auth.openai.comwhich returns gzip by default. - Env-file marker block: sluice now writes phantom tokens into a fenced
BEGIN sluice-managed/END sluice-managedblock and replaces only that block on each call. Foreign keys (set byhermes claw migrate, the agent's own auth flow, or an operator) are preserved across both incremental updates and full reconciliation runs. Values are written single-quoted so the file is safe under both shellsourceand dotenv parsing. - MCP gateway always mounts: the
/mcpendpoint used to mount only when a sluice MCP upstream was registered. Agents that registered sluice as an MCP server (the documented setup) hit a 404 before the operator could add the first upstream. Now the gateway always starts; with zero upstreams it exposes an empty tool list. - HermesProfile WireMCPCmd uses the bundled venv: a sh wrapper activates
/opt/hermes/.venvwhen present so PyYAML is on the import path inside the official Hermes image. Native installs without the venv keep working via the systempython3. - SSH proxy exit-status race:
sshHandleChannelpreviously calledsrcChan.CloseWritefrom the upstream→agent data-copy goroutine the moment it saw EOF, racing the request-forwarder writing exit-status on the same channel. Fix holds the agent-side stdout EOF until every upstream→agent goroutine has drained, then issuesCloseWritefollowed byClose. Stdin direction is unchanged so upstream commands likecatstill terminate correctly. - Configurable Telegram agent label: approval messages used to read "OpenClaw wants to connect to..." regardless of the active profile. New
SetAgentDisplayNameis wired from the--agentflag at startup. Hermes deployments now read "Hermes wants to connect to...". The display name is HTML-escaped at render time.
Deploy files
The repo's compose.yml, compose.dev.yml, and Caddyfile switch to the Hermes stack as the supported deployment. A new bootstrap.sh runs hermes claw migrate against an existing OpenClaw home volume one time, then patches mcp_servers.sluice.url into ~/.hermes/config.yaml. Caddy cert paths moved off provider-specific /etc/cloudflare/... to standard FHS /etc/ssl/certs/agent.pem + /etc/ssl/private/agent.key.
Operators on OpenClaw who want to keep the v0.12.x deployment shape can pin to ghcr.io/nnemirovsky/sluice:0.12 and use the compose / Caddyfile from any v0.12.x tag.
v0.13.0
New Features
- add agent profile abstraction for Hermes support #36 @nnemirovsky
Sluice now supports nousresearch/hermes-agent as a first-class target alongside OpenClaw. The container managers (Docker, Apple Container, tart) consume an AgentProfile that captures the env file path, secrets-reload mechanism, and MCP wiring command for one agent runtime. Select with --agent <name> (or SLUICE_AGENT_PROFILE); default is openclaw so existing setups are unaffected.
The Hermes profile writes phantom tokens to ~/.hermes/.env and patches mcp_servers.<name>.url in ~/.hermes/config.yaml via an embedded python3 + pyyaml script. Hermes has no documented in-place secret reload, so new env values take effect on the next agent message; for MCP changes, run /reload-mcp from the Hermes chat session or restart the container once after first wire-up.
Adding a third agent profile is a single edit to internal/container/agent_profile.go.
v0.12.0
New Features
- add /mcp list, add, remove commands #35 @nnemirovsky
Improvements
- bump go-mitmproxy to v1.8.11 #34 @nnemirovsky
v0.11.0
New Features
- add ExecInspector for trampoline and dangerous pattern detection in MCP tool arguments
- add MITM response DLP scanning for HTTPS response bodies and headers
- add
sluice policy add redactCLI subcommand and/policy redactTelegram command
Details
- ExecInspector (
internal/mcp/exec_inspect.go) detects trampoline patterns (bash -c,python -c), dangerous commands (rm -rf /,chmod 0?[0-7]?777,curl | sh, fork bombs), env overrides (GIT_SSH_COMMAND,LD_PRELOAD,DYLD_INSERT_LIBRARIES), and shell metacharacters. Field-scoped scanning with recursion into nested maps (wrapped schemas), case-insensitive slot matching, and split-argv reconstruction acrosscommand+args. Default tool-name patterns anchored to the MCP__separator to avoid false positives on tools likeshellcheck. - Response DLP (
internal/proxy/response_dlp.go) runs per-response regex scan of buffered response bodies and headers usingInspectRedactRulerows from the policy store. Supportsgzip,br,deflate(zlib-wrapped per RFC 9110), andzstd. Handles up to 2 stacked Content-Encoding layers. Bounded decompression viaio.LimitReadercapped atmaxProxyBody(16 MiB). Distinct from phantom-token stripping, which protects outbound requests. This protects the agent from seeing real credentials leaked by upstreams in responses. - Rule management across all channels. New CLI subcommand
sluice policy add redact <pattern> --replacement "[REDACTED_X]"and Telegram/policy redact <pattern> [replacement]. HTTP API already supported this viaPOST /api/ruleswithverdict: "redact". TOML import/export continues to work via[[redact]]blocks. SIGHUP reloads rebuild the engine and atomically swap viaatomic.Pointer. - Audit redaction.
exec_blockaudit events include only the attack category (trampoline, dangerous_cmd, env_override, metachar), never the raw matched content, so audit logs cannot leak credentials embedded in blocked payloads.
Known limitation
Responses with Content-Type: text/event-stream or bodies exceeding go-mitmproxy's StreamLargeBodies (5 MiB) enter streaming mode, which skips the buffered DLP scan. A one-per-connection WARNING log fires when DLP rules are configured but the response streams. Stream-aware DLP is listed as Future work.
PR: #33
v0.10.2
Fixes
- Stop Telegram from auto-linking destinations in /policy show, /policy allow, /policy deny, and approval prompts (#32). Destinations,
host:port, and request URLs now render as inline monospace.
v0.10.1
v0.10.0
Highlights
QUIC/HTTP3 now works end-to-end through the full tun2proxy -> sluice -> upstream pipeline. UDP and QUIC policy evaluation is now unified with TCP semantics (unscoped rules match all transports, engine default verdict applies). Broader e2e test coverage across WebSocket, gRPC, QUIC/HTTP3, DNS, and IMAP/SMTP.
New Features
- QUIC SNI extraction from Initial packets via RFC 9001 decryption (
ExtractQUICSNI, supports QUIC v1 and v2) - CRYPTO data accumulation across fragmented QUIC Initial packets so SNI can be reassembled from large ClientHellos
- Broker request deduplication with bounded per-session packet buffer (prevents duplicate Telegram prompts during approval wait)
sluice policy add --protocolsflag for creating protocol-scoped rules- WebSocket handshake credential injection (requires the go-mitmproxy fork fixes)
- Comprehensive e2e tests for WebSocket, gRPC, QUIC/HTTP3, DNS, and IMAP/SMTP
Bug Fixes
- QUIC falls back to the engine's configured default verdict instead of hardcoded Deny
- Unscoped policy rules now apply to UDP/QUIC (DNS keeps its own evaluation path)
- Shared-IP session key collision: pending approvals now keyed by hostname, preventing CDN-fronted destinations from colliding
- Race between session publish and pending entry delete closed atomically
httptestservers use IPv4-only listeners to avoid IPv6 bind failures in sandboxed environments- SSH jump host test flakiness addressed
Upstream PRs
- lqqyt2423/go-mitmproxy#100: forward modified request headers on WebSocket upgrade (paired with existing PR firing
Requestheadersfor WS)
v0.9.0
Per-request policy, go-mitmproxy migration, QUIC Ask - Per-request HTTP policy: "Allow Once" means one HTTP request, not one TCP connection - Replaced goproxy with go-mitmproxy for HTTP/2 per-stream interception - gRPC-over-HTTP/2 now has per-request policy (each stream triggers approval) - QUIC/HTTP3 per-request Ask verdicts via EvaluateQUICDetailed - Single Telegram message per request (combined destination + method + path) - WebSocket approval via go-mitmproxy fork (Requestheaders fires before upgrade) - E2E tests with configurable webhook approval channel - Protocol-aware deferred ask for non-TLS protocols (SSH, SMTP, plain TCP)
v0.8.1
fix(cli): wrap fs.Parse with reorderFlagsBeforePositional in 7 commands (#25) Seven CLI subcommands (binding remove, cred remove, policy remove, policy import, mcp remove, channel update, channel remove) called fs.Parse(args) directly, so any positional argument before a flag stopped flag parsing and fell through to flag defaults. With --db, this meant invocations like 'sluice binding remove 2 --db /path' operated on the default data/sluice.db instead of the requested path. Each command now goes through reorderFlagsBeforePositional like the other sibling subcommands already do. Regression tests per command exercise the positional-before-flags ordering. Also fixes the cred dispatcher's usage line to mention the 'update' subcommand added in v0.8.0.
v0.8.0
feat(cli,api,store): binding CRUD, multi-destination cred add, cred update (#24)
- New sluice binding add/list/update/remove CLI subcommands and PATCH /api/bindings/{id}
- New sluice cred update CLI subcommand and PATCH /api/credentials/{name}
- sluice cred add --destination is now repeatable
- New migration 000005: case-insensitive UNIQUE index on bindings(credential, LOWER(destination))
with operator-actionable conflict detection on upgrade
- Bindings of the same credential can share env_var
- Sentinel errors for proper API HTTP status mapping (409/404/400/500)
- CAS-protected credential rollback against concurrent writers
- Authoritative cred type detection via credential_meta