docs(forward): clarify Decision API beta status

Author: moonyue-w

CHANGELOG.md

@@ -5,6 +5,10 @@ existing `0.1.0` release; earlier development prereleases are not listed.
 
 ## [Unreleased]
 
+### Changed
+
+- Clarify that the Forward Decision API is in Beta and its behavior may change in future updates.
+
 ## [0.10.0]
 
 ### Added

README.md

@@ -609,7 +609,9 @@ credential = client.vaults.credentials.retrieve("credential-id", vault_id="vault
 memory = client.memory_stores.memories.retrieve("memory-id", memory_store_id="store-id")
 ```
 
-## Forward Decisions
+## Forward Decisions (Beta)
+
+The Decision API is in Beta. Its behavior may change in future updates.
 
 Evaluate a nonempty `state` object or an accessible `session_id` (exactly one)
 with 1–32 choice or score questions. Choice values are strings or booleans;

docs/api/reference.md

@@ -3389,6 +3389,8 @@ class Decisions(SyncAPIResource)
 
 [[view_source]](https://github.com/QoderAI/qoder-cloud-agents-sdk-python/blob/main/src/qca/forward/resources/decisions.py)
 
+The Decision API is in Beta. Its behavior may change in future updates.
+
 <a id="qca.forward.resources.decisions.Decisions.create"></a>
 
 #### create
@@ -3475,6 +3477,8 @@ class AsyncDecisions(AsyncAPIResource)
 
 [[view_source]](https://github.com/QoderAI/qoder-cloud-agents-sdk-python/blob/main/src/qca/forward/resources/decisions.py)
 
+The Decision API is in Beta. Its behavior may change in future updates.
+
 <a id="qca.forward.resources.decisions.AsyncDecisions.create"></a>
 
 #### create

examples/forward/decisions.py

@@ -1,5 +1,7 @@
 """Create a Decision using shared PAT/SA configuration.
 
+The Decision API is in Beta. Its behavior may change in future updates.
+
 Run: python -m examples.forward.decisions --env .env.live
 Optionally set QODER_DECISION_SESSION_ID to evaluate an accessible Session.
 """

src/qca/forward/resources/decisions.py

@@ -15,6 +15,8 @@
 
 
 class Decisions(SyncAPIResource):
+    """The Decision API is in Beta. Its behavior may change in future updates."""
+
     def create(
         self,
         *,
@@ -105,6 +107,8 @@ def list(
 
 
 class AsyncDecisions(AsyncAPIResource):
+    """The Decision API is in Beta. Its behavior may change in future updates."""
+
     async def create(
         self,
         *,