ya-agent-environment 0.74.0__tar.gz

ya_agent_environment-0.74.0/.gitignore

@@ -0,0 +1,140 @@
+docs/source
+
+# From https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Vscode config files
+# .vscode/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

ya_agent_environment-0.74.0/CONTRIBUTING.md

@@ -0,0 +1,31 @@
+# Contributing to `ya-agent-environment`
+
+`ya-agent-environment` is maintained inside the `ya-mono` workspace.
+
+## Local Development
+
+```bash
+git clone https://github.com/wh1isper/ya-mono.git
+cd ya-mono
+make install
+```
+
+Run package tests:
+
+```bash
+uv run python -m pytest packages/ya-agent-environment/tests -vv
+```
+
+Run repository checks before a pull request:
+
+```bash
+make lint
+make check
+make test
+```
+
+## Guidelines
+
+- Keep the import package name `ya_agent_environment` for compatibility.
+- Put relay protocol work in the sibling `packages/ya-environment-relay` package.
+- Update tests and docs when changing public protocols, environment interfaces, shell behavior, file operations, or resource state.

ya_agent_environment-0.74.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, wh1isper
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

ya_agent_environment-0.74.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: ya-agent-environment
+Version: 0.74.0
+Summary: Environment abstractions for general agents
+Project-URL: Repository, https://github.com/wh1isper/ya-mono
+Author-email: wh1isper <jizhongsheng957@gmail.com>
+License-File: LICENSE
+Keywords: agent,environment,python
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.11
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# ya-agent-environment
+
+Environment abstractions for general agents.
+
+`ya-agent-environment` provides the shared base interfaces used by YA agents:
+
+- `Environment`
+- `FileOperator`
+- `Shell`
+- `ResourceRegistry`
+- resumable resources
+- `TmpFileOperator`
+
+The Python import package is `ya_agent_environment`.
+
+Relay protocol work lives in the sibling [`ya-environment-relay`](../ya-environment-relay) package.
+
+## Development
+
+This package is maintained as a workspace member in `ya-mono`.
+
+```bash
+uv run python -m pytest packages/ya-agent-environment/tests -vv
+uv run python -m pyright
+uv build --package ya-agent-environment -o dist
+```

ya_agent_environment-0.74.0/README.md

@@ -0,0 +1,26 @@
+# ya-agent-environment
+
+Environment abstractions for general agents.
+
+`ya-agent-environment` provides the shared base interfaces used by YA agents:
+
+- `Environment`
+- `FileOperator`
+- `Shell`
+- `ResourceRegistry`
+- resumable resources
+- `TmpFileOperator`
+
+The Python import package is `ya_agent_environment`.
+
+Relay protocol work lives in the sibling [`ya-environment-relay`](../ya-environment-relay) package.
+
+## Development
+
+This package is maintained as a workspace member in `ya-mono`.
+
+```bash
+uv run python -m pytest packages/ya-agent-environment/tests -vv
+uv run python -m pyright
+uv build --package ya-agent-environment -o dist
+```

ya_agent_environment-0.74.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "ya-agent-environment"
+dynamic = ["version"]
+description = "Environment abstractions for general agents"
+authors = [{ name = "wh1isper", email = "jizhongsheng957@gmail.com" }]
+readme = "README.md"
+keywords = ["python", "agent", "environment"]
+requires-python = ">=3.11,<3.14"
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "anyio>=4.0.0",
+    "pathspec>=0.12.0",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/wh1isper/ya-mono"
+
+[dependency-groups]
+dev = [
+    "pytest>=7.2.0",
+    "pre-commit>=2.20.0",
+    "pytest-asyncio>=0.25.3",
+    "deptry>=0.22.0",
+    "pyright>=1.1.0",
+    "pytest-cov>=4.0.0",
+    "ruff>=0.9.2",
+]
+
+[build-system]
+requires = ["hatchling", "uv-dynamic-versioning>=0.7.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.uv-dynamic-versioning]
+vcs = "git"
+style = "pep440"
+bump = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["ya_agent_environment"]
+
+[tool.deptry]
+ignore = ["DEP001", "DEP002"]
+package_module_name_map = { "anyio" = "anyio", "pathspec" = "pathspec", "pydantic" = "pydantic", "ya-agent-environment" = "ya_agent_environment" }
+per_rule_ignores = { DEP004 = ["pytest"] }

ya_agent_environment-0.74.0/tests/__init__.py

@@ -0,0 +1 @@
+# Tests for ya_agent_environment

ya_agent_environment-0.74.0/tests/conftest.py

@@ -0,0 +1,241 @@
+"""Shared test fixtures and mock classes for ya_agent_environment tests."""
+
+from pathlib import Path
+from typing import Any
+
+from ya_agent_environment import (
+    BaseResource,
+    Environment,
+    FileOperator,
+    FileStat,
+    Shell,
+)
+from ya_agent_environment.shell import ExecutionHandle
+
+# --- Test fixtures and helpers ---
+
+
+class SimpleResource:
+    """A simple resource that only has close()."""
+
+    def __init__(self) -> None:
+        self.closed = False
+        self.setup_called = False
+
+    def close(self) -> None:
+        self.closed = True
+
+    async def setup(self) -> None:
+        self.setup_called = True
+
+    def get_toolsets(self) -> list[Any]:
+        return []
+
+
+class ResumableMockResource:
+    """A resumable resource for testing."""
+
+    def __init__(self, initial_data: str = "") -> None:
+        self.data = initial_data
+        self.closed = False
+        self.setup_called = False
+        self._restored_state: dict[str, Any] | None = None
+
+    async def setup(self) -> None:
+        self.setup_called = True
+
+    async def export_state(self) -> dict[str, Any]:
+        return {"data": self.data}
+
+    async def restore_state(self, state: dict[str, Any]) -> None:
+        self.data = state.get("data", "")
+        self._restored_state = state
+
+    def close(self) -> None:
+        self.closed = True
+
+    def get_toolsets(self) -> list[Any]:
+        return []
+
+
+class MockBaseResource(BaseResource):
+    """A BaseResource subclass for testing."""
+
+    def __init__(self, value: str = "") -> None:
+        self.value = value
+        self.closed = False
+
+    async def close(self) -> None:
+        self.closed = True
+
+    async def export_state(self) -> dict[str, Any]:
+        return {"value": self.value}
+
+    async def restore_state(self, state: dict[str, Any]) -> None:
+        self.value = state.get("value", "")
+
+
+class MinimalBaseResource(BaseResource):
+    """A minimal BaseResource subclass with default export/restore."""
+
+    def __init__(self) -> None:
+        self.closed = False
+
+    async def close(self) -> None:
+        self.closed = True
+
+
+class ResourceWithInstructions(BaseResource):
+    """A BaseResource subclass with context instructions."""
+
+    def __init__(self, instructions: str) -> None:
+        self._instructions = instructions
+        self.closed = False
+
+    async def close(self) -> None:
+        self.closed = True
+
+    async def get_context_instructions(self) -> str | None:
+        return self._instructions
+
+
+class ResourceWithEnvAccess(BaseResource):
+    """A resource that captures environment references during creation."""
+
+    def __init__(
+        self,
+        file_operator: FileOperator,
+        shell: Shell,
+    ) -> None:
+        self.file_operator = file_operator
+        self.shell = shell
+        self.closed = False
+
+    async def close(self) -> None:
+        self.closed = True
+
+
+# --- Mock Environment for integration tests ---
+
+
+class MockFileOperator(FileOperator):
+    """Mock FileOperator for testing."""
+
+    def __init__(self) -> None:
+        super().__init__(
+            default_path=Path("/tmp/mock"),
+            allowed_paths=[Path("/tmp/mock")],
+        )
+
+    async def _read_file_impl(
+        self, path: str, *, encoding: str = "utf-8", offset: int = 0, length: int | None = None
+    ) -> str:
+        return ""
+
+    async def _read_bytes_impl(self, path: str, *, offset: int = 0, length: int | None = None) -> bytes:
+        return b""
+
+    async def _write_file_impl(self, path: str, content: str | bytes, *, encoding: str = "utf-8") -> None:
+        pass
+
+    async def _append_file_impl(self, path: str, content: str | bytes, *, encoding: str = "utf-8") -> None:
+        pass
+
+    async def _delete_impl(self, path: str) -> None:
+        pass
+
+    async def _list_dir_impl(self, path: str) -> list[str]:
+        return []
+
+    async def _exists_impl(self, path: str) -> bool:
+        return False
+
+    async def _is_file_impl(self, path: str) -> bool:
+        return False
+
+    async def _is_dir_impl(self, path: str) -> bool:
+        return False
+
+    async def _mkdir_impl(self, path: str, *, parents: bool = False) -> None:
+        pass
+
+    async def _move_impl(self, src: str, dst: str) -> None:
+        pass
+
+    async def _copy_impl(self, src: str, dst: str) -> None:
+        pass
+
+    async def _stat_impl(self, path: str) -> FileStat:
+        return FileStat(size=0, mtime=0, is_file=False, is_dir=False)
+
+    async def _glob_impl(self, pattern: str) -> list[str]:
+        return []
+
+
+class MockShell(Shell):
+    """Mock Shell for testing."""
+
+    def __init__(self) -> None:
+        super().__init__(default_cwd=Path("/tmp/mock"))
+
+    async def execute(
+        self,
+        command: str,
+        *,
+        timeout: float | None = None,
+        env: dict[str, str] | None = None,
+        cwd: str | None = None,
+    ) -> tuple[int, str, str]:
+        return (0, "", "")
+
+    async def _create_process(
+        self,
+        command: str,
+        *,
+        env: dict[str, str] | None = None,
+        cwd: str | None = None,
+    ) -> ExecutionHandle:
+        import asyncio
+        import contextlib
+
+        stdout_stream = asyncio.StreamReader()
+        stderr_stream = asyncio.StreamReader()
+
+        async def _execute() -> int:
+            exit_code, stdout, stderr = await self.execute(command, timeout=None, env=env, cwd=cwd)
+            if stdout:
+                stdout_stream.feed_data(stdout.encode("utf-8"))
+            stdout_stream.feed_eof()
+            if stderr:
+                stderr_stream.feed_data(stderr.encode("utf-8"))
+            stderr_stream.feed_eof()
+            return exit_code
+
+        exec_task = asyncio.create_task(_execute())
+
+        async def _wait() -> int:
+            return await exec_task
+
+        async def _kill() -> None:
+            exec_task.cancel()
+            with contextlib.suppress(asyncio.CancelledError):
+                await exec_task
+
+        return ExecutionHandle(
+            stdout=stdout_stream,
+            stderr=stderr_stream,
+            wait=_wait,
+            kill=_kill,
+        )
+
+
+class MockEnvironment(Environment):
+    """Mock Environment for testing."""
+
+    async def _setup(self) -> None:
+        self._file_operator = MockFileOperator()
+        self._shell = MockShell()
+
+    async def _teardown(self) -> None:
+        self._file_operator = None
+        self._shell = None