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.2
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.2
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.2.tar.gz | 70.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_utilities-3.0.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 136.4 kB
Release files / agent_utilities-3.0.2.tar.gz
| Download URL | agent_utilities-3.0.2.tar.gz |
|---|---|
| Size | 70.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f1980d7c3e4c20d21baf80985628af1627230691058912269762cb052ce2956d
|
|
BLAKE2b-256 checksum How to use checksums |
0a88a7fb1d6529d76f4d345cadde63250101948c8dacb5a45de3dfa73a9e29f6
|
| 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.2-py3-none-any.whl
| Download URL | agent_utilities-3.0.2-py3-none-any.whl |
|---|---|
| Size | 65.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1e8b5efdf44acf3b6234c4b3d76259e9e10e905aff06ff7af6d7e44ec4721c41
|
|
BLAKE2b-256 checksum How to use checksums |
502ad9a4ccbb900f6f0ebfb71a2e66749576f5198b88928593c46e29884db73e
|
| 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.2
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.
