@lingya-ai/agents-sdk 0.4.0 → 0.7.0

package/dist/esm/apis/ChatApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -21,10 +21,89 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { AgentGoalFromJSON, } from '../models/AgentGoal';
+import { AgentGoalHistoryFromJSON, } from '../models/AgentGoalHistory';
+import { AgentGoalRefInputToJSON, } from '../models/AgentGoalRefInput';
+import { AgentGoalViewFromJSON, } from '../models/AgentGoalView';
+import { AiChatBriefEventFromJSON, } from '../models/AiChatBriefEvent';
+import { AiChatInputToJSON, } from '../models/AiChatInput';
+import { AiChatStreamInputToJSON, } from '../models/AiChatStreamInput';
+import { AiChatSubmissionFromJSON, } from '../models/AiChatSubmission';
+import { ChatStreamProbeEventFromJSON, } from '../models/ChatStreamProbeEvent';
+import { ChatStreamProbeInputToJSON, } from '../models/ChatStreamProbeInput';
+import { EditAgentGoalInputToJSON, } from '../models/EditAgentGoalInput';
 /**
  *
  */
 export class ChatApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for clearGoal without sending the request
+     */
+    clearGoalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling clearGoal().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling clearGoal().');
+            }
+            if (requestParameters['agentGoalRefInput'] == null) {
+                throw new runtime.RequiredError('agentGoalRefInput', 'Required parameter "agentGoalRefInput" was null or undefined when calling clearGoal().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal/clear`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: AgentGoalRefInputToJSON(requestParameters['agentGoalRefInput']),
+            };
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，清除目标并保留墓碑。  ### Use case Clear the identified goal at the expected revision and preserve its tombstone.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，清除目标并保留墓碑。  ### Behavior and side effects Clear the identified goal at the expected revision and preserve its tombstone.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 清除目标 / Clear goal  ### Operation summary 清除目标 / Clear goal
+     * 清除目标 / Clear goal
+     */
+    clearGoalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.clearGoalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，清除目标并保留墓碑。  ### Use case Clear the identified goal at the expected revision and preserve its tombstone.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，清除目标并保留墓碑。  ### Behavior and side effects Clear the identified goal at the expected revision and preserve its tombstone.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 清除目标 / Clear goal  ### Operation summary 清除目标 / Clear goal
+     * 清除目标 / Clear goal
+     */
+    clearGoal(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.clearGoalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for compactConversation without sending the request
      */
@@ -41,6 +120,9 @@ export class ChatApi extends runtime.BaseAPI {
                 queryParameters['force'] = requestParameters['force'];
             }
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -68,7 +150,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 压缩会话上下文 / Compact conversation context 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上下文接近模型上限或用户要求时触发压缩。  ### Use case Trigger context compaction near the model limit or on explicit user request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步安排上下文压缩。  ### Behavior and side effects Schedules asynchronous context compaction.  ### 后续调用 轮询上下文占用或等待相关事件。  ### Next step Poll context usage or wait for related events.  ### 接口摘要 压缩会话上下文 / Compact conversation context  ### Operation summary 压缩会话上下文 / Compact conversation context
      * 压缩会话上下文 / Compact conversation context
      */
     compactConversationRaw(requestParameters, initOverrides) {
@@ -79,7 +161,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 压缩会话上下文 / Compact conversation context 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上下文接近模型上限或用户要求时触发压缩。  ### Use case Trigger context compaction near the model limit or on explicit user request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步安排上下文压缩。  ### Behavior and side effects Schedules asynchronous context compaction.  ### 后续调用 轮询上下文占用或等待相关事件。  ### Next step Poll context usage or wait for related events.  ### 接口摘要 压缩会话上下文 / Compact conversation context  ### Operation summary 压缩会话上下文 / Compact conversation context
      * 压缩会话上下文 / Compact conversation context
      */
     compactConversation(requestParameters, initOverrides) {
@@ -104,6 +186,9 @@ export class ChatApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -127,23 +212,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatInput'],
+                body: AiChatInputToJSON(requestParameters['aiChatInput']),
             };
         });
     }
     /**
-     * 向已有会话提交消息 / Submit a message to an existing conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在已有会话中提交下一轮用户消息。  ### Use case Submit the next user turn to an existing conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新消息并安排继续执行。  ### Behavior and side effects Creates a new message and schedules continued execution.  ### 后续调用 订阅该 messageId 的 SSE 或稍后补取事件。  ### Next step Subscribe to SSE for the messageId or recover its events later.  ### 接口摘要 向已有会话提交消息 / Submit a message to an existing conversation  ### Operation summary 向已有会话提交消息 / Submit a message to an existing conversation
      * 向已有会话提交消息 / Submit a message to an existing conversation
      */
     continueChatRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.continueChatRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatSubmissionFromJSON(jsonValue));
         });
     }
     /**
-     * 向已有会话提交消息 / Submit a message to an existing conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在已有会话中提交下一轮用户消息。  ### Use case Submit the next user turn to an existing conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新消息并安排继续执行。  ### Behavior and side effects Creates a new message and schedules continued execution.  ### 后续调用 订阅该 messageId 的 SSE 或稍后补取事件。  ### Next step Subscribe to SSE for the messageId or recover its events later.  ### 接口摘要 向已有会话提交消息 / Submit a message to an existing conversation  ### Operation summary 向已有会话提交消息 / Submit a message to an existing conversation
      * 向已有会话提交消息 / Submit a message to an existing conversation
      */
     continueChat(requestParameters, initOverrides) {
@@ -166,6 +251,9 @@ export class ChatApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -188,23 +276,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatInput'],
+                body: AiChatInputToJSON(requestParameters['aiChatInput']),
             };
         });
     }
     /**
-     * 创建会话并提交消息 / Create a conversation and submit a message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 创建新会话并提交第一条用户消息。  ### Use case Create a conversation and submit its first user message.  ### 前置条件 已读取配置；引用的文件已经确认上传。  ### Prerequisites Configuration has been read and referenced files are confirmed uploads.  ### 行为与副作用 创建会话和消息，并安排 Agent 执行。  ### Behavior and side effects Creates a conversation and message and schedules Agent execution.  ### 后续调用 使用返回的 conversationId 和 messageId 订阅 SSE。  ### Next step Use the returned conversationId and messageId to subscribe to SSE.  ### 接口摘要 创建会话并提交消息 / Create a conversation and submit a message  ### Operation summary 创建会话并提交消息 / Create a conversation and submit a message
      * 创建会话并提交消息 / Create a conversation and submit a message
      */
     createChatRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.createChatRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatSubmissionFromJSON(jsonValue));
         });
     }
     /**
-     * 创建会话并提交消息 / Create a conversation and submit a message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 创建新会话并提交第一条用户消息。  ### Use case Create a conversation and submit its first user message.  ### 前置条件 已读取配置；引用的文件已经确认上传。  ### Prerequisites Configuration has been read and referenced files are confirmed uploads.  ### 行为与副作用 创建会话和消息，并安排 Agent 执行。  ### Behavior and side effects Creates a conversation and message and schedules Agent execution.  ### 后续调用 使用返回的 conversationId 和 messageId 订阅 SSE。  ### Next step Use the returned conversationId and messageId to subscribe to SSE.  ### 接口摘要 创建会话并提交消息 / Create a conversation and submit a message  ### Operation summary 创建会话并提交消息 / Create a conversation and submit a message
      * 创建会话并提交消息 / Create a conversation and submit a message
      */
     createChat(requestParameters, initOverrides) {
@@ -213,6 +301,206 @@ export class ChatApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for editGoal without sending the request
+     */
+    editGoalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling editGoal().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling editGoal().');
+            }
+            if (requestParameters['editAgentGoalInput'] == null) {
+                throw new runtime.RequiredError('editAgentGoalInput', 'Required parameter "editAgentGoalInput" was null or undefined when calling editGoal().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: EditAgentGoalInputToJSON(requestParameters['editAgentGoalInput']),
+            };
+        });
+    }
+    /**
+     * ### 使用场景 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Use case Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Behavior and side effects Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 编辑目标 / Edit goal  ### Operation summary 编辑目标 / Edit goal
+     * 编辑目标 / Edit goal
+     */
+    editGoalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.editGoalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Use case Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带 goalId 和 goalRevision 更新目标正文，不改变激活状态；陈旧版本返回 409，失效目标返回 410。  ### Behavior and side effects Update the objective with goalId and goalRevision without changing activation; stale revisions return 409 and invalidated goals return 410.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 编辑目标 / Edit goal  ### Operation summary 编辑目标 / Edit goal
+     * 编辑目标 / Edit goal
+     */
+    editGoal(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.editGoalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for getGoal without sending the request
+     */
+    getGoalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling getGoal().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling getGoal().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * ### 使用场景 无当前目标时返回 goal=null。  ### Use case Return goal=null when no current goal exists.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 无当前目标时返回 goal=null。  ### Behavior and side effects Return goal=null when no current goal exists.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取当前目标 / Get current goal  ### Operation summary 读取当前目标 / Get current goal
+     * 读取当前目标 / Get current goal
+     */
+    getGoalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getGoalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalViewFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 无当前目标时返回 goal=null。  ### Use case Return goal=null when no current goal exists.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 无当前目标时返回 goal=null。  ### Behavior and side effects Return goal=null when no current goal exists.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取当前目标 / Get current goal  ### Operation summary 读取当前目标 / Get current goal
+     * 读取当前目标 / Get current goal
+     */
+    getGoal(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getGoalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for getGoalHistory without sending the request
+     */
+    getGoalHistoryRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling getGoalHistory().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling getGoalHistory().');
+            }
+            const queryParameters = {};
+            if (requestParameters['page'] != null) {
+                queryParameters['page'] = requestParameters['page'];
+            }
+            if (requestParameters['size'] != null) {
+                queryParameters['size'] = requestParameters['size'];
+            }
+            const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal/history`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * ### 使用场景 分页读取当前会话的目标历史。  ### Use case Read paged goal history for the conversation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 分页读取当前会话的目标历史。  ### Behavior and side effects Read paged goal history for the conversation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询目标历史 / Get goal history  ### Operation summary 查询目标历史 / Get goal history
+     * 查询目标历史 / Get goal history
+     */
+    getGoalHistoryRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getGoalHistoryRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalHistoryFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 分页读取当前会话的目标历史。  ### Use case Read paged goal history for the conversation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 分页读取当前会话的目标历史。  ### Behavior and side effects Read paged goal history for the conversation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询目标历史 / Get goal history  ### Operation summary 查询目标历史 / Get goal history
+     * 查询目标历史 / Get goal history
+     */
+    getGoalHistory(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getGoalHistoryRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for interruptConversation without sending the request
      */
@@ -226,6 +514,9 @@ export class ChatApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -253,7 +544,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 中断会话执行 / Interrupt conversation execution 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户主动停止正在执行的会话。  ### Use case Stop an actively executing conversation at the user\'s request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求终止当前执行；已完成输出不会回滚。  ### Behavior and side effects Requests termination of active execution; completed output is not rolled back.  ### 后续调用 查询活动状态或消息详情确认终态。  ### Next step Query activity or message detail to confirm the terminal state.  ### 接口摘要 中断会话执行 / Interrupt conversation execution  ### Operation summary 中断会话执行 / Interrupt conversation execution
      * 中断会话执行 / Interrupt conversation execution
      */
     interruptConversationRaw(requestParameters, initOverrides) {
@@ -264,7 +555,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 中断会话执行 / Interrupt conversation execution 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户主动停止正在执行的会话。  ### Use case Stop an actively executing conversation at the user\'s request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求终止当前执行；已完成输出不会回滚。  ### Behavior and side effects Requests termination of active execution; completed output is not rolled back.  ### 后续调用 查询活动状态或消息详情确认终态。  ### Next step Query activity or message detail to confirm the terminal state.  ### 接口摘要 中断会话执行 / Interrupt conversation execution  ### Operation summary 中断会话执行 / Interrupt conversation execution
      * 中断会话执行 / Interrupt conversation execution
      */
     interruptConversation(requestParameters, initOverrides) {
@@ -272,6 +563,74 @@ export class ChatApi extends runtime.BaseAPI {
             yield this.interruptConversationRaw(requestParameters, initOverrides);
         });
     }
+    /**
+     * Creates request options for pauseGoal without sending the request
+     */
+    pauseGoalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling pauseGoal().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling pauseGoal().');
+            }
+            if (requestParameters['agentGoalRefInput'] == null) {
+                throw new runtime.RequiredError('agentGoalRefInput', 'Required parameter "agentGoalRefInput" was null or undefined when calling pauseGoal().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal/pause`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: AgentGoalRefInputToJSON(requestParameters['agentGoalRefInput']),
+            };
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Use case Pause the identified goal at the expected revision and revoke automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Behavior and side effects Pause the identified goal at the expected revision and revoke automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 暂停目标 / Pause goal  ### Operation summary 暂停目标 / Pause goal
+     * 暂停目标 / Pause goal
+     */
+    pauseGoalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.pauseGoalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Use case Pause the identified goal at the expected revision and revoke automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，暂停并撤销自动续跑授权。  ### Behavior and side effects Pause the identified goal at the expected revision and revoke automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 暂停目标 / Pause goal  ### Operation summary 暂停目标 / Pause goal
+     * 暂停目标 / Pause goal
+     */
+    pauseGoal(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.pauseGoalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for probeEventStream without sending the request
      */
@@ -289,6 +648,9 @@ export class ChatApi extends runtime.BaseAPI {
             if (requestParameters['xRequestID'] != null) {
                 headerParameters['X-Request-ID'] = String(requestParameters['xRequestID']);
             }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -311,23 +673,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['chatStreamProbeInput'],
+                body: ChatStreamProbeInputToJSON(requestParameters['chatStreamProbeInput']),
             };
         });
     }
     /**
-     * 探测 SSE 连接 / Probe the SSE connection 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在接入或排障时验证网关、代理和客户端对 SSE 的支持。  ### Use case Verify SSE support across the gateway, proxy, and client during integration or diagnosis.  ### 前置条件 准备符合格式的 probeId。  ### Prerequisites Prepare a valid probeId.  ### 行为与副作用 只产生诊断事件，不创建业务会话。  ### Behavior and side effects Produces diagnostic events without creating a business conversation.  ### 后续调用 确认分片、心跳和 EOF 行为后再接入正式流。  ### Next step Confirm chunking, heartbeat, and EOF behavior before using the production stream.  ### 接口摘要 探测 SSE 连接 / Probe the SSE connection  ### Operation summary 探测 SSE 连接 / Probe the SSE connection
      * 探测 SSE 连接 / Probe the SSE connection
      */
     probeEventStreamRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.probeEventStreamRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => ChatStreamProbeEventFromJSON(jsonValue));
         });
     }
     /**
-     * 探测 SSE 连接 / Probe the SSE connection 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在接入或排障时验证网关、代理和客户端对 SSE 的支持。  ### Use case Verify SSE support across the gateway, proxy, and client during integration or diagnosis.  ### 前置条件 准备符合格式的 probeId。  ### Prerequisites Prepare a valid probeId.  ### 行为与副作用 只产生诊断事件，不创建业务会话。  ### Behavior and side effects Produces diagnostic events without creating a business conversation.  ### 后续调用 确认分片、心跳和 EOF 行为后再接入正式流。  ### Next step Confirm chunking, heartbeat, and EOF behavior before using the production stream.  ### 接口摘要 探测 SSE 连接 / Probe the SSE connection  ### Operation summary 探测 SSE 连接 / Probe the SSE connection
      * 探测 SSE 连接 / Probe the SSE connection
      */
     probeEventStream(requestParameters, initOverrides) {
@@ -336,6 +698,74 @@ export class ChatApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for resumeGoal without sending the request
+     */
+    resumeGoalRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['channelId'] == null) {
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling resumeGoal().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling resumeGoal().');
+            }
+            if (requestParameters['agentGoalRefInput'] == null) {
+                throw new runtime.RequiredError('agentGoalRefInput', 'Required parameter "agentGoalRefInput" was null or undefined when calling resumeGoal().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-AK"] = yield this.configuration.apiKey("X-OpenAPI-AK"); // OpenApiAccessKey authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Timestamp"] = yield this.configuration.apiKey("X-OpenAPI-Timestamp"); // OpenApiTimestamp authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Nonce"] = yield this.configuration.apiKey("X-OpenAPI-Nonce"); // OpenApiNonce authentication
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Signature"] = yield this.configuration.apiKey("X-OpenAPI-Signature"); // OpenApiSignature authentication
+            }
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversations/{conversationId}/goal/resume`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: AgentGoalRefInputToJSON(requestParameters['agentGoalRefInput']),
+            };
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Use case Resume the identified goal at the expected revision and authorize automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Behavior and side effects Resume the identified goal at the expected revision and authorize automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 恢复目标 / Resume goal  ### Operation summary 恢复目标 / Resume goal
+     * 恢复目标 / Resume goal
+     */
+    resumeGoalRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.resumeGoalRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentGoalFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Use case Resume the identified goal at the expected revision and authorize automatic continuation.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 携带目标标识与版本，恢复目标并重新授予自动续跑授权。  ### Behavior and side effects Resume the identified goal at the expected revision and authorize automatic continuation.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 恢复目标 / Resume goal  ### Operation summary 恢复目标 / Resume goal
+     * 恢复目标 / Resume goal
+     */
+    resumeGoal(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.resumeGoalRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for streamChatEvents without sending the request
      */
@@ -356,6 +786,9 @@ export class ChatApi extends runtime.BaseAPI {
             if (requestParameters['xRequestID'] != null) {
                 headerParameters['X-Request-ID'] = String(requestParameters['xRequestID']);
             }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -379,23 +812,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatStreamInput'],
+                body: AiChatStreamInputToJSON(requestParameters['aiChatStreamInput']),
             };
         });
     }
     /**
-     * 订阅消息事件流 / Stream message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 实时接收指定消息的思考、工具、回答和结束事件。  ### Use case Receive thought, tool, answer, and completion events for a message in real time.  ### 前置条件 消息已经创建且 messageId 与会话匹配。  ### Prerequisites The message exists and its messageId belongs to the conversation.  ### 行为与副作用 保持流式连接；断开不会取消服务端执行。  ### Behavior and side effects Keeps a streaming connection; disconnecting does not cancel server execution.  ### 后续调用 正常 EOF 后读取消息详情；异常断开时使用 Events 补取。  ### Next step After normal EOF read message detail; after an unexpected disconnect recover through Events.  ### 接口摘要 订阅消息事件流 / Stream message events  ### Operation summary 订阅消息事件流 / Stream message events
      * 订阅消息事件流 / Stream message events
      */
     streamChatEventsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.streamChatEventsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatBriefEventFromJSON(jsonValue));
         });
     }
     /**
-     * 订阅消息事件流 / Stream message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 实时接收指定消息的思考、工具、回答和结束事件。  ### Use case Receive thought, tool, answer, and completion events for a message in real time.  ### 前置条件 消息已经创建且 messageId 与会话匹配。  ### Prerequisites The message exists and its messageId belongs to the conversation.  ### 行为与副作用 保持流式连接；断开不会取消服务端执行。  ### Behavior and side effects Keeps a streaming connection; disconnecting does not cancel server execution.  ### 后续调用 正常 EOF 后读取消息详情；异常断开时使用 Events 补取。  ### Next step After normal EOF read message detail; after an unexpected disconnect recover through Events.  ### 接口摘要 订阅消息事件流 / Stream message events  ### Operation summary 订阅消息事件流 / Stream message events
      * 订阅消息事件流 / Stream message events
      */
     streamChatEvents(requestParameters, initOverrides) {