AGENTS.md ยท diff

git:20261005.5006d0c to git:20261005.24ebd82

9 added, 8 removed. Audit A to A.

# Working in CUAWright
Use Python 3.12 for desktop work. Install with:
```bash
- pip install -e ".[desktop,test,build]"
+ pip install -e ".[desktop,skill-factory,test,build]" -e extensions/skill-factory
playwright install chromium
```
Keep the browser and desktop runtimes separate:
- `src/cuawright/webwright/` owns browser messages, tools, compaction, and completion.
- `src/cuawright/desktop/` owns the OSWorld VM, guest bridge, explicit submit, and evaluation.
- - `src/cuawright/core/` is only for small contracts that are genuinely identical.
+ - `src/cuawright/core/` holds shared API helpers. Add code here only when both runtimes use it.
Do not introduce a universal agent/model/environment abstraction or duplicate the
browser runtime under another package. Preserve `webwright` compatibility aliases.
- Public code and artifacts must contain only standard Responses-compatible API
- configuration; never persist credentials or endpoint identities.
+ Keep provider-specific private integrations outside this repository. Never save
+ credentials or custom endpoint URLs in run artifacts, examples, or diagnostics.
Before changing desktop prompts, read `src/cuawright/desktop/config/prompts.py` in
full. Plain final text never completes a desktop task; the Actor must execute the
- standalone submit control. Official reproduction must retain the pinned release,
- task setup, evaluator, provenance, and score.
+ standalone command `python /opt/cuawright-tools/submit.py`. Official reproduction
+ must retain the pinned release, task setup, evaluator, provenance, and score.
Validate focused changes first, then run:
```bash
- pytest -q tests/unit release/osworld/tests
+ pytest -q
python -m build
- python tests/packaging/check_wheels.py
+ python -m build extensions/skill-factory
+ python tests/packaging/check_wheels.py dist/cuawright-*.whl extensions/skill-factory/dist/*.whl
```
Keep net changes within 900 production Python lines and 600 test lines. No newly
added production file should exceed 300 lines.