AGENTS.md: Check in incremental updates

Assisted-by: Codex

Author: datalogics-kam

AGENTS.md

@@ -9,7 +9,8 @@
 - Workflow definitions are in `.github/workflows/`; adjust only when CI
   requirements change.
 - Documentation and contributor notes reside at the repo root (`README.md`,
-  `AGENTS.md`).
+  `AGENTS.md`). Automation sessions live in `noxfile.py`; keep shared task logic
+  there.
 
 ## Build, Test, and Development Commands
 
@@ -19,31 +20,31 @@
   pushing.
 - `uv run pytest` — execute the suite with the active interpreter.
 - `uv build` — produce wheels and sdists identical to the release workflow.
+- `uvx nox -s tests` — create matrix virtualenvs via nox and execute the pytest
+  session.
 
 ## Coding Style & Naming Conventions
 
-- Target Python 3.9–3.13; use 4-space indentation and type hints for public
+- Target Python 3.10–3.14; use 4-space indentation and type hints for public
   APIs.
 - Black + isort (via ruff) enforce formatting; run through pre-commit prior to
   review.
 - Use `snake_case` for functions/modules, `PascalCase` for classes, and
   `UPPER_SNAKE_CASE` for constants.
 - Prefer `pathlib`, f-strings, and other modern stdlib features—pyupgrade rules
   will flag legacy code.
+- When calling pdfRest, supply the API key via the `Api-Key` header (not
+  `Authorization: Bearer`); keep tests and client defaults in sync with this
+  convention.
 
 ## Testing Guidelines
 
 - Write pytest tests: files named `test_*.py`, test functions `test_*`, fixtures
   in `conftest.py` where shared.
 - Ensure high-value coverage of public functions and edge cases; document intent
   in test docstrings when non-obvious.
-- For interpreter compatibility, execute the matrix locally:
-  ```bash
-  for py in 3.9 3.10 3.11 3.12 3.13; do
-    UV_PROJECT_ENVIRONMENT=.venv-$py uv sync --group dev --python $py
-    UV_PROJECT_ENVIRONMENT=.venv-$py uv run --python $py pytest
-  done
-  ```
+- Use `uvx nox -s tests` to exercise the full interpreter matrix locally when
+  validating compatibility.
 
 ## Commit & Pull Request Guidelines
 
@@ -59,8 +60,8 @@
 ## CI & Publishing Notes
 
 - GitHub Actions run two workflows: `pre-commit` (no AWS credentials) and
-  `Test and Publish` (Python 3.9–3.13 matrix).
+  `Test and Publish` (Python 3.10–3.14 matrix).
 - Only the release job assumes the AWS OIDC role to `uv build` and publish with
-  `uv tool run --from twine twine upload`.
+  `uv publish`.
 - Keep CodeArtifact credentials out of source control; day-to-day development
   should rely solely on public dependencies.