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.0
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 (GRAPH_OS_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).
- graph-os: admission, auth, served
operations (MCP, REST, A2A), messaging front-ends, the registry and the multiplexer.
graph-os 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.0
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.0.tar.gz | 63.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_utilities-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 124.6 kB
Release files / agent_utilities-3.0.0.tar.gz
| Download URL | agent_utilities-3.0.0.tar.gz |
|---|---|
| Size | 63.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d920c0c7967aad7a7e1e9bc424b3ec238d8637c777daf311477ed1add87cc24d
|
|
BLAKE2b-256 checksum How to use checksums |
492fce7fba20d75d37b790a84a7184c355aa2b3d49b6f1f976eace8e5273c4d8
|
| 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.0-py3-none-any.whl
| Download URL | agent_utilities-3.0.0-py3-none-any.whl |
|---|---|
| Size | 61.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d24d3b4ff4200a16b96068190ee18b2baa9c7477f1893eb7a8575015dd71fe43
|
|
BLAKE2b-256 checksum How to use checksums |
5f6ca468d3aa4eaaa5182f2da00d615a08866867d75155388a95bdc7279c9ce9
|
| 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.0
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.
