From a44f9874dbdc91f40c1ca03116d1312b6db7045f Mon Sep 17 00:00:00 2001
From: moonyue-w <300878504+moonyue-w@users.noreply.github.com>
Date: Tue, 13 Oct 2026 21:17:54 +0800
Subject: [PATCH] chore(release): prepare 0.5.0 for Forward SAT and Realtime

---
 CHANGELOG.md                        | 4 +++-
 CONTRIBUTING.md                     | 2 +-
 docs/api/index/variables/VERSION.md | 2 +-
 package-lock.json                   | 4 ++--
 package.json                        | 2 +-
 src/version.ts                      | 2 +-
 6 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d1406a1..4784cc9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,11 +5,13 @@ existing `0.1.0` release; earlier development prereleases are not listed.
 
 ## [Unreleased]
 
+## [0.5.0]
+
 ### Added
 
 - Forward admin and Identity SAT issuance and Forward SAT revocation, using explicit per-call SA Key authentication, typed issuance/revocation metadata, and no automatic retries. Existing platform credentials and PAT/SAT business authentication remain unchanged.
-
 - Forward Realtime Beta Conversation creation with required idempotency keys, independently paginated History, and Node-only authenticated WebSocket connections supporting text, PCM16, work events, playback receipts, interruption and acknowledged graceful close. Connections preserve pre-ready and unknown events, bound queues, support cancellation and separate deadlines, and never automatically reconnect or replay input.
+- Realtime SA access requires a Forward-issued bound SAT and a Realtime-enabled Template; a platform SAT from `ServiceAccountCredential` alone does not establish the required Forward binding.
 
 ## [0.4.0] - 2026-10-12
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 33709f4..5a8777b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -128,7 +128,7 @@ Do not dispatch the workflow until all settings are active.
 
    ```bash
    gh workflow run release.yml --ref main \
-     -f version=0.4.0 \
+     -f version=0.5.0 \
      -f commit_sha=<40-character-main-sha> \
      -f batch_id=<safe-audit-token>
    ```
diff --git a/docs/api/index/variables/VERSION.md b/docs/api/index/variables/VERSION.md
index e673983..42af0c1 100644
--- a/docs/api/index/variables/VERSION.md
+++ b/docs/api/index/variables/VERSION.md
@@ -6,4 +6,4 @@
 
 # Variable: VERSION
 
-> `const` **VERSION**: `"0.4.0"` = `'0.4.0'`
+> `const` **VERSION**: `"0.5.0"` = `'0.5.0'`
diff --git a/package-lock.json b/package-lock.json
index 39333d4..1ce09a0 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "qca-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "qca-sdk",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "license": "MIT",
       "dependencies": {
         "ws": "^8.22.0"
diff --git a/package.json b/package.json
index 1f1eb1b..1ad698e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "qca-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "TypeScript SDK for Qoder Cloud Agents Forward and Managed APIs",
   "author": "Qoder",
   "license": "MIT",
diff --git a/src/version.ts b/src/version.ts
index fc8c658..19950fb 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -3,4 +3,4 @@
 // describe a version that was never published; `npm run build` compares the two.
 // Declared here rather than imported from package.json so bundlers do not have to
 // resolve JSON from outside src/.
-export const VERSION = '0.4.0';
+export const VERSION = '0.5.0';