release: 0.1.0-alpha.1

[stainless-app]

Automated Release PR

0.1.0-alpha.1 (2026-01-24)

Full Changelog: v0.0.1-alpha.0...v0.1.0-alpha.1

⚠ BREAKING CHANGES

• client: change precision of some numeric types
• client: extract auto pagination to shared classes
• client: Migration: - If you were referencing the AutoPager class on a specific *Page or *PageAsync type, then you should instead reference the shared AutoPager and AutoPagerAsync types, under the core package
  • AutoPagerAsync now has different usage. You can call .subscribe(...) on the returned object instead to get called back each page item. You can also call onCompleteFuture() to get a future that completes when all items have been processed. Finally, you can call .close() on the returned object to stop auto-paginating early
  • If you were referencing getNextPage or getNextPageParams:
    • Swap to nextPage() and nextPageParams()
    • Note that these both now return non-optional types (use hasNextPage() before calling these, since they will throw if it's impossible to get another page)

Features

• api: manual updates (d712abb)
• client: add {QueryParams,Headers}#put(String, JsonValue) methods (31f7acd)
• client: add HttpRequest#url() method (a145b94)
• client: add a withOptions method (008f2ee)
• client: add https config options (74d088e)
• client: allow configuring dispatcher executor service (ef7c266)
• client: allow configuring env via system properties (f1de279)
• client: allow providing some params positionally (b24d6c0)
• client: extract auto pagination to shared classes (13f571f)
• client: implement per-endpoint base URL support (f493836)
• client: send X-Stainless-Kotlin-Version header (d9f18bd)

Bug Fixes

• client: bump max requests per host to max requests (5 -> 64) (73b4311)
• client: cancel okhttp call when future cancelled (5823aba)
• client: disallow coercion from float to int (d00944f)
• client: don't close client on withOptions usage when original is gc'd (3d3f673)
• client: ensure error handling always occurs (c4327a3)
• client: fully respect max retries (7c71f9d)
• client: preserve time zone in lenient date-time parsing (50bb540)
• client: remove @MustBeClosed for future returning methods (a6e5c78)
• client: send retry count header for max retries 0 (7c71f9d)
• date time deserialization leniency (9d5f042)

Chores

• ci: enable for pull requests (30e9e4a)
• ci: only run for pushes and fork pull requests (a3e1190)
• ci: upgrade actions/github-script (43107c0)
• ci: upgrade actions/setup-java (75d7ae3)
• configure new SDK language (30ab2b2)
• docs: grammar improvements (33fa7c5)
• internal: allow running specific example from cli (56695c9)
• internal: clean up maven repo artifact script and add html documentation to repo root (6a0f2ca)
• internal: codegen related update (e57fa55)
• internal: codegen related update (44125db)
• internal: correct cache invalidation for SKIP_MOCK_TESTS (adfd7da)
• internal: depend on packages directly in example (7c71f9d)
• internal: improve maven repo docs (da49cb7)
• internal: refactor delegating from client to options (4ea1ff5)
• internal: remove unnecessary [...] in [@see](https://github.com/see) (bed463e)
• internal: support uploading Maven repo artifacts to stainless package server (37c89f8)
• internal: update actions/checkout version (3a146bb)
• internal: update maven repo doc to include authentication (cf7eb23)
• test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind#3240 in tests (9d5f042)

Documentation

• fix missing readme comment (4fd91a7)
• more code comments (f8420f4)
• prominently feature MCP server setup in root SDK readmes (7754ce1)
• remove $ for better copy-pasteabality (fe8a020)

Refactors

• client: change precision of some numeric types (c593d52)
• internal: minor ClientOptionsTest change (b9a8ca8)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK, run:

Add the following URL as a Maven source: 'https://pkg.stainless.com/s/phoebe-java/50bb540673b947b6f5b2da24bb3cac46e3ca498a/mvn'

Expires at: Sun, 22 Feb 2026 07:06:21 GMT
Updated at: Fri, 23 Jan 2026 07:06:21 GMT

[stainless-app]

Note: this release PR has been open for more than 60 days. Until this PR is merged, we will temporarily stop pushing codegen updates due to changes to Stainless' codegen.