Metadata-Version: 2.4
Name: jharness-tools
Version: 0.3.2
Summary: Ready-to-use filesystem, shell, interaction, and agent tools for JHarness
Project-URL: Documentation, https://github.com/Ezio2000/jharness/blob/main/packages/jharness-tools/README.md
Project-URL: Repository, https://github.com/Ezio2000/jharness.git
Author: JHarness contributors
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: jharness-kernel==0.3.2
Requires-Dist: regex>=2024.11.6
Description-Content-Type: text/markdown

# jharness-tools

Ready-to-use filesystem, shell, interaction, and child-agent tools implementing the
JHarness kernel tool contracts.

```bash
uv add jharness-tools
```

```python
from jharness.tools import GlobTool, GrepTool, ReadTool
```

Filesystem tools are rooted in one workspace and reject path escapes. `BashTool` uses
a bounded non-interactive Bash process and a minimal environment by default, but it is
not an operating-system sandbox: commands retain the filesystem and network access
granted by the host. `inherit_environment=True` explicitly exposes the full host
environment.

Workspace path checks are not a mount namespace; mutually untrusted writers need
dedicated filesystem isolation and hard-link controls. Process-tree cleanup is best
effort, so containers—especially PID 1—must forward signals and reap child processes.

Interaction tools suspend for a host response. Child-agent tools require a host-owned
`AgentBackend`; the host remains responsible for authorization, idempotency,
supervision, and telemetry.

Installing this distribution installs the exact matching `jharness-kernel` version.
