@lingya-ai/agents-sdk 0.4.0 → 0.7.0

package/dist/apis/ConversationsApi.js

@@ -3,9 +3,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).
@@ -22,29 +22,47 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListConversationsOrderNullHandlingEnum = exports.ListConversationsOrderDirectionEnum = exports.ConversationsApi = void 0;
+exports.ListConversationsGroupFilterEnum = exports.ListConversationsStatusEnum = exports.ConversationsApi = void 0;
 const runtime = require("../runtime");
+const ConversationActivityBatchInput_1 = require("../models/ConversationActivityBatchInput");
+const ConversationActivityList_1 = require("../models/ConversationActivityList");
+const ConversationContextUsage_1 = require("../models/ConversationContextUsage");
+const ConversationGroup_1 = require("../models/ConversationGroup");
+const ConversationGroupDeleted_1 = require("../models/ConversationGroupDeleted");
+const ConversationGroupList_1 = require("../models/ConversationGroupList");
+const ConversationGroupNameInput_1 = require("../models/ConversationGroupNameInput");
+const ConversationIds_1 = require("../models/ConversationIds");
+const ConversationMetadata_1 = require("../models/ConversationMetadata");
+const ConversationReadReceipt_1 = require("../models/ConversationReadReceipt");
+const ConversationReadReceiptInput_1 = require("../models/ConversationReadReceiptInput");
+const ConversationStats_1 = require("../models/ConversationStats");
+const ConversationStatusInput_1 = require("../models/ConversationStatusInput");
+const ConversationSummary_1 = require("../models/ConversationSummary");
+const ConversationSummaryList_1 = require("../models/ConversationSummaryList");
+const ConversationTitle_1 = require("../models/ConversationTitle");
+const ConversationTitleInput_1 = require("../models/ConversationTitleInput");
+const UpdateConversationGroupInput_1 = require("../models/UpdateConversationGroupInput");
 /**
  *
  */
 class ConversationsApi extends runtime.BaseAPI {
     /**
-     * Creates request options for createConversationShare without sending the request
+     * Creates request options for createConversationGroup without sending the request
      */
-    createConversationShareRequestOpts(requestParameters) {
+    createConversationGroupRequestOpts(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 createConversationShare().');
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling createConversationGroup().');
             }
-            if (requestParameters['conversationId'] == null) {
-                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling createConversationShare().');
-            }
-            if (requestParameters['conversationShareInput'] == null) {
-                throw new runtime.RequiredError('conversationShareInput', 'Required parameter "conversationShareInput" was null or undefined when calling createConversationShare().');
+            if (requestParameters['conversationGroupNameInput'] == null) {
+                throw new runtime.RequiredError('conversationGroupNameInput', 'Required parameter "conversationGroupNameInput" was null or undefined when calling createConversationGroup().');
             }
             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
             }
@@ -60,36 +78,35 @@ class ConversationsApi extends runtime.BaseAPI {
             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}/shares`;
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversation-groups`;
             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: requestParameters['conversationShareInput'],
+                body: (0, ConversationGroupNameInput_1.ConversationGroupNameInputToJSON)(requestParameters['conversationGroupNameInput']),
             };
         });
     }
     /**
-     * 创建会话分享 / Create a conversation share 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 创建会话分享 / Create a conversation share
+     * ### 使用场景 去除名称首尾空白后创建分组，名称最多 60 字符。  ### Use case Create a group after trimming the name; names are limited to 60 characters.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 去除名称首尾空白后创建分组，名称最多 60 字符。  ### Behavior and side effects Create a group after trimming the name; names are limited to 60 characters.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 创建会话分组 / Create conversation group  ### Operation summary 创建会话分组 / Create conversation group
+     * 创建会话分组 / Create conversation group
      */
-    createConversationShareRaw(requestParameters, initOverrides) {
+    createConversationGroupRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.createConversationShareRequestOpts(requestParameters);
+            const requestOptions = yield this.createConversationGroupRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationGroup_1.ConversationGroupFromJSON)(jsonValue));
         });
     }
     /**
-     * 创建会话分享 / Create a conversation share 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 创建会话分享 / Create a conversation share
+     * ### 使用场景 去除名称首尾空白后创建分组，名称最多 60 字符。  ### Use case Create a group after trimming the name; names are limited to 60 characters.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 去除名称首尾空白后创建分组，名称最多 60 字符。  ### Behavior and side effects Create a group after trimming the name; names are limited to 60 characters.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 创建会话分组 / Create conversation group  ### Operation summary 创建会话分组 / Create conversation group
+     * 创建会话分组 / Create conversation group
      */
-    createConversationShare(requestParameters, initOverrides) {
+    createConversationGroup(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.createConversationShareRaw(requestParameters, initOverrides);
+            const response = yield this.createConversationGroupRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -106,6 +123,9 @@ class ConversationsApi 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
             }
@@ -133,7 +153,7 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 删除会话 / Delete a conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 永久移除用户不再需要的会话。  ### Use case Permanently remove a conversation the user no longer needs.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 删除会话及其可见关联数据。  ### Behavior and side effects Deletes the conversation and its visible related data.  ### 后续调用 从本地列表和缓存中移除该会话。  ### Next step Remove the conversation from local lists and caches.  ### 接口摘要 删除会话 / Delete a conversation  ### Operation summary 删除会话 / Delete a conversation
      * 删除会话 / Delete a conversation
      */
     deleteConversationRaw(requestParameters, initOverrides) {
@@ -144,7 +164,7 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 删除会话 / Delete a conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 永久移除用户不再需要的会话。  ### Use case Permanently remove a conversation the user no longer needs.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 删除会话及其可见关联数据。  ### Behavior and side effects Deletes the conversation and its visible related data.  ### 后续调用 从本地列表和缓存中移除该会话。  ### Next step Remove the conversation from local lists and caches.  ### 接口摘要 删除会话 / Delete a conversation  ### Operation summary 删除会话 / Delete a conversation
      * 删除会话 / Delete a conversation
      */
     deleteConversation(requestParameters, initOverrides) {
@@ -152,6 +172,69 @@ class ConversationsApi extends runtime.BaseAPI {
             yield this.deleteConversationRaw(requestParameters, initOverrides);
         });
     }
+    /**
+     * Creates request options for deleteConversationGroup without sending the request
+     */
+    deleteConversationGroupRequestOpts(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 deleteConversationGroup().');
+            }
+            if (requestParameters['groupId'] == null) {
+                throw new runtime.RequiredError('groupId', 'Required parameter "groupId" was null or undefined when calling deleteConversationGroup().');
+            }
+            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/conversation-groups/{groupId}`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            urlPath = urlPath.replace('{groupId}', encodeURIComponent(String(requestParameters['groupId'])));
+            return {
+                path: urlPath,
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * ### 使用场景 删除分组并将会话移回未分组，返回移动数量。  ### Use case Delete the group and move its conversations to ungrouped; return the moved count.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 删除分组并将会话移回未分组，返回移动数量。  ### Behavior and side effects Delete the group and move its conversations to ungrouped; return the moved count.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 删除会话分组 / Delete conversation group  ### Operation summary 删除会话分组 / Delete conversation group
+     * 删除会话分组 / Delete conversation group
+     */
+    deleteConversationGroupRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteConversationGroupRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationGroupDeleted_1.ConversationGroupDeletedFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 删除分组并将会话移回未分组，返回移动数量。  ### Use case Delete the group and move its conversations to ungrouped; return the moved count.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 删除分组并将会话移回未分组，返回移动数量。  ### Behavior and side effects Delete the group and move its conversations to ungrouped; return the moved count.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 删除会话分组 / Delete conversation group  ### Operation summary 删除会话分组 / Delete conversation group
+     * 删除会话分组 / Delete conversation group
+     */
+    deleteConversationGroup(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.deleteConversationGroupRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getConversationContextUsage without sending the request
      */
@@ -165,6 +248,9 @@ class ConversationsApi 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
             }
@@ -192,18 +278,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取上下文占用 / Get context usage 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 决定是否需要压缩上下文或提示容量时读取占用。  ### Use case Read context usage to decide whether to compact or warn about capacity.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 达到阈值时调用 compactConversation。  ### Next step Call compactConversation when the threshold is reached.  ### 接口摘要 读取上下文占用 / Get context usage  ### Operation summary 读取上下文占用 / Get context usage
      * 读取上下文占用 / Get context usage
      */
     getConversationContextUsageRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getConversationContextUsageRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationContextUsage_1.ConversationContextUsageFromJSON)(jsonValue));
         });
     }
     /**
-     * 读取上下文占用 / Get context usage 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 决定是否需要压缩上下文或提示容量时读取占用。  ### Use case Read context usage to decide whether to compact or warn about capacity.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 达到阈值时调用 compactConversation。  ### Next step Call compactConversation when the threshold is reached.  ### 接口摘要 读取上下文占用 / Get context usage  ### Operation summary 读取上下文占用 / Get context usage
      * 读取上下文占用 / Get context usage
      */
     getConversationContextUsage(requestParameters, initOverrides) {
@@ -222,6 +308,9 @@ class ConversationsApi 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
             }
@@ -248,18 +337,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取会话统计 / Get conversation statistics 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 展示当前用户在渠道中的会话聚合统计。  ### Use case Display aggregate conversation statistics for the current user in the channel.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 用于仪表盘展示，不作为逐会话状态来源。  ### Next step Use for dashboards, not as per-conversation state.  ### 接口摘要 读取会话统计 / Get conversation statistics  ### Operation summary 读取会话统计 / Get conversation statistics
      * 读取会话统计 / Get conversation statistics
      */
     getConversationStatsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getConversationStatsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationStats_1.ConversationStatsFromJSON)(jsonValue));
         });
     }
     /**
-     * 读取会话统计 / Get conversation statistics 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 展示当前用户在渠道中的会话聚合统计。  ### Use case Display aggregate conversation statistics for the current user in the channel.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 用于仪表盘展示，不作为逐会话状态来源。  ### Next step Use for dashboards, not as per-conversation state.  ### 接口摘要 读取会话统计 / Get conversation statistics  ### Operation summary 读取会话统计 / Get conversation statistics
      * 读取会话统计 / Get conversation statistics
      */
     getConversationStats(requestParameters, initOverrides) {
@@ -268,6 +357,69 @@ class ConversationsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getConversationSummary without sending the request
+     */
+    getConversationSummaryRequestOpts(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 getConversationSummary().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling getConversationSummary().');
+            }
+            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}`;
+            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 Restore the current user\'s conversation summary by ID.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 按会话标识恢复当前用户的会话摘要。  ### Behavior and side effects Restore the current user\'s conversation summary by ID.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取会话摘要 / Get conversation summary  ### Operation summary 读取会话摘要 / Get conversation summary
+     * 读取会话摘要 / Get conversation summary
+     */
+    getConversationSummaryRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getConversationSummaryRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationSummary_1.ConversationSummaryFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 按会话标识恢复当前用户的会话摘要。  ### Use case Restore the current user\'s conversation summary by ID.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 按会话标识恢复当前用户的会话摘要。  ### Behavior and side effects Restore the current user\'s conversation summary by ID.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 读取会话摘要 / Get conversation summary  ### Operation summary 读取会话摘要 / Get conversation summary
+     * 读取会话摘要 / Get conversation summary
+     */
+    getConversationSummary(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getConversationSummaryRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getConversationTitle without sending the request
      */
@@ -281,6 +433,9 @@ class ConversationsApi 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
             }
@@ -308,18 +463,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取会话标题 / Get conversation title 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 读取自动生成或用户设置的会话标题。  ### Use case Read the generated or user-defined conversation title.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 生成中时稍后重试，或允许用户更新标题。  ### Next step Retry while generation is pending or let the user update the title.  ### 接口摘要 读取会话标题 / Get conversation title  ### Operation summary 读取会话标题 / Get conversation title
      * 读取会话标题 / Get conversation title
      */
     getConversationTitleRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getConversationTitleRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationTitle_1.ConversationTitleFromJSON)(jsonValue));
         });
     }
     /**
-     * 读取会话标题 / Get conversation title 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 读取自动生成或用户设置的会话标题。  ### Use case Read the generated or user-defined conversation title.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 生成中时稍后重试，或允许用户更新标题。  ### Next step Retry while generation is pending or let the user update the title.  ### 接口摘要 读取会话标题 / Get conversation title  ### Operation summary 读取会话标题 / Get conversation title
      * 读取会话标题 / Get conversation title
      */
     getConversationTitle(requestParameters, initOverrides) {
@@ -338,6 +493,9 @@ class ConversationsApi 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
             }
@@ -364,18 +522,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 查询活动会话 / List active conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 快速恢复当前仍在执行的会话。  ### Use case Quickly recover conversations that are still executing.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回会话 ID。  ### Behavior and side effects Read-only and returns conversation IDs.  ### 后续调用 批量查询活动详情或重新连接 SSE。  ### Next step Batch-query activity details or reconnect SSE.  ### 接口摘要 查询活动会话 / List active conversations  ### Operation summary 查询活动会话 / List active conversations
      * 查询活动会话 / List active conversations
      */
     listActiveConversationsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.listActiveConversationsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationIds_1.ConversationIdsFromJSON)(jsonValue));
         });
     }
     /**
-     * 查询活动会话 / List active conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 快速恢复当前仍在执行的会话。  ### Use case Quickly recover conversations that are still executing.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回会话 ID。  ### Behavior and side effects Read-only and returns conversation IDs.  ### 后续调用 批量查询活动详情或重新连接 SSE。  ### Next step Batch-query activity details or reconnect SSE.  ### 接口摘要 查询活动会话 / List active conversations  ### Operation summary 查询活动会话 / List active conversations
      * 查询活动会话 / List active conversations
      */
     listActiveConversations(requestParameters, initOverrides) {
@@ -385,18 +543,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates request options for listConversationShares without sending the request
+     * Creates request options for listConversationGroups without sending the request
      */
-    listConversationSharesRequestOpts(requestParameters) {
+    listConversationGroupsRequestOpts(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 listConversationShares().');
-            }
-            if (requestParameters['conversationId'] == null) {
-                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling listConversationShares().');
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling listConversationGroups().');
             }
             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
             }
@@ -412,9 +570,8 @@ class ConversationsApi extends runtime.BaseAPI {
             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}/shares`;
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversation-groups`;
             urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
-            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
             return {
                 path: urlPath,
                 method: 'GET',
@@ -424,23 +581,23 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 查询会话分享 / List conversation shares 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 查询会话分享 / List conversation shares
+     * ### 使用场景 一次读取当前用户作用域下的完整分组目录。  ### Use case Read the complete group directory for the current user.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 一次读取当前用户作用域下的完整分组目录。  ### Behavior and side effects Read the complete group directory for the current user.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询会话分组 / List conversation groups  ### Operation summary 查询会话分组 / List conversation groups
+     * 查询会话分组 / List conversation groups
      */
-    listConversationSharesRaw(requestParameters, initOverrides) {
+    listConversationGroupsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.listConversationSharesRequestOpts(requestParameters);
+            const requestOptions = yield this.listConversationGroupsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationGroupList_1.ConversationGroupListFromJSON)(jsonValue));
         });
     }
     /**
-     * 查询会话分享 / List conversation shares 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 查询会话分享 / List conversation shares
+     * ### 使用场景 一次读取当前用户作用域下的完整分组目录。  ### Use case Read the complete group directory for the current user.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 一次读取当前用户作用域下的完整分组目录。  ### Behavior and side effects Read the complete group directory for the current user.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 查询会话分组 / List conversation groups  ### Operation summary 查询会话分组 / List conversation groups
+     * 查询会话分组 / List conversation groups
      */
-    listConversationShares(requestParameters, initOverrides) {
+    listConversationGroups(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.listConversationSharesRaw(requestParameters, initOverrides);
+            const response = yield this.listConversationGroupsRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -459,22 +616,22 @@ class ConversationsApi extends runtime.BaseAPI {
             if (requestParameters['size'] != null) {
                 queryParameters['size'] = requestParameters['size'];
             }
-            if (requestParameters['orderBy'] != null) {
-                queryParameters['orderBy'] = requestParameters['orderBy'];
-            }
-            if (requestParameters['orderDirection'] != null) {
-                queryParameters['orderDirection'] = requestParameters['orderDirection'];
-            }
-            if (requestParameters['orderNullHandling'] != null) {
-                queryParameters['orderNullHandling'] = requestParameters['orderNullHandling'];
+            if (requestParameters['status'] != null) {
+                queryParameters['status'] = requestParameters['status'];
             }
             if (requestParameters['keyword'] != null) {
                 queryParameters['keyword'] = requestParameters['keyword'];
             }
-            if (requestParameters['status'] != null) {
-                queryParameters['status'] = requestParameters['status'];
+            if (requestParameters['groupFilter'] != null) {
+                queryParameters['groupFilter'] = requestParameters['groupFilter'];
+            }
+            if (requestParameters['groupId'] != null) {
+                queryParameters['groupId'] = requestParameters['groupId'];
             }
             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
             }
@@ -501,18 +658,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 分页查询会话 / List conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 构建用户的分页会话列表与搜索结果。  ### Use case Build the user\'s paged conversation list and search results.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回分页记录。  ### Behavior and side effects Read-only and returns paged records.  ### 后续调用 按需读取标题、活动状态或消息。  ### Next step Read titles, activity, or messages as needed.  ### 接口摘要 分页查询会话 / List conversations  ### Operation summary 分页查询会话 / List conversations
      * 分页查询会话 / List conversations
      */
     listConversationsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.listConversationsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationSummaryList_1.ConversationSummaryListFromJSON)(jsonValue));
         });
     }
     /**
-     * 分页查询会话 / List conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 构建用户的分页会话列表与搜索结果。  ### Use case Build the user\'s paged conversation list and search results.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回分页记录。  ### Behavior and side effects Read-only and returns paged records.  ### 后续调用 按需读取标题、活动状态或消息。  ### Next step Read titles, activity, or messages as needed.  ### 接口摘要 分页查询会话 / List conversations  ### Operation summary 分页查询会话 / List conversations
      * 分页查询会话 / List conversations
      */
     listConversations(requestParameters, initOverrides) {
@@ -531,6 +688,9 @@ class ConversationsApi 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
             }
@@ -557,18 +717,18 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 查询未读会话 / List unread conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 显示存在未读完成结果的会话角标。  ### Use case Display conversations with unread completed results.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回未读会话 ID。  ### Behavior and side effects Read-only and returns unread conversation IDs.  ### 后续调用 读取消息后推进已读游标。  ### Next step Advance the read cursor after reading messages.  ### 接口摘要 查询未读会话 / List unread conversations  ### Operation summary 查询未读会话 / List unread conversations
      * 查询未读会话 / List unread conversations
      */
     listUnreadConversationsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.listUnreadConversationsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationIds_1.ConversationIdsFromJSON)(jsonValue));
         });
     }
     /**
-     * 查询未读会话 / List unread conversations 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 显示存在未读完成结果的会话角标。  ### Use case Display conversations with unread completed results.  ### 前置条件 外部用户已配置。  ### Prerequisites The external user is configured.  ### 行为与副作用 只读，返回未读会话 ID。  ### Behavior and side effects Read-only and returns unread conversation IDs.  ### 后续调用 读取消息后推进已读游标。  ### Next step Advance the read cursor after reading messages.  ### 接口摘要 查询未读会话 / List unread conversations  ### Operation summary 查询未读会话 / List unread conversations
      * 查询未读会话 / List unread conversations
      */
     listUnreadConversations(requestParameters, initOverrides) {
@@ -594,6 +754,9 @@ class ConversationsApi 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
             }
@@ -617,23 +780,23 @@ class ConversationsApi extends runtime.BaseAPI {
                 method: 'PUT',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationReadReceiptInput'],
+                body: (0, ConversationReadReceiptInput_1.ConversationReadReceiptInputToJSON)(requestParameters['conversationReadReceiptInput']),
             };
         });
     }
     /**
-     * 推进会话已读游标 / Mark a conversation as read 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户查看结果后推进会话已读位置。  ### Use case Advance a conversation\'s read position after the user views a result.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 更新已读游标，不删除消息。  ### Behavior and side effects Updates the read cursor without deleting messages.  ### 后续调用 刷新未读会话列表。  ### Next step Refresh the unread conversation list.  ### 接口摘要 推进会话已读游标 / Mark a conversation as read  ### Operation summary 推进会话已读游标 / Mark a conversation as read
      * 推进会话已读游标 / Mark a conversation as read
      */
     markConversationReadRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.markConversationReadRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationReadReceipt_1.ConversationReadReceiptFromJSON)(jsonValue));
         });
     }
     /**
-     * 推进会话已读游标 / Mark a conversation as read 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户查看结果后推进会话已读位置。  ### Use case Advance a conversation\'s read position after the user views a result.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 更新已读游标，不删除消息。  ### Behavior and side effects Updates the read cursor without deleting messages.  ### 后续调用 刷新未读会话列表。  ### Next step Refresh the unread conversation list.  ### 接口摘要 推进会话已读游标 / Mark a conversation as read  ### Operation summary 推进会话已读游标 / Mark a conversation as read
      * 推进会话已读游标 / Mark a conversation as read
      */
     markConversationRead(requestParameters, initOverrides) {
@@ -642,6 +805,74 @@ class ConversationsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for moveConversationToGroup without sending the request
+     */
+    moveConversationToGroupRequestOpts(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 moveConversationToGroup().');
+            }
+            if (requestParameters['conversationId'] == null) {
+                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling moveConversationToGroup().');
+            }
+            if (requestParameters['updateConversationGroupInput'] == null) {
+                throw new runtime.RequiredError('updateConversationGroupInput', 'Required parameter "updateConversationGroupInput" was null or undefined when calling moveConversationToGroup().');
+            }
+            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}/group`;
+            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: (0, UpdateConversationGroupInput_1.UpdateConversationGroupInputToJSON)(requestParameters['updateConversationGroupInput']),
+            };
+        });
+    }
+    /**
+     * ### 使用场景 必须显式提供 groupId；null 表示移回未分组。  ### Use case Supply groupId explicitly; null moves the conversation to ungrouped.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 必须显式提供 groupId；null 表示移回未分组。  ### Behavior and side effects Supply groupId explicitly; null moves the conversation to ungrouped.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 移动会话分组 / Move conversation to group  ### Operation summary 移动会话分组 / Move conversation to group
+     * 移动会话分组 / Move conversation to group
+     */
+    moveConversationToGroupRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.moveConversationToGroupRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationMetadata_1.ConversationMetadataFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 必须显式提供 groupId；null 表示移回未分组。  ### Use case Supply groupId explicitly; null moves the conversation to ungrouped.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 必须显式提供 groupId；null 表示移回未分组。  ### Behavior and side effects Supply groupId explicitly; null moves the conversation to ungrouped.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 移动会话分组 / Move conversation to group  ### Operation summary 移动会话分组 / Move conversation to group
+     * 移动会话分组 / Move conversation to group
+     */
+    moveConversationToGroup(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.moveConversationToGroupRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for queryConversationActivities without sending the request
      */
@@ -656,6 +887,9 @@ class ConversationsApi 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
             }
@@ -678,23 +912,23 @@ class ConversationsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationActivityBatchInput'],
+                body: (0, ConversationActivityBatchInput_1.ConversationActivityBatchInputToJSON)(requestParameters['conversationActivityBatchInput']),
             };
         });
     }
     /**
-     * 批量查询会话活动 / Query conversation activities 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 批量刷新多个会话的执行与未读状态。  ### Use case Refresh execution and unread state for multiple conversations in one request.  ### 前置条件 已持有最多 1000 个当前用户的会话 ID。  ### Prerequisites Up to 1000 conversation IDs for the current user are available.  ### 行为与副作用 只读，返回每个会话的活动投影。  ### Behavior and side effects Read-only and returns an activity projection per conversation.  ### 后续调用 更新列表状态并恢复必要的流。  ### Next step Update list state and recover any required streams.  ### 接口摘要 批量查询会话活动 / Query conversation activities  ### Operation summary 批量查询会话活动 / Query conversation activities
      * 批量查询会话活动 / Query conversation activities
      */
     queryConversationActivitiesRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.queryConversationActivitiesRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationActivityList_1.ConversationActivityListFromJSON)(jsonValue));
         });
     }
     /**
-     * 批量查询会话活动 / Query conversation activities 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 批量刷新多个会话的执行与未读状态。  ### Use case Refresh execution and unread state for multiple conversations in one request.  ### 前置条件 已持有最多 1000 个当前用户的会话 ID。  ### Prerequisites Up to 1000 conversation IDs for the current user are available.  ### 行为与副作用 只读，返回每个会话的活动投影。  ### Behavior and side effects Read-only and returns an activity projection per conversation.  ### 后续调用 更新列表状态并恢复必要的流。  ### Next step Update list state and recover any required streams.  ### 接口摘要 批量查询会话活动 / Query conversation activities  ### Operation summary 批量查询会话活动 / Query conversation activities
      * 批量查询会话活动 / Query conversation activities
      */
     queryConversationActivities(requestParameters, initOverrides) {
@@ -704,21 +938,25 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates request options for revokeConversationShare without sending the request
+     * Creates request options for renameConversationGroup without sending the request
      */
-    revokeConversationShareRequestOpts(requestParameters) {
+    renameConversationGroupRequestOpts(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 revokeConversationShare().');
+                throw new runtime.RequiredError('channelId', 'Required parameter "channelId" was null or undefined when calling renameConversationGroup().');
             }
-            if (requestParameters['conversationId'] == null) {
-                throw new runtime.RequiredError('conversationId', 'Required parameter "conversationId" was null or undefined when calling revokeConversationShare().');
+            if (requestParameters['groupId'] == null) {
+                throw new runtime.RequiredError('groupId', 'Required parameter "groupId" was null or undefined when calling renameConversationGroup().');
             }
-            if (requestParameters['shareId'] == null) {
-                throw new runtime.RequiredError('shareId', 'Required parameter "shareId" was null or undefined when calling revokeConversationShare().');
+            if (requestParameters['conversationGroupNameInput'] == null) {
+                throw new runtime.RequiredError('conversationGroupNameInput', 'Required parameter "conversationGroupNameInput" was null or undefined when calling renameConversationGroup().');
             }
             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
             }
@@ -734,36 +972,36 @@ class ConversationsApi extends runtime.BaseAPI {
             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}/shares/{shareId}`;
+            let urlPath = `/api/agents/channel/openapi/v1/{channelId}/chat/conversation-groups/{groupId}`;
             urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
-            urlPath = urlPath.replace('{conversationId}', encodeURIComponent(String(requestParameters['conversationId'])));
-            urlPath = urlPath.replace('{shareId}', encodeURIComponent(String(requestParameters['shareId'])));
+            urlPath = urlPath.replace('{groupId}', encodeURIComponent(String(requestParameters['groupId'])));
             return {
                 path: urlPath,
-                method: 'DELETE',
+                method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
+                body: (0, ConversationGroupNameInput_1.ConversationGroupNameInputToJSON)(requestParameters['conversationGroupNameInput']),
             };
         });
     }
     /**
-     * 撤销会话分享 / Revoke a conversation share 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 撤销会话分享 / Revoke a conversation share
+     * ### 使用场景 更新当前用户的分组名称。  ### Use case Update the name of a group owned by the current user.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 更新当前用户的分组名称。  ### Behavior and side effects Update the name of a group owned by the current user.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 重命名会话分组 / Rename conversation group  ### Operation summary 重命名会话分组 / Rename conversation group
+     * 重命名会话分组 / Rename conversation group
      */
-    revokeConversationShareRaw(requestParameters, initOverrides) {
+    renameConversationGroupRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.revokeConversationShareRequestOpts(requestParameters);
+            const requestOptions = yield this.renameConversationGroupRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationGroup_1.ConversationGroupFromJSON)(jsonValue));
         });
     }
     /**
-     * 撤销会话分享 / Revoke a conversation share 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
-     * 撤销会话分享 / Revoke a conversation share
+     * ### 使用场景 更新当前用户的分组名称。  ### Use case Update the name of a group owned by the current user.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 更新当前用户的分组名称。  ### Behavior and side effects Update the name of a group owned by the current user.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 重命名会话分组 / Rename conversation group  ### Operation summary 重命名会话分组 / Rename conversation group
+     * 重命名会话分组 / Rename conversation group
      */
-    revokeConversationShare(requestParameters, initOverrides) {
+    renameConversationGroup(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.revokeConversationShareRaw(requestParameters, initOverrides);
+            const response = yield this.renameConversationGroupRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }
@@ -784,6 +1022,9 @@ class ConversationsApi 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
             }
@@ -807,12 +1048,12 @@ class ConversationsApi extends runtime.BaseAPI {
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationStatusInput'],
+                body: (0, ConversationStatusInput_1.ConversationStatusInputToJSON)(requestParameters['conversationStatusInput']),
             };
         });
     }
     /**
-     * 更新会话状态 / Update conversation status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 归档、恢复或切换会话业务状态。  ### Use case Archive, restore, or otherwise change conversation business status.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步更新会话状态。  ### Behavior and side effects Updates conversation status asynchronously.  ### 后续调用 按新状态刷新会话列表。  ### Next step Refresh conversation lists using the new status.  ### 接口摘要 更新会话状态 / Update conversation status  ### Operation summary 更新会话状态 / Update conversation status
      * 更新会话状态 / Update conversation status
      */
     updateConversationStatusRaw(requestParameters, initOverrides) {
@@ -823,7 +1064,7 @@ class ConversationsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 更新会话状态 / Update conversation status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 归档、恢复或切换会话业务状态。  ### Use case Archive, restore, or otherwise change conversation business status.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步更新会话状态。  ### Behavior and side effects Updates conversation status asynchronously.  ### 后续调用 按新状态刷新会话列表。  ### Next step Refresh conversation lists using the new status.  ### 接口摘要 更新会话状态 / Update conversation status  ### Operation summary 更新会话状态 / Update conversation status
      * 更新会话状态 / Update conversation status
      */
     updateConversationStatus(requestParameters, initOverrides) {
@@ -848,6 +1089,9 @@ class ConversationsApi 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
             }
@@ -871,28 +1115,29 @@ class ConversationsApi extends runtime.BaseAPI {
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationTitleInput'],
+                body: (0, ConversationTitleInput_1.ConversationTitleInputToJSON)(requestParameters['conversationTitleInput']),
             };
         });
     }
     /**
-     * 更新会话标题 / Update conversation title 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 保存用户编辑的会话标题。  ### Use case Save a user-edited conversation title.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 同步更新标题并返回权威会话元数据。  ### Behavior and side effects Update the title and return authoritative conversation metadata.  ### 后续调用 重新读取标题或刷新列表。  ### Next step Read the title again or refresh the list.  ### 接口摘要 更新会话标题 / Update conversation title  ### Operation summary 更新会话标题 / Update conversation title
      * 更新会话标题 / Update conversation title
      */
     updateConversationTitleRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.updateConversationTitleRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.VoidApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, ConversationMetadata_1.ConversationMetadataFromJSON)(jsonValue));
         });
     }
     /**
-     * 更新会话标题 / Update conversation title 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 保存用户编辑的会话标题。  ### Use case Save a user-edited conversation title.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 同步更新标题并返回权威会话元数据。  ### Behavior and side effects Update the title and return authoritative conversation metadata.  ### 后续调用 重新读取标题或刷新列表。  ### Next step Read the title again or refresh the list.  ### 接口摘要 更新会话标题 / Update conversation title  ### Operation summary 更新会话标题 / Update conversation title
      * 更新会话标题 / Update conversation title
      */
     updateConversationTitle(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.updateConversationTitleRaw(requestParameters, initOverrides);
+            const response = yield this.updateConversationTitleRaw(requestParameters, initOverrides);
+            return yield response.value();
         });
     }
 }
@@ -900,15 +1145,16 @@ exports.ConversationsApi = ConversationsApi;
 /**
  * @export
  */
-exports.ListConversationsOrderDirectionEnum = {
-    Asc: 'ASC',
-    Desc: 'DESC',
+exports.ListConversationsStatusEnum = {
+    Active: 'ACTIVE',
+    Archived: 'ARCHIVED',
+    All: 'ALL',
 };
 /**
  * @export
  */
-exports.ListConversationsOrderNullHandlingEnum = {
-    Native: 'NATIVE',
-    NullsFirst: 'NULLS_FIRST',
-    NullsLast: 'NULLS_LAST',
+exports.ListConversationsGroupFilterEnum = {
+    All: 'ALL',
+    Ungrouped: 'UNGROUPED',
+    Group: 'GROUP',
 };