Metadata-Version: 2.5
Name: artifact_tool_v3
Version: 3.0.0
Summary: Host-side library for managing files generated in an agent sandbox.
Author: artifact_tool_v3
License-Expression: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# artifact_tool_v3

Host-side library for managing artifacts an agent writes into a sandbox workspace.

Same core as `artifact_tool_v2`, plus glob filters, a JSON manifest, a size summary, and workspace cleanup.

## Install

```bash
pip install artifact_tool_v3
```

## Workspace location

Each sandbox lives at `{root}/{sandbox_id}/`.

Root is resolved in this order:

1. The `root=` argument to `ArtifactManager`
2. The `ARTIFACT_TOOL_V3_ROOT` environment variable
3. `~/.artifact_tool_v3`

## Usage

```python
from artifact_tool_v3 import ArtifactManager

mgr = ArtifactManager("run-123")
workspace = mgr.ensure_workspace()

artifacts = mgr.discover()
pngs = mgr.list(glob="**/*.png")
print(mgr.summary())
mgr.write_manifest(workspace / "manifest.json")
mgr.export("/tmp/out.zip", format="zip")
mgr.cleanup()
```
