release: 0.1.0-alpha.2 (#2)

* chore(internal): codegen related update

* codegen metadata

* codegen metadata

* codegen metadata

* docs: add more examples

* feat(api): api update

* codegen metadata

* feat(client): add `HttpRequest#url()` method

* feat(client): allow configuring dispatcher executor service

* codegen metadata

* chore(internal): support uploading Maven repo artifacts to stainless package server

* refactor(client): handling of absent pagination total

* chore(internal): clean up maven repo artifact script and add html documentation to repo root

* codegen metadata

* codegen metadata

* chore: test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind#3240 in tests
fix: date time deserialization leniency

* chore(internal): improve maven repo docs

* fix(client): disallow coercion from float to int

* chore(internal): update `actions/checkout` version

* fix(client): fully respect max retries
fix(client): send retry count header for max retries 0
chore(internal): depend on packages directly in example

* chore(ci): upgrade `actions/setup-java`

* chore(internal): update maven repo doc to include authentication

* feat(client): send `X-Stainless-Kotlin-Version` header

* feat(api): api update

* fix(tests): add missing query/header params

* docs: add comment for arbitrary value fields

* chore(internal): correct cache invalidation for `SKIP_MOCK_TESTS`

* fix(client): preserve time zone in lenient date-time parsing

* chore(ci): upgrade `actions/github-script`

* codegen metadata

* codegen metadata

* chore(internal): allow passing args to `./scripts/test`

* codegen metadata

* codegen metadata

* codegen metadata

* feat(api): api update

* codegen metadata

* chore(internal): upgrade AssertJ

* codegen metadata

* codegen metadata

* feat(api): api update

* Add CONTRIBUTING.md (#4)

* Add a simple tool call example (#5)

This example uses the Spotify.ResumePlayback tool

* Add AuthService util methods to make getting started with Arcade easier (#6)

Adds `client.auth().start(...)` and `client.auth().waitForCompletion(...)`

In the async client: `asyncClient.auth().start()`, async clients must handle blocking polling call manually.

* feat(api): api update

* chore(internal): update `TestServerExtension` comment

* feat(api): api update

* chore(internal): make `OkHttp` constructor internal

* feat(client): add connection pooling option

* feat(api): api update

* codegen metadata

* chore: make `Properties` more resilient to `null`

* chore: drop apache dependency

* chore(internal): expand imports

* feat(api): api update

* feat(api): api update

* Add Spring Boot starter for Arcade SDK (#8)

* Add Spring Boot starter for Arcade SDK

* Adds Spring AI example

* feat: add Java-friendly convenience methods for JsonValue and tool response output (#9)

* Cleanup and add more example code (#10)

* Simplify and cleanup examples

* Add examples from documentation

* release: 0.1.0-alpha.2

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Brian Demers <brian.demers@gmail.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -1,55 +1,103 @@
 name: CI
 on:
   push:
-    branches:
-      - main
+    branches-ignore:
+      - 'generated'
+      - 'codegen/**'
+      - 'integrated/**'
+      - 'stl-preview-head/**'
+      - 'stl-preview-base/**'
   pull_request:
-    branches:
-      - main
-      - next
+    branches-ignore:
+      - 'stl-preview-head/**'
+      - 'stl-preview-base/**'
 
 jobs:
   lint:
+    timeout-minutes: 15
     name: lint
-    runs-on: ubuntu-latest
-    
+    runs-on: ${{ github.repository == 'stainless-sdks/arcade-engine-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
             8
-            17
+            21
           cache: gradle
 
       - name: Set up Gradle
         uses: gradle/actions/setup-gradle@v4
 
       - name: Run lints
         run: ./scripts/lint
+
+  build:
+    timeout-minutes: 15
+    name: build
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ${{ github.repository == 'stainless-sdks/arcade-engine-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Java
+        uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: |
+            8
+            21
+          cache: gradle
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Build SDK
+        run: ./scripts/build
+
+      - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/arcade-engine-java'
+        id: github-oidc
+        uses: actions/github-script@v8
+        with:
+          script: core.setOutput('github_token', await core.getIDToken());
+
+      - name: Build and upload Maven artifacts
+        if: github.repository == 'stainless-sdks/arcade-engine-java'
+        env:
+          URL: https://pkg.stainless.com/s
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          PROJECT: arcade-engine-java
+        run: ./scripts/upload-artifacts
   test:
+    timeout-minutes: 15
     name: test
-    runs-on: ubuntu-latest
-
+    runs-on: ${{ github.repository == 'stainless-sdks/arcade-engine-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
             8
-            17
+            21
           cache: gradle
 
       - name: Set up Gradle
         uses: gradle/gradle-build-action@v2
 
       - name: Run tests
         run: ./scripts/test
-

.github/workflows/publish-sonatype.yml

@@ -14,15 +14,15 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
             8
-            17
+            21
           cache: gradle
 
       - name: Set up Gradle
@@ -33,7 +33,7 @@ jobs:
           export -- GPG_SIGNING_KEY_ID
           printenv -- GPG_SIGNING_KEY | gpg --batch --passphrase-fd 3 --import 3<<< "$GPG_SIGNING_PASSWORD"
           GPG_SIGNING_KEY_ID="$(gpg --with-colons --list-keys | awk -F : -- '/^pub:/ { getline; print "0x" substr($10, length($10) - 7) }')"
-          ./gradlew publish
+          ./gradlew publish --no-configuration-cache
         env:
           SONATYPE_USERNAME: ${{ secrets.ARCADE_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
           SONATYPE_PASSWORD: ${{ secrets.ARCADE_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'ArcadeAI/arcade-java' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Check release environment
         run: |

.gitignore

@@ -1,6 +1,7 @@
 .prism.log
 .gradle
 .idea
-build
+.kotlin
+build/
 codegen.log
 kls_database.db

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.1"
+  ".": "0.1.0-alpha.2"
 }

.stats.yml

@@ -1,2 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-4dc4e58ef402ce5362e0a8988b3928a8bfa0d5ba847f7ad8b14226a0cf282f28.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-6ff494eafa2c154892716407682bb2296cff4f18c45765c5fb16bdf36f452ae1.yml
+openapi_spec_hash: 63dde2481a7d51042a241bfba232b0b0
+config_hash: bf64816643634a621cd0ffd93d9c4347

CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## 0.1.0-alpha.2 (2026-02-28)
+
+Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/ArcadeAI/arcade-java/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)
+
+### Features
+
+* add Java-friendly convenience methods for JsonValue and tool response output ([#9](https://github.com/ArcadeAI/arcade-java/issues/9)) ([c44efc8](https://github.com/ArcadeAI/arcade-java/commit/c44efc838f588171cb9f5dc2ab75be58479567fc))
+* **api:** api update ([1c45d3e](https://github.com/ArcadeAI/arcade-java/commit/1c45d3ed9c42bcf23ffc18c4877599e5d793b4dc))
+* **api:** api update ([bb94f57](https://github.com/ArcadeAI/arcade-java/commit/bb94f5702271dd02242fcf349e4f6a454ba5cbda))
+* **api:** api update ([04fcbf1](https://github.com/ArcadeAI/arcade-java/commit/04fcbf1d46d1556e107f33d49e72ed906c2fabf8))
+* **api:** api update ([6b1998f](https://github.com/ArcadeAI/arcade-java/commit/6b1998f5e5b4be5fc38204fa5176a6cba6758cf3))
+* **api:** api update ([cb15386](https://github.com/ArcadeAI/arcade-java/commit/cb1538608fd7d030860ed13ed1ffcf6b01d94a28))
+* **api:** api update ([d965caa](https://github.com/ArcadeAI/arcade-java/commit/d965caad240981417886b04d41b7cfb6c6807425))
+* **api:** api update ([5f47131](https://github.com/ArcadeAI/arcade-java/commit/5f471314476dfce0cd0595fbdcabf7119ffd8266))
+* **api:** api update ([8edb811](https://github.com/ArcadeAI/arcade-java/commit/8edb811c4e9729e9b5ddc88a694bf9b81834327b))
+* **api:** api update ([bdacc08](https://github.com/ArcadeAI/arcade-java/commit/bdacc081f002a2ea9e44b4b8577b3f0f419a7f9d))
+* **client:** add `HttpRequest#url()` method ([8840c08](https://github.com/ArcadeAI/arcade-java/commit/8840c08871296bd8c8954e69d8b8d9a215383e28))
+* **client:** add connection pooling option ([c227e1f](https://github.com/ArcadeAI/arcade-java/commit/c227e1f817f7cc5bc96d545854a85709d1c9abfb))
+* **client:** allow configuring dispatcher executor service ([6a9cf95](https://github.com/ArcadeAI/arcade-java/commit/6a9cf95d67e77e46159d652442250d93aeb9b1a7))
+* **client:** send `X-Stainless-Kotlin-Version` header ([4708f4d](https://github.com/ArcadeAI/arcade-java/commit/4708f4d106ba6d1e250f652da7155f92a0be3a60))
+
+
+### Bug Fixes
+
+* **client:** disallow coercion from float to int ([a73ee11](https://github.com/ArcadeAI/arcade-java/commit/a73ee115e09984525883d5334ceb6b5afad7934e))
+* **client:** fully respect max retries ([ff68350](https://github.com/ArcadeAI/arcade-java/commit/ff68350ed3a78064eee3dc46c2caccd71faf5f97))
+* **client:** preserve time zone in lenient date-time parsing ([ab98898](https://github.com/ArcadeAI/arcade-java/commit/ab988986ff4782e4218f189bd1cee26138a66516))
+* **client:** send retry count header for max retries 0 ([ff68350](https://github.com/ArcadeAI/arcade-java/commit/ff68350ed3a78064eee3dc46c2caccd71faf5f97))
+* date time deserialization leniency ([f7f0332](https://github.com/ArcadeAI/arcade-java/commit/f7f0332fbd4e6bb3de2f0738ca1072a2ccfed169))
+* **tests:** add missing query/header params ([63d142a](https://github.com/ArcadeAI/arcade-java/commit/63d142a789cd0bd2170cfb30ea04d0f9ff8cd6d5))
+
+
+### Chores
+
+* **ci:** upgrade `actions/github-script` ([bc708e6](https://github.com/ArcadeAI/arcade-java/commit/bc708e664167b55d6da8adc5e5b5248151dd76fb))
+* **ci:** upgrade `actions/setup-java` ([cb10ea7](https://github.com/ArcadeAI/arcade-java/commit/cb10ea791a3ef48655eafe4cf0a42691cad4794d))
+* drop apache dependency ([cbf0f1e](https://github.com/ArcadeAI/arcade-java/commit/cbf0f1eab15563592bed7c6be68b11a38de68a5c))
+* **internal:** allow passing args to `./scripts/test` ([09fdab4](https://github.com/ArcadeAI/arcade-java/commit/09fdab4518905c63d49be270b68517c1b3e1436a))
+* **internal:** clean up maven repo artifact script and add html documentation to repo root ([54eaec7](https://github.com/ArcadeAI/arcade-java/commit/54eaec7dc0bc56c4059e5bdbf087cd14119e8f3e))
+* **internal:** codegen related update ([2a1703d](https://github.com/ArcadeAI/arcade-java/commit/2a1703d633b6f1ef888c84bb0f97a489707fdf2b))
+* **internal:** correct cache invalidation for `SKIP_MOCK_TESTS` ([3aa593e](https://github.com/ArcadeAI/arcade-java/commit/3aa593e3a04a5cb8d5d06d856fce71384550dfc1))
+* **internal:** depend on packages directly in example ([ff68350](https://github.com/ArcadeAI/arcade-java/commit/ff68350ed3a78064eee3dc46c2caccd71faf5f97))
+* **internal:** expand imports ([161104e](https://github.com/ArcadeAI/arcade-java/commit/161104ee63b0976f5d826af2e741c8f5174fe3e3))
+* **internal:** improve maven repo docs ([19dfe71](https://github.com/ArcadeAI/arcade-java/commit/19dfe71adecbf10499e215da519ad33829056e35))
+* **internal:** make `OkHttp` constructor internal ([6976ff2](https://github.com/ArcadeAI/arcade-java/commit/6976ff257c45b8eee1f6cc0ce942381aa87d6665))
+* **internal:** support uploading Maven repo artifacts to stainless package server ([1587d95](https://github.com/ArcadeAI/arcade-java/commit/1587d95ebf6354001281ddf48f90c6975d0ff42e))
+* **internal:** update `actions/checkout` version ([4e3d119](https://github.com/ArcadeAI/arcade-java/commit/4e3d1190db673cb73830d46e8f33ddd3282c081b))
+* **internal:** update `TestServerExtension` comment ([3d433ba](https://github.com/ArcadeAI/arcade-java/commit/3d433bafa9702fa980cff7ad77a6ae6d5c5406ac))
+* **internal:** update maven repo doc to include authentication ([9293d09](https://github.com/ArcadeAI/arcade-java/commit/9293d093fdfa5b73def69fa6ee378b9ed4a7c0b5))
+* **internal:** upgrade AssertJ ([83fbe85](https://github.com/ArcadeAI/arcade-java/commit/83fbe85d88fb970705ba160c9ecd78711aba0066))
+* make `Properties` more resilient to `null` ([a6e14e5](https://github.com/ArcadeAI/arcade-java/commit/a6e14e52dff5cb2d1bd22e47f62f9bc922dd9dfb))
+* test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind[#3240](https://github.com/ArcadeAI/arcade-java/issues/3240) in tests ([f7f0332](https://github.com/ArcadeAI/arcade-java/commit/f7f0332fbd4e6bb3de2f0738ca1072a2ccfed169))
+
+
+### Documentation
+
+* add comment for arbitrary value fields ([5697f14](https://github.com/ArcadeAI/arcade-java/commit/5697f14e1f875679a2c99990f3600776a58ad4b1))
+* add more examples ([ad5a7c6](https://github.com/ArcadeAI/arcade-java/commit/ad5a7c6b1a79255af06b764c2d609699b68414c9))
+
+
+### Refactors
+
+* **client:** handling of absent pagination total ([d44e78d](https://github.com/ArcadeAI/arcade-java/commit/d44e78daeaf4a3421cc39102c78920cfc6f20322))
+
 ## 0.1.0-alpha.1 (2025-12-08)
 
 Full Changelog: [v0.0.1-alpha.0...v0.1.0-alpha.1](https://github.com/ArcadeAI/arcade-java/compare/v0.0.1-alpha.0...v0.1.0-alpha.1)

CONTRIBUTING.md

@@ -0,0 +1,64 @@
+## Modifying/Adding code
+
+Most of the SDK is generated code. Modifications to code will be persisted between generations, but may
+result in merge conflicts between manual patches and changes from the generator. The generator will never
+modify the contents of the `arcade-java/lib/` and `arcade-java-examples/` directories.
+
+## Adding and running examples
+
+Set the following environment variables:
+
+| ENV Var           | Description                                                             |
+|-------------------|-------------------------------------------------------------------------|
+| `ARCADE_USER_ID`  | Arcade user Id or email address                                         |
+| `ARCADE_API_KEY`  | [Arcade API key](https://docs.arcade.dev/en/get-started/setup/api-keys) |
+| `ARCADE_BASE_URL` | Arcade URL, defaults to: `https://api.arcade.dev`                       |
+
+Use `./gradlew :arcade-java-example:run -Pexample=<Name>` to run `<Name>Example`
+
+For example, if you have the `potify.ResumePlayback` tool configured, you can run:
+```shell
+export ARCADE_API_KEY='your-api-key'
+export ARCADE_USER_ID='your-arcade-user'
+./gradlew :arcade-java-example:run -Pexample=PlaySpotify
+```
+
+## Building the repository from source
+
+If you’d like to use the repository from source, you can build and install it from git:
+
+```sh
+git clone git@github.com/ArcadeAI/arcade-java.git
+SKIP_MOCK_TESTS=true ./gradlew build publishToMavenLocal # This will skip the integration tests, see below on info on how to run them.
+```
+## Running tests
+
+Most tests require you to [run a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
+
+```sh
+# you will need npm installed
+./scripts/mock --daemon
+```
+
+The mock serer will run in the background allowing you to run tests from the command line `./gradlew test` or from your IDE.
+
+To stop the mock server run:
+```shell
+pkill -f prism
+```
+
+## Linting and formatting
+
+This repository uses [Spotless](https://github.com/diffplug/spotless/tree/main/plugin-gradle) to lint and format the code in the repository.
+
+To lint:
+
+```sh
+$ ./scripts/lint
+```
+
+To format and fix all issues automatically:
+
+```sh
+$ ./scripts/format
+```

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2025 Arcade
+Copyright 2026 Arcade
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: