Working in CUAWright

Use Python 3.12 for desktop work. Install with:

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/ 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. 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 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:

pytest -q
python -m build
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.