chore(release): stage the first public release candidate

Author: moonyue-w

CHANGELOG.md

@@ -2,7 +2,9 @@
 
 ## [Unreleased]
 
-## [0.1.0] - 2026-10-21
+## [0.1.0-rc.1] - 2026-10-21
+
+First public release candidate for installation and integration testing ahead of `0.1.0`.
 
 ### Changed
 

README.md

@@ -2,7 +2,7 @@
 
 Java 8 compatible client for the **Forward API**. The repository follows the resource and authentication structure of the QCA Go, Python and TypeScript SDKs, using Maven and Java builders.
 
-**Status: source available; not yet published to Maven Central.** The current version is `0.1.0`. Build from source to use the SDK until a public Maven release is available.
+**Status: source available; not yet published to Maven Central.** The current version is `0.1.0-rc.1`. Build from source to use the SDK until a public Maven release is available.
 
 The SDK provides synchronous and asynchronous clients for Models, Templates, Identities, Sessions and Threads, Memory Stores, Environments, Files, Skills, Vaults and Credentials, Schedules, Batches, Channels and Pairing, Usage, Service Account Tokens and Drive. Shared support includes PAT/SA authentication, timeouts, retries, pagination, typed errors and request IDs. Session/Thread SSE supports explicit resumption; Realtime supports text, PCM audio and History. The [API coverage](docs/forward-api-coverage.md) records the 123-operation baseline and its exclusions. Managed APIs are outside this project's scope.
 
@@ -16,7 +16,7 @@ After installing the SDK locally or publishing it to your configured Maven repos
 <dependency>
   <groupId>com.qoder.sdk</groupId>
   <artifactId>qoder-cloud-agents-sdk</artifactId>
-  <version>0.1.0</version>
+  <version>0.1.0-rc.1</version>
 </dependency>
 ```
 

docs/maintaining.md

@@ -34,10 +34,10 @@ The SDK's embedded version is filtered from `${project.version}`; do not replace
 ```sh
 python3 .github/scripts/release_notes.py check
 # After adding the actual release entry:
-python3 .github/scripts/release_notes.py extract --version 0.1.0
+python3 .github/scripts/release_notes.py extract --version 0.1.0-rc.1
 ```
 
-The current version is `0.1.0`. Acceptance records must include the resolved version, source SHA and JAR digest. Release versions must not be overwritten; a successful test of an older build is not evidence for a newer one.
+The current version is `0.1.0-rc.1`. Acceptance records must include the resolved version, source SHA and JAR digest. Release versions must not be overwritten; a successful test of an older build is not evidence for a newer one.
 
 ## Build candidates and releases
 

docs/releasing.md

@@ -1,6 +1,6 @@
 # Java SDK release setup
 
-The current version is `com.qoder.sdk:qoder-cloud-agents-sdk:0.1.0`. The manual [Release workflow](../.github/workflows/release.yml) implements publication using repository Actions secrets. Dispatching it from `main` authorizes publication after all automated checks pass; there is no separate environment approval. The Central account, namespace, signing key and repository settings below must be configured first. The GitHub repository and internal Maven access do not grant Maven Central publishing access. No public release has been made by adding this workflow.
+The current version is `com.qoder.sdk:qoder-cloud-agents-sdk:0.1.0-rc.1`. The manual [Release workflow](../.github/workflows/release.yml) implements publication using repository Actions secrets. Dispatching it from `main` authorizes publication after all automated checks pass; there is no separate environment approval. The Central account, namespace, signing key and repository settings below must be configured first. The GitHub repository and internal Maven access do not grant Maven Central publishing access. No public release has been made by adding this workflow.
 
 ## Optional GitHub protection
 
@@ -72,7 +72,7 @@ Open **Actions → Release → Run workflow**, select **main**, and verify the f
 
 | Input | First publication |
 | --- | --- |
-| `version` | The reviewed version without `v` or `SNAPSHOT`, for example `0.1.0` |
+| `version` | The reviewed version without `v` or `SNAPSHOT`, for example `0.1.0-rc.1` |
 | `commit_sha` | Full 40-character lowercase SHA of the current GitHub main |
 | `batch_id` | 1–64 letters/digits/dots/underscores/hyphens, starting with a letter or digit |
 | `resume_run_id` | Empty |

examples/pom.xml

@@ -2,11 +2,11 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
-  <groupId>com.qoder.examples</groupId><artifactId>qca-forward-examples</artifactId><version>0.1.0</version>
+  <groupId>com.qoder.examples</groupId><artifactId>qca-forward-examples</artifactId><version>0.1.0-rc.1</version>
   <properties><maven.compiler.release>8</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
   <!-- Independent consumer: deliberately no parent, reactor module, or SDK source directory. -->
   <dependencies>
-    <dependency><groupId>com.qoder.sdk</groupId><artifactId>qoder-cloud-agents-sdk</artifactId><version>0.1.0</version></dependency>
+    <dependency><groupId>com.qoder.sdk</groupId><artifactId>qoder-cloud-agents-sdk</artifactId><version>0.1.0-rc.1</version></dependency>
     <dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter</artifactId><version>5.13.4</version><scope>test</scope></dependency>
     <dependency><groupId>com.squareup.okhttp3</groupId><artifactId>mockwebserver</artifactId><version>5.5.0</version><scope>test</scope></dependency>
   </dependencies>

pom.xml

@@ -4,7 +4,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.qoder.sdk</groupId>
   <artifactId>qoder-cloud-agents-sdk</artifactId>
-  <version>0.1.0</version>
+  <version>0.1.0-rc.1</version>
   <name>Qoder Cloud Agents Java SDK</name>
   <description>Java 8 compatible Qoder Cloud Agents Forward API client.</description>
   <url>https://github.com/QoderAI/qoder-cloud-agents-sdk-java</url>