Agent Utilities
The in-run agent harness. agent-utilities holds only the mechanism inside one agent run. It applies the decisions it is given; it does not store, decide, serve or connect on its own.
Version: 3.0.1
What it contains
| Module | What it does inside one run |
|---|---|
agent_utilities.harness.edit_engine |
Parses model-proposed edits (search/replace blocks, unified diffs), applies them with graduated matching, and re-prompts on malformed or unmatched edits. |
agent_utilities.harness.contract_validator |
Checks a tool call's pre-conditions and its output's schema and verifier. |
agent_utilities.harness.constraint_engine |
Enforces hierarchical constraints on tool calls (prompt, tool description, middleware, implementation) and escalates repeated violations. |
agent_utilities.harness.quality_gates |
The pre-emit gate: antipattern detection, a preflight checklist and a multi-dimensional critique, in warn or block mode. |
agent_utilities.runtime |
The developer workspace: typed actions and observations, a stateful shell, local and container backends, a policy gate it is given, and the browser and computer-use tier ports. |
agent_utilities.host_ports |
The protocols the host fills: native and remote toolsets, tool clients, outbound credentials, delegated identity, the fleet catalog and the session keepalive. Without a host every binding port fails closed. |
agent_utilities.core.paths |
Resolves the platform config, data, cache and log directories (ARBORA_CONFIG_DIR, XDG). |
Where everything else lives
- epistemic-graph: facts, records, vocabulary, storage and queries, ingest, retrieval, reasoning, memory, decisions, and learning (evaluation, harness evolution, reward and trace records).
- arbora: admission, auth, served
operations (MCP, REST, A2A), messaging front-ends, the registry and the multiplexer.
arbora hosts this harness and registers the
host_portsproviders. - agent-connector-sdk: connector contracts, transports, the A2A protocol library and connector helpers.
Install and use
pip install agent-utilities
from agent_utilities.runtime import create_workspace
from agent_utilities.runtime.events import CmdRunAction, TestRunAction
async with create_workspace(run_id="r1", prefer_docker=False) as ws:
await ws.act(CmdRunAction(command="git status"))
result = await ws.act(TestRunAction(selector="tests"))
Develop
uv sync --group dev
uv run ruff check . && uv run ruff format --check .
uv run mypy agent_utilities
uv run pytest -q
License
MIT, see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for agent-utilities 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| agent_utilities-3.0.1.tar.gz | 63.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_utilities-3.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 125.2 kB
Release files / agent_utilities-3.0.1.tar.gz
| Download URL | agent_utilities-3.0.1.tar.gz |
|---|---|
| Size | 63.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f8d733c8a1feb6d24b21e277f5016baf802e52a01a0d76b2529d8530f5082d17
|
|
BLAKE2b-256 checksum How to use checksums |
7ed2b40f0b5c9551f6af5920c787c61d99db05eaab2eaff6d78fd83bd3f0a1e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / agent_utilities-3.0.1-py3-none-any.whl
| Download URL | agent_utilities-3.0.1-py3-none-any.whl |
|---|---|
| Size | 61.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4c3ea71a9b3279b3a03a269076f898153e20b5f5402650ec9451f5141855003f
|
|
BLAKE2b-256 checksum How to use checksums |
999e197d56abf9b50339b197cb1b5e33412d6c1e264e5945388fe440be30ee3d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for agent-utilities 3.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
