docs: note that clientId is currently ignored but recommended for forward compatibility

huntcsg · huntcsg · commit a30c06366b8a · 2026-01-06T13:00:21.000-05:00
diff --git a/development/cloud/api-reference.mdx b/development/cloud/api-reference.mdx
@@ -530,6 +530,10 @@ print("Job completed!")
 
 Connect to the WebSocket for real-time execution updates.
 
+<Note>
+  The `clientId` parameter is currently ignored—all connections for a user receive the same messages. Pass a unique `clientId` for forward compatibility.
+</Note>
+
 <CodeGroup>
 ```typescript TypeScript
 async function listenForCompletion(
diff --git a/zh-CN/development/cloud/api-reference.mdx b/zh-CN/development/cloud/api-reference.mdx
@@ -530,6 +530,10 @@ print("Job completed!")
 
 连接 WebSocket 以获取实时执行更新。
 
+<Note>
+  `clientId` 参数目前会被忽略——同一用户的所有连接都会收到相同的消息。为了向前兼容，仍建议传递唯一的 `clientId`。
+</Note>
+
 <CodeGroup>
 ```typescript TypeScript
 async function listenForCompletion(
