@lingya-ai/agents-sdk 0.5.0 → 0.7.0

package/dist/esm/apis/ConfigurationApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -23,10 +23,67 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import * as runtime from '../runtime';
 import { AgentsConfigFromJSON, } from '../models/AgentsConfig';
 import { ConversationConfigFromJSON, } from '../models/ConversationConfig';
+import { OpenApiTokenFromJSON, } from '../models/OpenApiToken';
 /**
  *
  */
 export class ConfigurationApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for createOpenApiToken without sending the request
+     */
+    createOpenApiTokenRequestOpts(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 createOpenApiToken().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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/presign`;
+            urlPath = urlPath.replace('{channelId}', encodeURIComponent(String(requestParameters['channelId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * ### 使用场景 仅接受 AK/SK 签名且请求体必须为空；返回 token 和 expiresAt。十分钟内有效的一次性渠道令牌，绑定签发时的渠道和用户身份。截止 expiresAt 前仅能认证一个新请求；认证成功即消费，业务失败不退还。每次新请求、重试或 SSE/WebSocket 重连都必须重新签发，不得缓存复用。使用 X-OpenAPI-Token，与所有 HMAC 鉴权头互斥，不能用于 presign。  ### Use case Requires AK/SK signing with an empty request body; returns token and expiresAt. A single-use channel token valid for ten minutes, bound to the issuing channel and user. It authenticates only one new request before expiresAt and is consumed on successful authentication even if the business operation fails. Obtain a fresh token for every new request, retry, or SSE/WebSocket reconnection; never cache or reuse it. Send X-OpenAPI-Token without any HMAC authentication headers; tokens cannot call presign.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 仅接受 AK/SK 签名且请求体必须为空；返回 token 和 expiresAt。十分钟内有效的一次性渠道令牌，绑定签发时的渠道和用户身份。截止 expiresAt 前仅能认证一个新请求；认证成功即消费，业务失败不退还。每次新请求、重试或 SSE/WebSocket 重连都必须重新签发，不得缓存复用。使用 X-OpenAPI-Token，与所有 HMAC 鉴权头互斥，不能用于 presign。  ### Behavior and side effects Requires AK/SK signing with an empty request body; returns token and expiresAt. A single-use channel token valid for ten minutes, bound to the issuing channel and user. It authenticates only one new request before expiresAt and is consumed on successful authentication even if the business operation fails. Obtain a fresh token for every new request, retry, or SSE/WebSocket reconnection; never cache or reuse it. Send X-OpenAPI-Token without any HMAC authentication headers; tokens cannot call presign.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 签发一次性短期渠道令牌 / Create a single-use short-lived channel token  ### Operation summary 签发一次性短期渠道令牌 / Create a single-use short-lived channel token
+     * 签发一次性短期渠道令牌 / Create a single-use short-lived channel token
+     */
+    createOpenApiTokenRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createOpenApiTokenRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => OpenApiTokenFromJSON(jsonValue));
+        });
+    }
+    /**
+     * ### 使用场景 仅接受 AK/SK 签名且请求体必须为空；返回 token 和 expiresAt。十分钟内有效的一次性渠道令牌，绑定签发时的渠道和用户身份。截止 expiresAt 前仅能认证一个新请求；认证成功即消费，业务失败不退还。每次新请求、重试或 SSE/WebSocket 重连都必须重新签发，不得缓存复用。使用 X-OpenAPI-Token，与所有 HMAC 鉴权头互斥，不能用于 presign。  ### Use case Requires AK/SK signing with an empty request body; returns token and expiresAt. A single-use channel token valid for ten minutes, bound to the issuing channel and user. It authenticates only one new request before expiresAt and is consumed on successful authentication even if the business operation fails. Obtain a fresh token for every new request, retry, or SSE/WebSocket reconnection; never cache or reuse it. Send X-OpenAPI-Token without any HMAC authentication headers; tokens cannot call presign.  ### 前置条件 有效渠道身份；会话资源必须属于当前用户。  ### Prerequisites Valid channel identity; conversation resources must belong to the current user.  ### 行为与副作用 仅接受 AK/SK 签名且请求体必须为空；返回 token 和 expiresAt。十分钟内有效的一次性渠道令牌，绑定签发时的渠道和用户身份。截止 expiresAt 前仅能认证一个新请求；认证成功即消费，业务失败不退还。每次新请求、重试或 SSE/WebSocket 重连都必须重新签发，不得缓存复用。使用 X-OpenAPI-Token，与所有 HMAC 鉴权头互斥，不能用于 presign。  ### Behavior and side effects Requires AK/SK signing with an empty request body; returns token and expiresAt. A single-use channel token valid for ten minutes, bound to the issuing channel and user. It authenticates only one new request before expiresAt and is consumed on successful authentication even if the business operation fails. Obtain a fresh token for every new request, retry, or SSE/WebSocket reconnection; never cache or reuse it. Send X-OpenAPI-Token without any HMAC authentication headers; tokens cannot call presign.  ### 后续调用 根据返回的权威状态更新客户端。  ### Next step Update the client using the returned authoritative state.  ### 接口摘要 签发一次性短期渠道令牌 / Create a single-use short-lived channel token  ### Operation summary 签发一次性短期渠道令牌 / Create a single-use short-lived channel token
+     * 签发一次性短期渠道令牌 / Create a single-use short-lived channel token
+     */
+    createOpenApiToken(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createOpenApiTokenRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getAgentsConfig without sending the request
      */
@@ -37,6 +94,9 @@ export class ConfigurationApi 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
             }
@@ -96,6 +156,9 @@ export class ConfigurationApi 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
             }

package/dist/esm/apis/ConversationsApi.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.5
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -13,31 +13,30 @@ import * as runtime from '../runtime';
 import { type ConversationActivityBatchInput } from '../models/ConversationActivityBatchInput';
 import { type ConversationActivityList } from '../models/ConversationActivityList';
 import { type ConversationContextUsage } from '../models/ConversationContextUsage';
+import { type ConversationGroup } from '../models/ConversationGroup';
+import { type ConversationGroupDeleted } from '../models/ConversationGroupDeleted';
+import { type ConversationGroupList } from '../models/ConversationGroupList';
+import { type ConversationGroupNameInput } from '../models/ConversationGroupNameInput';
 import { type ConversationIds } from '../models/ConversationIds';
+import { type ConversationMetadata } from '../models/ConversationMetadata';
 import { type ConversationReadReceipt } from '../models/ConversationReadReceipt';
 import { type ConversationReadReceiptInput } from '../models/ConversationReadReceiptInput';
-import { type ConversationShareCreated } from '../models/ConversationShareCreated';
-import { type ConversationShareInput } from '../models/ConversationShareInput';
-import { type ConversationShareList } from '../models/ConversationShareList';
-import { type ConversationShareRevoked } from '../models/ConversationShareRevoked';
 import { type ConversationStats } from '../models/ConversationStats';
 import { type ConversationStatusInput } from '../models/ConversationStatusInput';
+import { type ConversationSummary } from '../models/ConversationSummary';
 import { type ConversationSummaryList } from '../models/ConversationSummaryList';
 import { type ConversationTitle } from '../models/ConversationTitle';
 import { type ConversationTitleInput } from '../models/ConversationTitleInput';
-export interface CreateConversationShareRequest {
+import { type UpdateConversationGroupInput } from '../models/UpdateConversationGroupInput';
+export interface CreateConversationGroupRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
     channelId: string;
-    /**
-     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
-     */
-    conversationId: string;
     /**
      *
      */
-    conversationShareInput: ConversationShareInput;
+    conversationGroupNameInput: ConversationGroupNameInput;
 }
 export interface DeleteConversationRequest {
     /**
@@ -49,6 +48,16 @@ export interface DeleteConversationRequest {
      */
     conversationId: string;
 }
+export interface DeleteConversationGroupRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 字段 groupId / group id field。
+     */
+    groupId: number;
+}
 export interface GetConversationContextUsageRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -65,7 +74,7 @@ export interface GetConversationStatsRequest {
      */
     channelId: string;
 }
-export interface GetConversationTitleRequest {
+export interface GetConversationSummaryRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
@@ -75,21 +84,27 @@ export interface GetConversationTitleRequest {
      */
     conversationId: string;
 }
-export interface ListActiveConversationsRequest {
+export interface GetConversationTitleRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
     channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
 }
-export interface ListConversationSharesRequest {
+export interface ListActiveConversationsRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
     channelId: string;
+}
+export interface ListConversationGroupsRequest {
     /**
-     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
-    conversationId: string;
+    channelId: string;
 }
 export interface ListConversationsRequest {
     /**
@@ -105,25 +120,21 @@ export interface ListConversationsRequest {
      */
     size?: number;
     /**
-     * 排序字段列表。 / Ordered list of sort fields.
-     */
-    orderBy?: Array<string>;
-    /**
-     * 排序方向。 / Sort direction.
-     */
-    orderDirection?: ListConversationsOrderDirectionEnum;
-    /**
-     * 空值排序策略。 / Null ordering strategy.
+     * 状态过滤条件。 / Status filter.
      */
-    orderNullHandling?: ListConversationsOrderNullHandlingEnum;
+    status?: ListConversationsStatusEnum;
     /**
      * 标题或正文检索关键字。 / Title or content search keyword.
      */
     keyword?: string;
     /**
-     * 状态过滤条件。 / Status filter.
+     * 字段 groupFilter / group filter field。
+     */
+    groupFilter?: ListConversationsGroupFilterEnum;
+    /**
+     * groupFilter 为 GROUP 时必填。 / Required when groupFilter is GROUP.
      */
-    status?: string;
+    groupId?: number;
 }
 export interface ListUnreadConversationsRequest {
     /**
@@ -145,6 +156,20 @@ export interface MarkConversationReadRequest {
      */
     conversationReadReceiptInput: ConversationReadReceiptInput;
 }
+export interface MoveConversationToGroupRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     *
+     */
+    updateConversationGroupInput: UpdateConversationGroupInput;
+}
 export interface QueryConversationActivitiesRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -155,19 +180,19 @@ export interface QueryConversationActivitiesRequest {
      */
     conversationActivityBatchInput: ConversationActivityBatchInput;
 }
-export interface RevokeConversationShareRequest {
+export interface RenameConversationGroupRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
      */
     channelId: string;
     /**
-     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * 字段 groupId / group id field。
      */
-    conversationId: string;
+    groupId: number;
     /**
-     * 会话分享记录 ID。 / Conversation-share record ID.
+     *
      */
-    shareId: number;
+    conversationGroupNameInput: ConversationGroupNameInput;
 }
 export interface UpdateConversationStatusRequest {
     /**
@@ -202,19 +227,19 @@ export interface UpdateConversationTitleRequest {
  */
 export declare 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: CreateConversationShareRequest): Promise<runtime.RequestOpts>;
+    createConversationGroupRequestOpts(requestParameters: CreateConversationGroupRequest): Promise<runtime.RequestOpts>;
     /**
-     * ### 使用场景 为会话创建受控的外部分享。  ### Use case Create controlled external sharing for a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新的分享记录和分享码。  ### Behavior and side effects Creates a share record and share code.  ### 后续调用 安全地交付分享信息，并定期检查有效期。  ### Next step Deliver share information securely and monitor its expiry.  ### 接口摘要 创建会话分享 / Create a conversation share  ### Operation summary 创建会话分享 / Create a conversation share
-     * 创建会话分享 / 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: CreateConversationShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationShareCreated>>;
+    createConversationGroupRaw(requestParameters: CreateConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationGroup>>;
     /**
-     * ### 使用场景 为会话创建受控的外部分享。  ### Use case Create controlled external sharing for a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新的分享记录和分享码。  ### Behavior and side effects Creates a share record and share code.  ### 后续调用 安全地交付分享信息，并定期检查有效期。  ### Next step Deliver share information securely and monitor its expiry.  ### 接口摘要 创建会话分享 / Create a conversation share  ### Operation summary 创建会话分享 / Create a conversation share
-     * 创建会话分享 / 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: CreateConversationShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationShareCreated>;
+    createConversationGroup(requestParameters: CreateConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationGroup>;
     /**
      * Creates request options for deleteConversation without sending the request
      */
@@ -229,6 +254,20 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      * 删除会话 / Delete a conversation
      */
     deleteConversation(requestParameters: DeleteConversationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for deleteConversationGroup without sending the request
+     */
+    deleteConversationGroupRequestOpts(requestParameters: DeleteConversationGroupRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 删除分组并将会话移回未分组，返回移动数量。  ### 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: DeleteConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationGroupDeleted>>;
+    /**
+     * ### 使用场景 删除分组并将会话移回未分组，返回移动数量。  ### 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: DeleteConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationGroupDeleted>;
     /**
      * Creates request options for getConversationContextUsage without sending the request
      */
@@ -257,6 +296,20 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      * 读取会话统计 / Get conversation statistics
      */
     getConversationStats(requestParameters: GetConversationStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationStats>;
+    /**
+     * Creates request options for getConversationSummary without sending the request
+     */
+    getConversationSummaryRequestOpts(requestParameters: GetConversationSummaryRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 按会话标识恢复当前用户的会话摘要。  ### 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: GetConversationSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationSummary>>;
+    /**
+     * ### 使用场景 按会话标识恢复当前用户的会话摘要。  ### 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: GetConversationSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationSummary>;
     /**
      * Creates request options for getConversationTitle without sending the request
      */
@@ -286,19 +339,19 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      */
     listActiveConversations(requestParameters: ListActiveConversationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationIds>;
     /**
-     * Creates request options for listConversationShares without sending the request
+     * Creates request options for listConversationGroups without sending the request
      */
-    listConversationSharesRequestOpts(requestParameters: ListConversationSharesRequest): Promise<runtime.RequestOpts>;
+    listConversationGroupsRequestOpts(requestParameters: ListConversationGroupsRequest): Promise<runtime.RequestOpts>;
     /**
-     * ### 使用场景 查看会话当前创建的分享记录。  ### Use case Inspect the conversation\'s current share records.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Create a new share or revoke an existing one as needed.  ### 接口摘要 查询会话分享 / List conversation shares  ### Operation summary 查询会话分享 / List conversation shares
-     * 查询会话分享 / 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: ListConversationSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationShareList>>;
+    listConversationGroupsRaw(requestParameters: ListConversationGroupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationGroupList>>;
     /**
-     * ### 使用场景 查看会话当前创建的分享记录。  ### Use case Inspect the conversation\'s current share records.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Create a new share or revoke an existing one as needed.  ### 接口摘要 查询会话分享 / List conversation shares  ### Operation summary 查询会话分享 / List conversation shares
-     * 查询会话分享 / 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: ListConversationSharesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationShareList>;
+    listConversationGroups(requestParameters: ListConversationGroupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationGroupList>;
     /**
      * Creates request options for listConversations without sending the request
      */
@@ -341,6 +394,20 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      * 推进会话已读游标 / Mark a conversation as read
      */
     markConversationRead(requestParameters: MarkConversationReadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationReadReceipt>;
+    /**
+     * Creates request options for moveConversationToGroup without sending the request
+     */
+    moveConversationToGroupRequestOpts(requestParameters: MoveConversationToGroupRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 必须显式提供 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: MoveConversationToGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationMetadata>>;
+    /**
+     * ### 使用场景 必须显式提供 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: MoveConversationToGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMetadata>;
     /**
      * Creates request options for queryConversationActivities without sending the request
      */
@@ -356,19 +423,19 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      */
     queryConversationActivities(requestParameters: QueryConversationActivitiesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationActivityList>;
     /**
-     * Creates request options for revokeConversationShare without sending the request
+     * Creates request options for renameConversationGroup without sending the request
      */
-    revokeConversationShareRequestOpts(requestParameters: RevokeConversationShareRequest): Promise<runtime.RequestOpts>;
+    renameConversationGroupRequestOpts(requestParameters: RenameConversationGroupRequest): Promise<runtime.RequestOpts>;
     /**
-     * ### 使用场景 使不再需要的分享立即失效。  ### Use case Invalidate a share that is no longer needed.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 撤销指定分享，不删除原会话。  ### Behavior and side effects Revokes the selected share without deleting the conversation.  ### 后续调用 刷新分享列表并停止分发旧链接。  ### Next step Refresh the share list and stop distributing the old link.  ### 接口摘要 撤销会话分享 / Revoke a conversation share  ### Operation summary 撤销会话分享 / Revoke a conversation share
-     * 撤销会话分享 / 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: RevokeConversationShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationShareRevoked>>;
+    renameConversationGroupRaw(requestParameters: RenameConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationGroup>>;
     /**
-     * ### 使用场景 使不再需要的分享立即失效。  ### Use case Invalidate a share that is no longer needed.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 撤销指定分享，不删除原会话。  ### Behavior and side effects Revokes the selected share without deleting the conversation.  ### 后续调用 刷新分享列表并停止分发旧链接。  ### Next step Refresh the share list and stop distributing the old link.  ### 接口摘要 撤销会话分享 / Revoke a conversation share  ### Operation summary 撤销会话分享 / Revoke a conversation share
-     * 撤销会话分享 / 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: RevokeConversationShareRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationShareRevoked>;
+    renameConversationGroup(requestParameters: RenameConversationGroupRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationGroup>;
     /**
      * Creates request options for updateConversationStatus without sending the request
      */
@@ -388,30 +455,31 @@ export declare class ConversationsApi extends runtime.BaseAPI {
      */
     updateConversationTitleRequestOpts(requestParameters: UpdateConversationTitleRequest): Promise<runtime.RequestOpts>;
     /**
-     * ### 使用场景 保存用户编辑的会话标题。  ### 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 Updates the title asynchronously.  ### 后续调用 重新读取标题或刷新列表。  ### Next step Read the title again or refresh the list.  ### 接口摘要 更新会话标题 / Update conversation title  ### Operation summary 更新会话标题 / Update conversation title
+     * ### 使用场景 保存用户编辑的会话标题。  ### 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: UpdateConversationTitleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    updateConversationTitleRaw(requestParameters: UpdateConversationTitleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationMetadata>>;
     /**
-     * ### 使用场景 保存用户编辑的会话标题。  ### 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 Updates the title asynchronously.  ### 后续调用 重新读取标题或刷新列表。  ### Next step Read the title again or refresh the list.  ### 接口摘要 更新会话标题 / Update conversation title  ### Operation summary 更新会话标题 / Update conversation title
+     * ### 使用场景 保存用户编辑的会话标题。  ### 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: UpdateConversationTitleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    updateConversationTitle(requestParameters: UpdateConversationTitleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMetadata>;
 }
 /**
  * @export
  */
-export declare const ListConversationsOrderDirectionEnum: {
-    readonly Asc: "ASC";
-    readonly Desc: "DESC";
+export declare const ListConversationsStatusEnum: {
+    readonly Active: "ACTIVE";
+    readonly Archived: "ARCHIVED";
+    readonly All: "ALL";
 };
-export type ListConversationsOrderDirectionEnum = typeof ListConversationsOrderDirectionEnum[keyof typeof ListConversationsOrderDirectionEnum];
+export type ListConversationsStatusEnum = typeof ListConversationsStatusEnum[keyof typeof ListConversationsStatusEnum];
 /**
  * @export
  */
-export declare const ListConversationsOrderNullHandlingEnum: {
-    readonly Native: "NATIVE";
-    readonly NullsFirst: "NULLS_FIRST";
-    readonly NullsLast: "NULLS_LAST";
+export declare const ListConversationsGroupFilterEnum: {
+    readonly All: "ALL";
+    readonly Ungrouped: "UNGROUPED";
+    readonly Group: "GROUP";
 };
-export type ListConversationsOrderNullHandlingEnum = typeof ListConversationsOrderNullHandlingEnum[keyof typeof ListConversationsOrderNullHandlingEnum];
+export type ListConversationsGroupFilterEnum = typeof ListConversationsGroupFilterEnum[keyof typeof ListConversationsGroupFilterEnum];