Phase 1: bump roe-ai to 1.0.802 (public SDK sync)

[jadenfix]

Summary

• Retargets the coordinated Python SDK sync release to 1.0.802.
• Adds generated wrapper support from openapi/wrappers.yml.
• Includes the public SDK discovery, table upload, idempotency key, and wrapper transport updates from the shared SDK contract.
• Keeps this Python PR aligned with the TypeScript and Go SDK sync PRs.

Related PRs

• roe-ai/roe-main#3254
• roe-ai/roe-typescript#16
• Phase 1: bump roe-golang to 1.0.802 (public SDK sync) roe-golang#17

Verification

• uv run --locked ruff check .
• uv run --locked pytest

[greptile-apps]

Greptile Summary

This PR retargets the SDK sync from 2.0.0 to 1.0.82, adding DiscoveryAPI and TablesAPI generated facades, wiring idempotency_key into async agent runs, and migrating several wrapper methods from the sync_detailed + translate_response pattern to the request_raw helper for uniform 404 handling.

• New generated wrappers (src/roe/api/discovery.py, src/roe/api/tables.py) are emitted by scripts/generate_wrappers.py from openapi/wrappers.yml; the CI drift check now covers them so they stay in sync with the spec.
• Idempotency key is threaded through call_dynamic via the new extra_headers parameter; applied in both AgentsAPI.run() and run_version() and verified by a focused transport test.
• File-close lifecycle in TablesAPI.upload correctly distinguishes path-opened handles (close_after=True) from caller-owned BinaryIO objects (close_after=False) using a try/finally block.

Confidence Score: 5/5

Safe to merge — all MCP-facing wrappers, idempotency header propagation, and file-close lifecycle are correctly implemented and covered by unit tests.

The idempotency header wiring in call_dynamic is correct, the generated facades translate errors uniformly through translate_response, and the CI drift check now gates against wrapper/spec divergence. The only gaps are test coverage for run_version idempotency key and a missing 400-error case for the tables upload, neither of which reflects a defect in the shipped code.

No files require special attention; the two test coverage gaps noted are in tests/unit/test_agents_wrapper_transport.py and tests/unit/test_tables.py.

Important Files Changed

Filename	Overview
src/roe/api/agents.py	Adds idempotency_key to run() and run_version(); migrates several methods to request_raw for uniform 404 handling. Correct and well-tested.
src/roe/utils/_dynamic_call.py	Adds optional extra_headers; merged after x-roe-skip-retry, before Content-Type pop. Header ordering is correct.
src/roe/api/tables.py	New generated facade; file-close lifecycle correctly handles all four input types via close_after flag + try/finally.
src/roe/api/discovery.py	New generated facade; None capability correctly translated to UNSET before calling generated endpoint.
src/roe/client.py	Adds getattr to expose generated API groups; dict.get pattern avoids infinite recursion.
scripts/generate_wrappers.py	New codegen script; README regex replacement is correct (DOTALL, count=1).
tests/unit/test_agents_wrapper_transport.py	Covers 404 routing and run() idempotency header; run_version() idempotency path not independently exercised.
.github/workflows/ci.yml	Adds test job; extends drift check to wrappers.yml, readme_blocks.yml, and src/roe/api.

_{Reviews (6): Last reviewed commit: "fix: retarget SDK sync release to 1.0.82" | Re-trigger Greptile}

[jadenfix]

@greptileai final review please. Included in the synced release fan-out drill: Python no-op spec stayed unchanged, synthetic SDK-visible operations generated into roe._generated, version bumped from 2.0.0 to 2.0.1, README release note stayed historical, and the Python test suite passed.

[jadenfix]

@greptile please review this PR in the context of the related SDK/MCP sync PRs. Focus on release-path correctness, generated-code drift, and whether the centralized contract assumptions are robust.

[jadenfix]

@greptile final re-review please in context of the roe-main release fan-out PR. Please focus on generated wrapper drift, README block sync, and whether this 2.0.0 bootstrap is ready to be regenerated by the roe-main prepare-target CLI on future releases.

[jadenfix]

@greptile re-review latest commit please. Added Python SDK CI test/lint and widened codegen drift checks to include wrappers, README blocks, generated friendly API files, and README sync output.

[jadenfix]

@greptile re-review latest head please. This is now 1.0.82 rather than 2.0.0; please focus on the Python SDK wrappers that MCP calls directly, idempotency header propagation, and generated wrapper drift. Prior Greptile was 5/5 but referenced an older commit; please update against the current head.