ya-agent-environment
Environment abstractions for general agents.
ya-agent-environment provides the shared base interfaces used by YA agents:
EnvironmentFileOperatorShellResourceRegistry- resumable resources
TmpFileOperator
The Python import package is ya_agent_environment.
Shell Backend Contract
Custom Shell backends implement _create_process() and return an ExecutionHandle with stream, wait, and kill callbacks. Shell.execute() is the final public foreground boundary and must not be overridden: the base class owns process creation, timeout, cancellation, foreground/background registration, and session-reset cleanup. The foreground timeout budget begins before process creation, but shell-owned creation still resolves and terminates any eventual handle before reporting timeout. Class creation raises TypeError when final MRO resolution replaces execute(), so direct and mixin-based legacy overrides fail fast instead of silently bypassing lifecycle ownership; migrate their process creation into _create_process(). A wait callback must not report natural completion while owned descendants remain, and a kill callback must not return until backend execution is confirmed terminated; raising preserves the handle for a later reset retry. Backends must retain a stable execution identity through termination: a POSIX numeric PGID is no longer an ownership handle after its leader is reaped, so residual-group cleanup requires a live guardian or an equivalent platform-owned primitive.
Development
This package is maintained as a workspace member in ya-mono.
uv run python -m pytest packages/ya-agent-environment/tests -vv
uv run python -m pyright
uv build --package ya-agent-environment -o dist
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ya_agent_environment-1.14.2.tar.gz.
File metadata
- Download URL: ya_agent_environment-1.14.2.tar.gz
- Upload date:
- Size: 62.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
27add96fd0117863aadba28430b126f8e3c0963b0670bdac7b1a17ee047ac029
|
|
| MD5 |
26e20a278e890ceb63ebfbea99c471c9
|
|
| BLAKE2b-256 |
34a3a1e081b01beec77f27065f4c9b739282d6e351dcfff7c090baf4b73dd870
|
File details
Details for the file ya_agent_environment-1.14.2-py3-none-any.whl.
File metadata
- Download URL: ya_agent_environment-1.14.2-py3-none-any.whl
- Upload date:
- Size: 41.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5bcf1d18fe41f11864818859a12217bee9d5e2f9a5c9ba34d4999e1744371186
|
|
| MD5 |
72582f51812fb44761c46273bb400061
|
|
| BLAKE2b-256 |
4e836c10eb3ff957c08a231d7ded126a405446c4099de0b20e467f4c0495b586
|
