@lingya-ai/agents-sdk 0.4.0 → 0.7.0

package/dist/esm/apis/ConversationsApi.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,27 +21,45 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { ConversationActivityBatchInputToJSON, } from '../models/ConversationActivityBatchInput';
+import { ConversationActivityListFromJSON, } from '../models/ConversationActivityList';
+import { ConversationContextUsageFromJSON, } from '../models/ConversationContextUsage';
+import { ConversationGroupFromJSON, } from '../models/ConversationGroup';
+import { ConversationGroupDeletedFromJSON, } from '../models/ConversationGroupDeleted';
+import { ConversationGroupListFromJSON, } from '../models/ConversationGroupList';
+import { ConversationGroupNameInputToJSON, } from '../models/ConversationGroupNameInput';
+import { ConversationIdsFromJSON, } from '../models/ConversationIds';
+import { ConversationMetadataFromJSON, } from '../models/ConversationMetadata';
+import { ConversationReadReceiptFromJSON, } from '../models/ConversationReadReceipt';
+import { ConversationReadReceiptInputToJSON, } from '../models/ConversationReadReceiptInput';
+import { ConversationStatsFromJSON, } from '../models/ConversationStats';
+import { ConversationStatusInputToJSON, } from '../models/ConversationStatusInput';
+import { ConversationSummaryFromJSON, } from '../models/ConversationSummary';
+import { ConversationSummaryListFromJSON, } from '../models/ConversationSummaryList';
+import { ConversationTitleFromJSON, } from '../models/ConversationTitle';
+import { ConversationTitleInputToJSON, } from '../models/ConversationTitleInput';
+import { UpdateConversationGroupInputToJSON, } from '../models/UpdateConversationGroupInput';
 /**
  *
  */
 export 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
             }
@@ -57,36 +75,35 @@ export 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: 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) => 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();
         });
     }
@@ -103,6 +120,9 @@ export 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
             }
@@ -130,7 +150,7 @@ export 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) {
@@ -141,7 +161,7 @@ export 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) {
@@ -149,6 +169,69 @@ export 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) => 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
      */
@@ -162,6 +245,9 @@ export 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
             }
@@ -189,18 +275,18 @@ export 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) => 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) {
@@ -219,6 +305,9 @@ export 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
             }
@@ -245,18 +334,18 @@ export 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) => 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) {
@@ -265,6 +354,69 @@ export 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) => 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
      */
@@ -278,6 +430,9 @@ export 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
             }
@@ -305,18 +460,18 @@ export 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) => 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) {
@@ -335,6 +490,9 @@ export 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
             }
@@ -361,18 +519,18 @@ export 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) => 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) {
@@ -382,18 +540,18 @@ export 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
             }
@@ -409,9 +567,8 @@ export 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',
@@ -421,23 +578,23 @@ export 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) => 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();
         });
     }
@@ -456,22 +613,22 @@ export 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
             }
@@ -498,18 +655,18 @@ export 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) => 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) {
@@ -528,6 +685,9 @@ export 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
             }
@@ -554,18 +714,18 @@ export 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) => 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) {
@@ -591,6 +751,9 @@ export 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
             }
@@ -614,23 +777,23 @@ export class ConversationsApi extends runtime.BaseAPI {
                 method: 'PUT',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationReadReceiptInput'],
+                body: 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) => 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) {
@@ -639,6 +802,74 @@ export 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: 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) => 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
      */
@@ -653,6 +884,9 @@ export 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
             }
@@ -675,23 +909,23 @@ export class ConversationsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationActivityBatchInput'],
+                body: 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) => 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) {
@@ -701,21 +935,25 @@ export 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
             }
@@ -731,36 +969,36 @@ export 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: 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) => 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();
         });
     }
@@ -781,6 +1019,9 @@ export 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
             }
@@ -804,12 +1045,12 @@ export class ConversationsApi extends runtime.BaseAPI {
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationStatusInput'],
+                body: 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) {
@@ -820,7 +1061,7 @@ export 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) {
@@ -845,6 +1086,9 @@ export 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
             }
@@ -868,43 +1112,45 @@ export class ConversationsApi extends runtime.BaseAPI {
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['conversationTitleInput'],
+                body: 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) => 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();
         });
     }
 }
 /**
  * @export
  */
-export const ListConversationsOrderDirectionEnum = {
-    Asc: 'ASC',
-    Desc: 'DESC',
+export const ListConversationsStatusEnum = {
+    Active: 'ACTIVE',
+    Archived: 'ARCHIVED',
+    All: 'ALL',
 };
 /**
  * @export
  */
-export const ListConversationsOrderNullHandlingEnum = {
-    Native: 'NATIVE',
-    NullsFirst: 'NULLS_FIRST',
-    NullsLast: 'NULLS_LAST',
+export const ListConversationsGroupFilterEnum = {
+    All: 'ALL',
+    Ungrouped: 'UNGROUPED',
+    Group: 'GROUP',
 };