[Release] Tool-Shield โ Hardened Subprocess Sandbox & Execution Guard for AI Agents
Eliminating unbounded tool hangs, zombie process leaks, and context-window pollution during local LLM tool execution.
When autonomous agents (Claude Desktop, Cursor, Ollama/vLLM tool callers) invoke bash scripts, Python interpreters, or external utilities, standard execution wrappers lack low-level defensive isolation. A single hanging command deadlocks the entire agent process. Runaway stack traces dump megabytes of text that crash LLM context windows, and directory traversal escapes access sensitive keys.
Tool-Shield provides an offline, zero-dependency hardened execution sandbox for Python 3.10+:
๐ก๏ธ Process-Group Isolation & Two-Phase Escalation: Dedicated process trees escalate from SIGTERM to hard SIGKILL, ensuring hung network sockets and runaway worker threads are completely eradicated.
๐ฆ Context-Window Protection (Middle Truncation): Enforces a strict 64 KB byte cap, cleanly preserving head and tail tokens while purging bloated middle loops.
๐งน ANSI & Terminal Sanitization: Regex purges color escapes, cursor codes, and encoding artifacts into clean UTF-8 text for LLM JSON parsers.
๐ Jailed Path Confinement: Canonical path resolver intercepts directory traversal (../../) attempts before any file action is allowed.
๐ Microsecond Forensic Flight Log: Embedded SQLite audit database (sandbox_audit.db) records timestamps, exit codes, and latency traces.
๐ฆ 100% Python Stdlib: Zero external pip dependencies. Runs offline across Linux, macOS, and Windows.
๐ฐ Pricing: $19 USD (One-time payment โข Lifetime As-Is Commercial License)
๐ Direct Checkout: https://whop.com/checkout/plan_mgzidlRzj4Pdq
๐ Technical Spec & Benchmarks: https://sparkgrin-labs.github.io/articles/tool-shield.html
