[moonyue-w]

Change

Java 0.1.0 exposes Forward only, so Managed users must construct raw requests and cannot rely on typed contracts. Add ManagedClient / AsyncManagedClient and all 108 documented Managed operations, keeping the Forward and Managed additions together in the planned 0.2.0 release.

The change covers Agent versions, Deployments/Runs, Sessions/Threads/SSE/resources, self-hosted Work, resource APIs, OAuth, Memory Stores, Models and Dreams. It preserves decimal Credits, nullable budget updates, runtime Agent patches, Session provenance metadata, opaque cursors and unknown response fields. Add public guides, a coverage inventory and opt-in JAR consumer checks.

The contract baseline is the official Managed API documentation, checked on 2026-10-28. The complete operation mapping is in docs/managed-api-coverage.md. This is a Java-only addition; Go, Python and TypeScript behavior is unchanged. Existing Forward entry points remain compatible.

Validation

• SDK build, tests and Javadoc pass.
• Independent examples consume the installed JAR and pass.
• Java 8 package check passes; runtime behavior checked on Java 8, 11, 17, 21 and 25.
• Documentation and changelog reflect public behavior changes.
• make quality passes on JDK 17+.
• Version files are intentionally unchanged; both POMs and the release changelog will be updated in the combined 0.2.0 version PR.

Commands: ./mvnw -B -ntp clean install, ./mvnw -B -ntp -f examples/pom.xml clean verify, python3 .github/scripts/check_package.py, make quality, and python3 .github/scripts/check_central_bundle.py.

• Java 8/11/17/21/25: 1,244 SDK + 74 independent consumer tests per JDK, all passing without skips; package checks pass.
• make quality and disposable Central signing/reproducibility check pass; no publication.
• Final local JAR: all 20 CN/Global × PAT/SA Managed read/resources/session/deployment/work groups pass. Twelve environment cleanup deletions return 409 and are recorded separately.
• Original failed acceptance attempts are retained. Corrected the test assumption about non-downloadable uploads and constrained Work polling to the documented 1–999 ms range before repeating all groups.

Not covered live: OAuth authorization, OSS mounts, Dream execution, actual self-hosted worker execution, production fault injection or long-duration stability. This local validation does not replace merged-SHA internal integration and QA package acceptance. Keep POM versions unchanged until the combined 0.2.0 version PR.

Local acceptance source: 93c5a6792581033c5d9ee133ba11885f643ac3c2. Local JAR SHA-256: ec1b5b74a2f80c942cf8ae92a54dc152e6a21d3f26682565bb8d5675453f418a. This is a development build, not an internal-pipeline QA artifact; merged-main internal testing and QA approval remain separate gates.