Skip to content

Commit 7a33653

Browse files
chore: configure new SDK language
1 parent 1801e21 commit 7a33653

251 files changed

Lines changed: 29525 additions & 1113 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.stats.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
configured_endpoints: 12
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-32b8e3b9f33faf15b95ab7ece843b8d2b42af9f11b7afcccb244ef4600f72b2b.yml
1+
configured_endpoints: 29
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/arcade-ai%2Farcade-engine-8446c4e394ac1eeeab4eea23ba29649287af8cf410607dc8eea7ad6ec7d39861.yml

README.md

Lines changed: 51 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Arcade Java API Library
22

3-
[![Maven Central](https://img.shields.io/maven-central/v/org.arcadeai.api/arcade-java)](https://central.sonatype.com/artifact/org.arcadeai.api/arcade-java/0.0.1-alpha.0)
3+
[![Maven Central](https://img.shields.io/maven-central/v/com.arcade_engine.api/arcade-java)](https://central.sonatype.com/artifact/com.arcade_engine.api/arcade-java/0.0.1-alpha.0)
44

55
The Arcade Java SDK provides convenient access to the Arcade REST API from applications written in Java.
66

@@ -13,14 +13,14 @@ The REST API documentation can be found on [docs.arcade.dev](https://docs.arcade
1313
### Gradle
1414

1515
```kotlin
16-
implementation("org.arcadeai.api:arcade-java:0.0.1-alpha.0")
16+
implementation("com.arcade_engine.api:arcade-java:0.0.1-alpha.0")
1717
```
1818

1919
### Maven
2020

2121
```xml
2222
<dependency>
23-
<groupId>org.arcadeai.api</groupId>
23+
<groupId>com.arcade_engine.api</groupId>
2424
<artifactId>arcade-java</artifactId>
2525
<version>0.0.1-alpha.0</version>
2626
</dependency>
@@ -33,11 +33,11 @@ This library requires Java 8 or later.
3333
## Usage
3434

3535
```java
36-
import org.arcadeai.api.client.ArcadeClient;
37-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
38-
import org.arcadeai.api.models.ExecuteToolRequest;
39-
import org.arcadeai.api.models.ExecuteToolResponse;
40-
import org.arcadeai.api.models.ToolExecuteParams;
36+
import com.arcade_engine.api.client.ArcadeClient;
37+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
38+
import com.arcade_engine.api.models.ExecuteToolRequest;
39+
import com.arcade_engine.api.models.ExecuteToolResponse;
40+
import com.arcade_engine.api.models.ToolExecuteParams;
4141

4242
// Configures using the `ARCADE_API_KEY` environment variable
4343
ArcadeClient client = ArcadeOkHttpClient.fromEnv();
@@ -55,8 +55,8 @@ ExecuteToolResponse executeToolResponse = client.tools().execute(params);
5555
Configure the client using environment variables:
5656

5757
```java
58-
import org.arcadeai.api.client.ArcadeClient;
59-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
58+
import com.arcade_engine.api.client.ArcadeClient;
59+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
6060

6161
// Configures using the `ARCADE_API_KEY` environment variable
6262
ArcadeClient client = ArcadeOkHttpClient.fromEnv();
@@ -65,8 +65,8 @@ ArcadeClient client = ArcadeOkHttpClient.fromEnv();
6565
Or manually:
6666

6767
```java
68-
import org.arcadeai.api.client.ArcadeClient;
69-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
68+
import com.arcade_engine.api.client.ArcadeClient;
69+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
7070

7171
ArcadeClient client = ArcadeOkHttpClient.builder()
7272
.apiKey("My API Key")
@@ -76,8 +76,8 @@ ArcadeClient client = ArcadeOkHttpClient.builder()
7676
Or using a combination of the two approaches:
7777

7878
```java
79-
import org.arcadeai.api.client.ArcadeClient;
80-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
79+
import com.arcade_engine.api.client.ArcadeClient;
80+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
8181

8282
ArcadeClient client = ArcadeOkHttpClient.builder()
8383
// Configures using the `ARCADE_API_KEY` environment variable
@@ -115,12 +115,12 @@ Because each class is immutable, builder modification will _never_ affect alread
115115
The default client is synchronous. To switch to asynchronous execution, call the `async()` method:
116116

117117
```java
118+
import com.arcade_engine.api.client.ArcadeClient;
119+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
120+
import com.arcade_engine.api.models.ExecuteToolRequest;
121+
import com.arcade_engine.api.models.ExecuteToolResponse;
122+
import com.arcade_engine.api.models.ToolExecuteParams;
118123
import java.util.concurrent.CompletableFuture;
119-
import org.arcadeai.api.client.ArcadeClient;
120-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
121-
import org.arcadeai.api.models.ExecuteToolRequest;
122-
import org.arcadeai.api.models.ExecuteToolResponse;
123-
import org.arcadeai.api.models.ToolExecuteParams;
124124

125125
// Configures using the `ARCADE_API_KEY` environment variable
126126
ArcadeClient client = ArcadeOkHttpClient.fromEnv();
@@ -136,12 +136,12 @@ CompletableFuture<ExecuteToolResponse> executeToolResponse = client.async().tool
136136
Or create an asynchronous client from the beginning:
137137

138138
```java
139+
import com.arcade_engine.api.client.ArcadeClientAsync;
140+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClientAsync;
141+
import com.arcade_engine.api.models.ExecuteToolRequest;
142+
import com.arcade_engine.api.models.ExecuteToolResponse;
143+
import com.arcade_engine.api.models.ToolExecuteParams;
139144
import java.util.concurrent.CompletableFuture;
140-
import org.arcadeai.api.client.ArcadeClientAsync;
141-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClientAsync;
142-
import org.arcadeai.api.models.ExecuteToolRequest;
143-
import org.arcadeai.api.models.ExecuteToolResponse;
144-
import org.arcadeai.api.models.ToolExecuteParams;
145145

146146
// Configures using the `ARCADE_API_KEY` environment variable
147147
ArcadeClientAsync client = ArcadeOkHttpClientAsync.fromEnv();
@@ -160,7 +160,7 @@ The asynchronous client supports the same options as the synchronous one, except
160160

161161
The SDK throws custom unchecked exception types:
162162

163-
- [`ArcadeServiceException`](arcade-java-core/src/main/kotlin/org/arcadeai/api/errors/ArcadeServiceException.kt): Base class for HTTP errors. See this table for which exception subclass is thrown for each HTTP status code:
163+
- [`ArcadeServiceException`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/errors/ArcadeServiceException.kt): Base class for HTTP errors. See this table for which exception subclass is thrown for each HTTP status code:
164164

165165
| Status | Exception |
166166
| ------ | ------------------------------- |
@@ -173,11 +173,11 @@ The SDK throws custom unchecked exception types:
173173
| 5xx | `InternalServerException` |
174174
| others | `UnexpectedStatusCodeException` |
175175

176-
- [`ArcadeIoException`](arcade-java-core/src/main/kotlin/org/arcadeai/api/errors/ArcadeIoException.kt): I/O networking errors.
176+
- [`ArcadeIoException`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/errors/ArcadeIoException.kt): I/O networking errors.
177177

178-
- [`ArcadeInvalidDataException`](arcade-java-core/src/main/kotlin/org/arcadeai/api/errors/ArcadeInvalidDataException.kt): Failure to interpret successfully parsed data. For example, when accessing a property that's supposed to be required, but the API unexpectedly omitted it from the response.
178+
- [`ArcadeInvalidDataException`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/errors/ArcadeInvalidDataException.kt): Failure to interpret successfully parsed data. For example, when accessing a property that's supposed to be required, but the API unexpectedly omitted it from the response.
179179

180-
- [`ArcadeException`](arcade-java-core/src/main/kotlin/org/arcadeai/api/errors/ArcadeException.kt): Base class for all exceptions. Most errors will result in one of the previously mentioned ones, but completely generic errors may be thrown using the base class.
180+
- [`ArcadeException`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/errors/ArcadeException.kt): Base class for all exceptions. Most errors will result in one of the previously mentioned ones, but completely generic errors may be thrown using the base class.
181181

182182
## Logging
183183

@@ -214,8 +214,8 @@ The API may also explicitly instruct the SDK to retry or not retry a response.
214214
To set a custom number of retries, configure the client using the `maxRetries` method:
215215

216216
```java
217-
import org.arcadeai.api.client.ArcadeClient;
218-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
217+
import com.arcade_engine.api.client.ArcadeClient;
218+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
219219

220220
ArcadeClient client = ArcadeOkHttpClient.builder()
221221
.fromEnv()
@@ -230,9 +230,9 @@ Requests time out after 1 minute by default.
230230
To set a custom timeout, configure the method call using the `timeout` method:
231231

232232
```java
233-
import org.arcadeai.api.models.ExecuteToolRequest;
234-
import org.arcadeai.api.models.ExecuteToolResponse;
235-
import org.arcadeai.api.models.ToolExecuteParams;
233+
import com.arcade_engine.api.models.ExecuteToolRequest;
234+
import com.arcade_engine.api.models.ExecuteToolResponse;
235+
import com.arcade_engine.api.models.ToolExecuteParams;
236236

237237
ExecuteToolResponse executeToolResponse = client.tools().execute(
238238
params, RequestOptions.builder().timeout(Duration.ofSeconds(30)).build()
@@ -242,9 +242,9 @@ ExecuteToolResponse executeToolResponse = client.tools().execute(
242242
Or configure the default for all method calls at the client level:
243243

244244
```java
245+
import com.arcade_engine.api.client.ArcadeClient;
246+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
245247
import java.time.Duration;
246-
import org.arcadeai.api.client.ArcadeClient;
247-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
248248

249249
ArcadeClient client = ArcadeOkHttpClient.builder()
250250
.fromEnv()
@@ -257,10 +257,10 @@ ArcadeClient client = ArcadeOkHttpClient.builder()
257257
To route requests through a proxy, configure the client using the `proxy` method:
258258

259259
```java
260+
import com.arcade_engine.api.client.ArcadeClient;
261+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
260262
import java.net.InetSocketAddress;
261263
import java.net.Proxy;
262-
import org.arcadeai.api.client.ArcadeClient;
263-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
264264

265265
ArcadeClient client = ArcadeOkHttpClient.builder()
266266
.fromEnv()
@@ -281,8 +281,8 @@ The SDK is typed for convenient usage of the documented API. However, it also su
281281
To set undocumented parameters, call the `putAdditionalHeader`, `putAdditionalQueryParam`, or `putAdditionalBodyProperty` methods on any `Params` class:
282282

283283
```java
284-
import org.arcadeai.api.core.JsonValue;
285-
import org.arcadeai.api.models.ToolExecuteParams;
284+
import com.arcade_engine.api.core.JsonValue;
285+
import com.arcade_engine.api.models.ToolExecuteParams;
286286

287287
ToolExecuteParams params = ToolExecuteParams.builder()
288288
.putAdditionalHeader("Secret-Header", "42")
@@ -293,11 +293,11 @@ ToolExecuteParams params = ToolExecuteParams.builder()
293293

294294
These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods. You can also set undocumented parameters on nested headers, query params, or body classes using the `putAdditionalProperty` method. These properties can be accessed on the built object later using the `_additionalProperties()` method.
295295

296-
To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](arcade-java-core/src/main/kotlin/org/arcadeai/api/core/JsonValue.kt) object to its setter:
296+
To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/core/JsonValue.kt) object to its setter:
297297

298298
```java
299-
import org.arcadeai.api.models.ExecuteToolRequest;
300-
import org.arcadeai.api.models.ToolExecuteParams;
299+
import com.arcade_engine.api.models.ExecuteToolRequest;
300+
import com.arcade_engine.api.models.ToolExecuteParams;
301301

302302
ToolExecuteParams params = ToolExecuteParams.builder()
303303
.executeToolRequest(ExecuteToolRequest.builder()
@@ -311,8 +311,8 @@ ToolExecuteParams params = ToolExecuteParams.builder()
311311
To access undocumented response properties, call the `_additionalProperties()` method:
312312

313313
```java
314+
import com.arcade_engine.api.core.JsonValue;
314315
import java.util.Map;
315-
import org.arcadeai.api.core.JsonValue;
316316

317317
Map<String, JsonValue> additionalProperties = client.tools().execute(params)._additionalProperties();
318318
JsonValue secretPropertyValue = additionalProperties.get("secretProperty");
@@ -341,8 +341,8 @@ String result = secretPropertyValue.accept(new JsonValue.Visitor<>() {
341341
To access a property's raw JSON value, which may be undocumented, call its `_` prefixed method:
342342

343343
```java
344+
import com.arcade_engine.api.core.JsonField;
344345
import java.util.Optional;
345-
import org.arcadeai.api.core.JsonField;
346346

347347
JsonField<Object> field = client.tools().execute(params)._field();
348348

@@ -364,22 +364,22 @@ if (field.isMissing()) {
364364

365365
In rare cases, the API may return a response that doesn't match the expected type. For example, the SDK may expect a property to contain a `String`, but the API could return something else.
366366

367-
By default, the SDK will not throw an exception in this case. It will throw [`ArcadeInvalidDataException`](arcade-java-core/src/main/kotlin/org/arcadeai/api/errors/ArcadeInvalidDataException.kt) only if you directly access the property.
367+
By default, the SDK will not throw an exception in this case. It will throw [`ArcadeInvalidDataException`](arcade-java-core/src/main/kotlin/com/arcade_engine/api/errors/ArcadeInvalidDataException.kt) only if you directly access the property.
368368

369369
If you would prefer to check that the response is completely well-typed upfront, then either call `validate()`:
370370

371371
```java
372-
import org.arcadeai.api.models.ExecuteToolResponse;
372+
import com.arcade_engine.api.models.ExecuteToolResponse;
373373

374374
ExecuteToolResponse executeToolResponse = client.tools().execute(params).validate();
375375
```
376376

377377
Or configure the method call to validate the response using the `responseValidation` method:
378378

379379
```java
380-
import org.arcadeai.api.models.ExecuteToolRequest;
381-
import org.arcadeai.api.models.ExecuteToolResponse;
382-
import org.arcadeai.api.models.ToolExecuteParams;
380+
import com.arcade_engine.api.models.ExecuteToolRequest;
381+
import com.arcade_engine.api.models.ExecuteToolResponse;
382+
import com.arcade_engine.api.models.ToolExecuteParams;
383383

384384
ExecuteToolResponse executeToolResponse = client.tools().execute(
385385
params, RequestOptions.builder().responseValidation(true).build()
@@ -389,8 +389,8 @@ ExecuteToolResponse executeToolResponse = client.tools().execute(
389389
Or configure the default for all method calls at the client level:
390390

391391
```java
392-
import org.arcadeai.api.client.ArcadeClient;
393-
import org.arcadeai.api.client.okhttp.ArcadeOkHttpClient;
392+
import com.arcade_engine.api.client.ArcadeClient;
393+
import com.arcade_engine.api.client.okhttp.ArcadeOkHttpClient;
394394

395395
ArcadeClient client = ArcadeOkHttpClient.builder()
396396
.fromEnv()

arcade-java-client-okhttp/src/main/kotlin/org/arcadeai/api/client/okhttp/ArcadeOkHttpClient.kt renamed to arcade-java-client-okhttp/src/main/kotlin/com/arcade_engine/api/client/okhttp/ArcadeOkHttpClient.kt

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
// File generated from our OpenAPI spec by Stainless.
22

3-
package org.arcadeai.api.client.okhttp
3+
package com.arcade_engine.api.client.okhttp
44

5+
import com.arcade_engine.api.client.ArcadeClient
6+
import com.arcade_engine.api.client.ArcadeClientImpl
7+
import com.arcade_engine.api.core.ClientOptions
8+
import com.arcade_engine.api.core.http.Headers
9+
import com.arcade_engine.api.core.http.QueryParams
510
import com.fasterxml.jackson.databind.json.JsonMapper
611
import java.net.Proxy
712
import java.time.Clock
813
import java.time.Duration
9-
import org.arcadeai.api.client.ArcadeClient
10-
import org.arcadeai.api.client.ArcadeClientImpl
11-
import org.arcadeai.api.core.ClientOptions
12-
import org.arcadeai.api.core.http.Headers
13-
import org.arcadeai.api.core.http.QueryParams
1414

1515
class ArcadeOkHttpClient private constructor() {
1616

arcade-java-client-okhttp/src/main/kotlin/org/arcadeai/api/client/okhttp/ArcadeOkHttpClientAsync.kt renamed to arcade-java-client-okhttp/src/main/kotlin/com/arcade_engine/api/client/okhttp/ArcadeOkHttpClientAsync.kt

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
// File generated from our OpenAPI spec by Stainless.
22

3-
package org.arcadeai.api.client.okhttp
3+
package com.arcade_engine.api.client.okhttp
44

5+
import com.arcade_engine.api.client.ArcadeClientAsync
6+
import com.arcade_engine.api.client.ArcadeClientAsyncImpl
7+
import com.arcade_engine.api.core.ClientOptions
8+
import com.arcade_engine.api.core.http.Headers
9+
import com.arcade_engine.api.core.http.QueryParams
510
import com.fasterxml.jackson.databind.json.JsonMapper
611
import java.net.Proxy
712
import java.time.Clock
813
import java.time.Duration
9-
import org.arcadeai.api.client.ArcadeClientAsync
10-
import org.arcadeai.api.client.ArcadeClientAsyncImpl
11-
import org.arcadeai.api.core.ClientOptions
12-
import org.arcadeai.api.core.http.Headers
13-
import org.arcadeai.api.core.http.QueryParams
1414

1515
class ArcadeOkHttpClientAsync private constructor() {
1616

arcade-java-client-okhttp/src/main/kotlin/org/arcadeai/api/client/okhttp/OkHttpClient.kt renamed to arcade-java-client-okhttp/src/main/kotlin/com/arcade_engine/api/client/okhttp/OkHttpClient.kt

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,14 @@
1-
package org.arcadeai.api.client.okhttp
2-
1+
package com.arcade_engine.api.client.okhttp
2+
3+
import com.arcade_engine.api.core.RequestOptions
4+
import com.arcade_engine.api.core.checkRequired
5+
import com.arcade_engine.api.core.http.Headers
6+
import com.arcade_engine.api.core.http.HttpClient
7+
import com.arcade_engine.api.core.http.HttpMethod
8+
import com.arcade_engine.api.core.http.HttpRequest
9+
import com.arcade_engine.api.core.http.HttpRequestBody
10+
import com.arcade_engine.api.core.http.HttpResponse
11+
import com.arcade_engine.api.errors.ArcadeIoException
312
import java.io.IOException
413
import java.io.InputStream
514
import java.net.Proxy
@@ -17,15 +26,6 @@ import okhttp3.RequestBody.Companion.toRequestBody
1726
import okhttp3.Response
1827
import okhttp3.logging.HttpLoggingInterceptor
1928
import okio.BufferedSink
20-
import org.arcadeai.api.core.RequestOptions
21-
import org.arcadeai.api.core.checkRequired
22-
import org.arcadeai.api.core.http.Headers
23-
import org.arcadeai.api.core.http.HttpClient
24-
import org.arcadeai.api.core.http.HttpMethod
25-
import org.arcadeai.api.core.http.HttpRequest
26-
import org.arcadeai.api.core.http.HttpRequestBody
27-
import org.arcadeai.api.core.http.HttpResponse
28-
import org.arcadeai.api.errors.ArcadeIoException
2929

3030
class OkHttpClient
3131
private constructor(private val okHttpClient: okhttp3.OkHttpClient, private val baseUrl: HttpUrl) :

arcade-java-core/src/main/kotlin/org/arcadeai/api/client/ArcadeClient.kt renamed to arcade-java-core/src/main/kotlin/com/arcade_engine/api/client/ArcadeClient.kt

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
// File generated from our OpenAPI spec by Stainless.
22

3-
package org.arcadeai.api.client
3+
package com.arcade_engine.api.client
44

5-
import org.arcadeai.api.services.blocking.AuthService
6-
import org.arcadeai.api.services.blocking.ChatService
7-
import org.arcadeai.api.services.blocking.HealthService
8-
import org.arcadeai.api.services.blocking.ToolService
5+
import com.arcade_engine.api.services.blocking.AdminService
6+
import com.arcade_engine.api.services.blocking.AuthService
7+
import com.arcade_engine.api.services.blocking.ChatService
8+
import com.arcade_engine.api.services.blocking.HealthService
9+
import com.arcade_engine.api.services.blocking.ToolService
10+
import com.arcade_engine.api.services.blocking.WorkerService
911

1012
/**
1113
* A client for interacting with the Arcade REST API synchronously. You can also switch to
@@ -31,6 +33,8 @@ interface ArcadeClient {
3133
*/
3234
fun async(): ArcadeClientAsync
3335

36+
fun admin(): AdminService
37+
3438
fun auth(): AuthService
3539

3640
fun health(): HealthService
@@ -39,6 +43,8 @@ interface ArcadeClient {
3943

4044
fun tools(): ToolService
4145

46+
fun workers(): WorkerService
47+
4248
/**
4349
* Closes this client, relinquishing any underlying resources.
4450
*

0 commit comments

Comments
 (0)