@lingya-ai/agents-sdk 0.3.0 → 0.5.0

package/dist/apis/KnowledgeApi.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 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.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,9 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CitationMetadata, CitationMetadataList, ReturnedReference } from '../models/index';
+import { type CitationMetadata } from '../models/CitationMetadata';
+import { type CitationMetadataList } from '../models/CitationMetadataList';
+import { type ReturnedReference } from '../models/ReturnedReference';
 export interface GetCitationMetadataRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -44,12 +46,12 @@ export declare class KnowledgeApi extends runtime.BaseAPI {
      */
     getCitationMetadataRequestOpts(requestParameters: GetCitationMetadataRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取引用元数据 / Get citation metadata 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户展开单条引用时读取来源详情。  ### Use case Read source detail when a user expands one citation.  ### 前置条件 citationType 与 referenceId 来自服务端。  ### Prerequisites citationType and referenceId come from the server.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 展示标题、位置和其他元数据。  ### Next step Display title, location, and other metadata.  ### 接口摘要 读取引用元数据 / Get citation metadata  ### Operation summary 读取引用元数据 / Get citation metadata
      * 读取引用元数据 / Get citation metadata
      */
     getCitationMetadataRaw(requestParameters: GetCitationMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CitationMetadata>>;
     /**
-     * 读取引用元数据 / Get citation metadata 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户展开单条引用时读取来源详情。  ### Use case Read source detail when a user expands one citation.  ### 前置条件 citationType 与 referenceId 来自服务端。  ### Prerequisites citationType and referenceId come from the server.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 展示标题、位置和其他元数据。  ### Next step Display title, location, and other metadata.  ### 接口摘要 读取引用元数据 / Get citation metadata  ### Operation summary 读取引用元数据 / Get citation metadata
      * 读取引用元数据 / Get citation metadata
      */
     getCitationMetadata(requestParameters: GetCitationMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CitationMetadata>;
@@ -58,12 +60,12 @@ export declare class KnowledgeApi extends runtime.BaseAPI {
      */
     getCitationMetadataBatchRequestOpts(requestParameters: GetCitationMetadataBatchRequest): Promise<runtime.RequestOpts>;
     /**
-     * 批量读取引用元数据 / Get citation metadata in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 一次解析回答中的多条知识引用。  ### Use case Resolve multiple knowledge citations from an answer in one request.  ### 前置条件 引用列表来自服务端消息或事件。  ### Prerequisites The reference list comes from a server message or event.  ### 行为与副作用 只读，返回可展示元数据。  ### Behavior and side effects Read-only and returns display metadata.  ### 后续调用 按原引用顺序渲染来源。  ### Next step Render sources in the original reference order.  ### 接口摘要 批量读取引用元数据 / Get citation metadata in batch  ### Operation summary 批量读取引用元数据 / Get citation metadata in batch
      * 批量读取引用元数据 / Get citation metadata in batch
      */
     getCitationMetadataBatchRaw(requestParameters: GetCitationMetadataBatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<CitationMetadataList>>;
     /**
-     * 批量读取引用元数据 / Get citation metadata in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 一次解析回答中的多条知识引用。  ### Use case Resolve multiple knowledge citations from an answer in one request.  ### 前置条件 引用列表来自服务端消息或事件。  ### Prerequisites The reference list comes from a server message or event.  ### 行为与副作用 只读，返回可展示元数据。  ### Behavior and side effects Read-only and returns display metadata.  ### 后续调用 按原引用顺序渲染来源。  ### Next step Render sources in the original reference order.  ### 接口摘要 批量读取引用元数据 / Get citation metadata in batch  ### Operation summary 批量读取引用元数据 / Get citation metadata in batch
      * 批量读取引用元数据 / Get citation metadata in batch
      */
     getCitationMetadataBatch(requestParameters: GetCitationMetadataBatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CitationMetadataList>;

package/dist/apis/KnowledgeApi.js

@@ -3,9 +3,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 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.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -24,6 +24,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnowledgeApi = void 0;
 const runtime = require("../runtime");
+const CitationMetadata_1 = require("../models/CitationMetadata");
+const CitationMetadataList_1 = require("../models/CitationMetadataList");
+const ReturnedReference_1 = require("../models/ReturnedReference");
 /**
  *
  */
@@ -72,18 +75,18 @@ class KnowledgeApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取引用元数据 / Get citation metadata 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户展开单条引用时读取来源详情。  ### Use case Read source detail when a user expands one citation.  ### 前置条件 citationType 与 referenceId 来自服务端。  ### Prerequisites citationType and referenceId come from the server.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 展示标题、位置和其他元数据。  ### Next step Display title, location, and other metadata.  ### 接口摘要 读取引用元数据 / Get citation metadata  ### Operation summary 读取引用元数据 / Get citation metadata
      * 读取引用元数据 / Get citation metadata
      */
     getCitationMetadataRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getCitationMetadataRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, CitationMetadata_1.CitationMetadataFromJSON)(jsonValue));
         });
     }
     /**
-     * 读取引用元数据 / Get citation metadata 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户展开单条引用时读取来源详情。  ### Use case Read source detail when a user expands one citation.  ### 前置条件 citationType 与 referenceId 来自服务端。  ### Prerequisites citationType and referenceId come from the server.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 展示标题、位置和其他元数据。  ### Next step Display title, location, and other metadata.  ### 接口摘要 读取引用元数据 / Get citation metadata  ### Operation summary 读取引用元数据 / Get citation metadata
      * 读取引用元数据 / Get citation metadata
      */
     getCitationMetadata(requestParameters, initOverrides) {
@@ -128,23 +131,23 @@ class KnowledgeApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['returnedReference'],
+                body: requestParameters['returnedReference'].map(ReturnedReference_1.ReturnedReferenceToJSON),
             };
         });
     }
     /**
-     * 批量读取引用元数据 / Get citation metadata in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 一次解析回答中的多条知识引用。  ### Use case Resolve multiple knowledge citations from an answer in one request.  ### 前置条件 引用列表来自服务端消息或事件。  ### Prerequisites The reference list comes from a server message or event.  ### 行为与副作用 只读，返回可展示元数据。  ### Behavior and side effects Read-only and returns display metadata.  ### 后续调用 按原引用顺序渲染来源。  ### Next step Render sources in the original reference order.  ### 接口摘要 批量读取引用元数据 / Get citation metadata in batch  ### Operation summary 批量读取引用元数据 / Get citation metadata in batch
      * 批量读取引用元数据 / Get citation metadata in batch
      */
     getCitationMetadataBatchRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getCitationMetadataBatchRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, CitationMetadataList_1.CitationMetadataListFromJSON)(jsonValue));
         });
     }
     /**
-     * 批量读取引用元数据 / Get citation metadata in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 一次解析回答中的多条知识引用。  ### Use case Resolve multiple knowledge citations from an answer in one request.  ### 前置条件 引用列表来自服务端消息或事件。  ### Prerequisites The reference list comes from a server message or event.  ### 行为与副作用 只读，返回可展示元数据。  ### Behavior and side effects Read-only and returns display metadata.  ### 后续调用 按原引用顺序渲染来源。  ### Next step Render sources in the original reference order.  ### 接口摘要 批量读取引用元数据 / Get citation metadata in batch  ### Operation summary 批量读取引用元数据 / Get citation metadata in batch
      * 批量读取引用元数据 / Get citation metadata in batch
      */
     getCitationMetadataBatch(requestParameters, initOverrides) {

package/dist/apis/MessagesApi.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 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.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,29 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AsyncTask, AsyncTaskPage, ConversationMessage, ConversationMessagePage } from '../models/index';
+import { type AgentAsyncTaskSync } from '../models/AgentAsyncTaskSync';
+import { type AsyncTask } from '../models/AsyncTask';
+import { type AsyncTaskPage } from '../models/AsyncTaskPage';
+import { type ConversationMessage } from '../models/ConversationMessage';
+import { type ConversationMessagePage } from '../models/ConversationMessagePage';
+import { type SubagentTask } from '../models/SubagentTask';
+import { type SubagentTaskPage } from '../models/SubagentTaskPage';
+import { type SubagentTaskResult } from '../models/SubagentTaskResult';
+import { type SubagentTaskSync } from '../models/SubagentTaskSync';
+export interface CancelConversationSubagentRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 子 Agent 任务 ID。 / Subagent task ID.
+     */
+    subagentTaskId: string;
+}
 export interface CancelQueuedMessageRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -53,6 +75,34 @@ export interface GetConversationMessageRequest {
      */
     messageId: string;
 }
+export interface GetConversationSubagentRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 子 Agent 任务 ID。 / Subagent task ID.
+     */
+    subagentTaskId: string;
+}
+export interface GetConversationSubagentResultRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 子 Agent 任务 ID。 / Subagent task ID.
+     */
+    subagentTaskId: string;
+}
 export interface ListConversationAsyncTasksRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -125,21 +175,109 @@ export interface ListConversationMessagesRequest {
      */
     keyword?: string;
 }
+export interface ListConversationSubagentsRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 从 0 开始的页码。 / Zero-based page index.
+     */
+    current?: number;
+    /**
+     * 单页记录数。 / Number of records per page.
+     */
+    size?: number;
+    /**
+     * 排序字段列表。 / Ordered list of sort fields.
+     */
+    orderBy?: Array<string>;
+    /**
+     * 排序方向。 / Sort direction.
+     */
+    orderDirection?: ListConversationSubagentsOrderDirectionEnum;
+    /**
+     * 空值排序策略。 / Null ordering strategy.
+     */
+    orderNullHandling?: ListConversationSubagentsOrderNullHandlingEnum;
+    /**
+     * 标题或正文检索关键字。 / Title or content search keyword.
+     */
+    keyword?: string;
+    /**
+     * 状态过滤条件。 / Status filter.
+     */
+    status?: Array<string>;
+}
+export interface SyncConversationAsyncTasksRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 通知消息同步游标。 / Notification-message sync cursor.
+     */
+    afterMessageId?: string;
+    /**
+     * 单页记录数。 / Number of records per page.
+     */
+    size?: number;
+}
+export interface SyncConversationSubagentsRequest {
+    /**
+     * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
+     */
+    channelId: string;
+    /**
+     * 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     */
+    conversationId: string;
+    /**
+     * 子 Agent 状态同步游标。 / Subagent-state sync cursor.
+     */
+    cursor?: string;
+    /**
+     * 单页记录数。 / Number of records per page.
+     */
+    size?: number;
+}
 /**
  *
  */
 export declare class MessagesApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for cancelConversationSubagent without sending the request
+     */
+    cancelConversationSubagentRequestOpts(requestParameters: CancelConversationSubagentRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 取消当前会话下仍可取消的子 Agent 任务。  ### Use case Cancel a subagent task that is still cancellable under the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求取消任务并返回最新任务状态。  ### Behavior and side effects Requests cancellation and returns the latest task status.  ### 后续调用 读取返回状态，并继续同步其他任务。  ### Next step Use the returned status and continue syncing other tasks.  ### 接口摘要 取消子 Agent 任务 / Cancel a subagent task  ### Operation summary 取消子 Agent 任务 / Cancel a subagent task
+     * 取消子 Agent 任务 / Cancel a subagent task
+     */
+    cancelConversationSubagentRaw(requestParameters: CancelConversationSubagentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubagentTask>>;
+    /**
+     * ### 使用场景 取消当前会话下仍可取消的子 Agent 任务。  ### Use case Cancel a subagent task that is still cancellable under the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求取消任务并返回最新任务状态。  ### Behavior and side effects Requests cancellation and returns the latest task status.  ### 后续调用 读取返回状态，并继续同步其他任务。  ### Next step Use the returned status and continue syncing other tasks.  ### 接口摘要 取消子 Agent 任务 / Cancel a subagent task  ### Operation summary 取消子 Agent 任务 / Cancel a subagent task
+     * 取消子 Agent 任务 / Cancel a subagent task
+     */
+    cancelConversationSubagent(requestParameters: CancelConversationSubagentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubagentTask>;
     /**
      * Creates request options for cancelQueuedMessage without sending the request
      */
     cancelQueuedMessageRequestOpts(requestParameters: CancelQueuedMessageRequest): Promise<runtime.RequestOpts>;
     /**
-     * 取消排队消息 / Cancel a queued message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在消息尚未开始执行时取消排队。  ### Use case Cancel a message before execution begins.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 尝试把排队消息置为取消状态。  ### Behavior and side effects Attempts to move a queued message to cancelled state.  ### 后续调用 读取消息确认结果；执行中的消息改用 interrupt。  ### Next step Read the message to confirm; use interrupt for active execution.  ### 接口摘要 取消排队消息 / Cancel a queued message  ### Operation summary 取消排队消息 / Cancel a queued message
      * 取消排队消息 / Cancel a queued message
      */
     cancelQueuedMessageRaw(requestParameters: CancelQueuedMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationMessage>>;
     /**
-     * 取消排队消息 / Cancel a queued message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在消息尚未开始执行时取消排队。  ### Use case Cancel a message before execution begins.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 尝试把排队消息置为取消状态。  ### Behavior and side effects Attempts to move a queued message to cancelled state.  ### 后续调用 读取消息确认结果；执行中的消息改用 interrupt。  ### Next step Read the message to confirm; use interrupt for active execution.  ### 接口摘要 取消排队消息 / Cancel a queued message  ### Operation summary 取消排队消息 / Cancel a queued message
      * 取消排队消息 / Cancel a queued message
      */
     cancelQueuedMessage(requestParameters: CancelQueuedMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMessage>;
@@ -148,12 +286,12 @@ export declare class MessagesApi extends runtime.BaseAPI {
      */
     getConversationAsyncTaskRequestOpts(requestParameters: GetConversationAsyncTaskRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取异步任务 / Get an asynchronous task 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 查看单个异步任务的进度与输出。  ### Use case Inspect progress and output for one asynchronous task.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Consume output on completion and show explicit errors on failure.  ### 接口摘要 读取异步任务 / Get an asynchronous task  ### Operation summary 读取异步任务 / Get an asynchronous task
      * 读取异步任务 / Get an asynchronous task
      */
     getConversationAsyncTaskRaw(requestParameters: GetConversationAsyncTaskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AsyncTask>>;
     /**
-     * 读取异步任务 / Get an asynchronous task 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 查看单个异步任务的进度与输出。  ### Use case Inspect progress and output for one asynchronous task.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Consume output on completion and show explicit errors on failure.  ### 接口摘要 读取异步任务 / Get an asynchronous task  ### Operation summary 读取异步任务 / Get an asynchronous task
      * 读取异步任务 / Get an asynchronous task
      */
     getConversationAsyncTask(requestParameters: GetConversationAsyncTaskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AsyncTask>;
@@ -162,26 +300,54 @@ export declare class MessagesApi extends runtime.BaseAPI {
      */
     getConversationMessageRequestOpts(requestParameters: GetConversationMessageRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取单条会话消息 / Get a conversation message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复或审计单条消息的完整状态。  ### Use case Recover or audit the complete state of one message.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Read events, asynchronous tasks, or tool results according to status.  ### 接口摘要 读取单条会话消息 / Get a conversation message  ### Operation summary 读取单条会话消息 / Get a conversation message
      * 读取单条会话消息 / Get a conversation message
      */
     getConversationMessageRaw(requestParameters: GetConversationMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationMessage>>;
     /**
-     * 读取单条会话消息 / Get a conversation message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复或审计单条消息的完整状态。  ### Use case Recover or audit the complete state of one message.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Read events, asynchronous tasks, or tool results according to status.  ### 接口摘要 读取单条会话消息 / Get a conversation message  ### Operation summary 读取单条会话消息 / Get a conversation message
      * 读取单条会话消息 / Get a conversation message
      */
     getConversationMessage(requestParameters: GetConversationMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMessage>;
+    /**
+     * Creates request options for getConversationSubagent without sending the request
+     */
+    getConversationSubagentRequestOpts(requestParameters: GetConversationSubagentRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 读取当前会话下一个子 Agent 的状态和结果可用性。  ### Use case Read one subagent\'s status and result availability under the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 resultAvailable 为 true 时读取结果接口。  ### Next step Read the result endpoint when resultAvailable is true.  ### 接口摘要 读取子 Agent 状态 / Get a subagent task  ### Operation summary 读取子 Agent 状态 / Get a subagent task
+     * 读取子 Agent 状态 / Get a subagent task
+     */
+    getConversationSubagentRaw(requestParameters: GetConversationSubagentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubagentTask>>;
+    /**
+     * ### 使用场景 读取当前会话下一个子 Agent 的状态和结果可用性。  ### Use case Read one subagent\'s status and result availability under the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 resultAvailable 为 true 时读取结果接口。  ### Next step Read the result endpoint when resultAvailable is true.  ### 接口摘要 读取子 Agent 状态 / Get a subagent task  ### Operation summary 读取子 Agent 状态 / Get a subagent task
+     * 读取子 Agent 状态 / Get a subagent task
+     */
+    getConversationSubagent(requestParameters: GetConversationSubagentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubagentTask>;
+    /**
+     * Creates request options for getConversationSubagentResult without sending the request
+     */
+    getConversationSubagentResultRequestOpts(requestParameters: GetConversationSubagentResultRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 按需读取已完成子 Agent 的文本、文件和非文件制品。  ### Use case Read a completed subagent\'s text, file artifacts, and non-file artifacts on demand.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；完整结果仅通过该接口按需返回。  ### Behavior and side effects Read-only; the full result is returned only on demand through this endpoint.  ### 后续调用 按制品类型展示结果，并处理可恢复交付物。  ### Next step Display results by artifact type and handle recoverable deliverables.  ### 接口摘要 读取子 Agent 结果 / Get a subagent result  ### Operation summary 读取子 Agent 结果 / Get a subagent result
+     * 读取子 Agent 结果 / Get a subagent result
+     */
+    getConversationSubagentResultRaw(requestParameters: GetConversationSubagentResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubagentTaskResult>>;
+    /**
+     * ### 使用场景 按需读取已完成子 Agent 的文本、文件和非文件制品。  ### Use case Read a completed subagent\'s text, file artifacts, and non-file artifacts on demand.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；完整结果仅通过该接口按需返回。  ### Behavior and side effects Read-only; the full result is returned only on demand through this endpoint.  ### 后续调用 按制品类型展示结果，并处理可恢复交付物。  ### Next step Display results by artifact type and handle recoverable deliverables.  ### 接口摘要 读取子 Agent 结果 / Get a subagent result  ### Operation summary 读取子 Agent 结果 / Get a subagent result
+     * 读取子 Agent 结果 / Get a subagent result
+     */
+    getConversationSubagentResult(requestParameters: GetConversationSubagentResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubagentTaskResult>;
     /**
      * Creates request options for listConversationAsyncTasks without sending the request
      */
     listConversationAsyncTasksRequestOpts(requestParameters: ListConversationAsyncTasksRequest): Promise<runtime.RequestOpts>;
     /**
-     * 分页查询异步任务 / List asynchronous tasks 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看会话产生的长任务。  ### Use case List long-running tasks produced by a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Read and poll details for unfinished tasks.  ### 接口摘要 分页查询异步任务 / List asynchronous tasks  ### Operation summary 分页查询异步任务 / List asynchronous tasks
      * 分页查询异步任务 / List asynchronous tasks
      */
     listConversationAsyncTasksRaw(requestParameters: ListConversationAsyncTasksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AsyncTaskPage>>;
     /**
-     * 分页查询异步任务 / List asynchronous tasks 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看会话产生的长任务。  ### Use case List long-running tasks produced by a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### 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 Read and poll details for unfinished tasks.  ### 接口摘要 分页查询异步任务 / List asynchronous tasks  ### Operation summary 分页查询异步任务 / List asynchronous tasks
      * 分页查询异步任务 / List asynchronous tasks
      */
     listConversationAsyncTasks(requestParameters: ListConversationAsyncTasksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AsyncTaskPage>;
@@ -190,15 +356,57 @@ export declare class MessagesApi extends runtime.BaseAPI {
      */
     listConversationMessagesRequestOpts(requestParameters: ListConversationMessagesRequest): Promise<runtime.RequestOpts>;
     /**
-     * 分页查询会话消息 / List conversation messages 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页加载会话历史记录。  ### Use case Load conversation history page by page.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，返回消息分页。  ### Behavior and side effects Read-only and returns a message page.  ### 后续调用 选择消息后读取详情或事件。  ### Next step Read message detail or events after selection.  ### 接口摘要 分页查询会话消息 / List conversation messages  ### Operation summary 分页查询会话消息 / List conversation messages
      * 分页查询会话消息 / List conversation messages
      */
     listConversationMessagesRaw(requestParameters: ListConversationMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationMessagePage>>;
     /**
-     * 分页查询会话消息 / List conversation messages 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页加载会话历史记录。  ### Use case Load conversation history page by page.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，返回消息分页。  ### Behavior and side effects Read-only and returns a message page.  ### 后续调用 选择消息后读取详情或事件。  ### Next step Read message detail or events after selection.  ### 接口摘要 分页查询会话消息 / List conversation messages  ### Operation summary 分页查询会话消息 / List conversation messages
      * 分页查询会话消息 / List conversation messages
      */
     listConversationMessages(requestParameters: ListConversationMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMessagePage>;
+    /**
+     * Creates request options for listConversationSubagents without sending the request
+     */
+    listConversationSubagentsRequestOpts(requestParameters: ListConversationSubagentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 分页查看当前会话创建的子 Agent 任务。  ### Use case List subagent tasks created by the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；返回任务状态分页。  ### Behavior and side effects Read-only; returns a paged task status list.  ### 后续调用 读取单个任务详情，或同步状态变化。  ### Next step Read an individual task or synchronize status changes.  ### 接口摘要 分页查询子 Agent 任务 / List subagent tasks  ### Operation summary 分页查询子 Agent 任务 / List subagent tasks
+     * 分页查询子 Agent 任务 / List subagent tasks
+     */
+    listConversationSubagentsRaw(requestParameters: ListConversationSubagentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubagentTaskPage>>;
+    /**
+     * ### 使用场景 分页查看当前会话创建的子 Agent 任务。  ### Use case List subagent tasks created by the current conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；返回任务状态分页。  ### Behavior and side effects Read-only; returns a paged task status list.  ### 后续调用 读取单个任务详情，或同步状态变化。  ### Next step Read an individual task or synchronize status changes.  ### 接口摘要 分页查询子 Agent 任务 / List subagent tasks  ### Operation summary 分页查询子 Agent 任务 / List subagent tasks
+     * 分页查询子 Agent 任务 / List subagent tasks
+     */
+    listConversationSubagents(requestParameters: ListConversationSubagentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubagentTaskPage>;
+    /**
+     * Creates request options for syncConversationAsyncTasks without sending the request
+     */
+    syncConversationAsyncTasksRequestOpts(requestParameters: SyncConversationAsyncTasksRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 增量读取活动异步任务和游标之后的通知消息。  ### Use case Incrementally read active asynchronous tasks and notification messages after a cursor.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；返回活动任务、通知消息和下一消息游标。  ### Behavior and side effects Read-only; returns active tasks, notification messages, and the next message cursor.  ### 后续调用 保存 nextMessageId；pollingRequired 为 true 时继续同步。  ### Next step Save nextMessageId and continue syncing when pollingRequired is true.  ### 接口摘要 增量同步异步任务 / Sync asynchronous task updates  ### Operation summary 增量同步异步任务 / Sync asynchronous task updates
+     * 增量同步异步任务 / Sync asynchronous task updates
+     */
+    syncConversationAsyncTasksRaw(requestParameters: SyncConversationAsyncTasksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentAsyncTaskSync>>;
+    /**
+     * ### 使用场景 增量读取活动异步任务和游标之后的通知消息。  ### Use case Incrementally read active asynchronous tasks and notification messages after a cursor.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；返回活动任务、通知消息和下一消息游标。  ### Behavior and side effects Read-only; returns active tasks, notification messages, and the next message cursor.  ### 后续调用 保存 nextMessageId；pollingRequired 为 true 时继续同步。  ### Next step Save nextMessageId and continue syncing when pollingRequired is true.  ### 接口摘要 增量同步异步任务 / Sync asynchronous task updates  ### Operation summary 增量同步异步任务 / Sync asynchronous task updates
+     * 增量同步异步任务 / Sync asynchronous task updates
+     */
+    syncConversationAsyncTasks(requestParameters: SyncConversationAsyncTasksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentAsyncTaskSync>;
+    /**
+     * Creates request options for syncConversationSubagents without sending the request
+     */
+    syncConversationSubagentsRequestOpts(requestParameters: SyncConversationSubagentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * ### 使用场景 通过游标增量读取子 Agent 状态和未读终态结果。  ### Use case Incrementally read subagent status changes and unread terminal results using a cursor.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；游标应原样保存并用于下一次同步。  ### Behavior and side effects Read-only; preserve the cursor unchanged for the next sync.  ### 后续调用 保存 nextCursor；pollingRequired 为 true 时继续同步。  ### Next step Save nextCursor and continue syncing when pollingRequired is true.  ### 接口摘要 增量同步子 Agent 状态 / Sync subagent task updates  ### Operation summary 增量同步子 Agent 状态 / Sync subagent task updates
+     * 增量同步子 Agent 状态 / Sync subagent task updates
+     */
+    syncConversationSubagentsRaw(requestParameters: SyncConversationSubagentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubagentTaskSync>>;
+    /**
+     * ### 使用场景 通过游标增量读取子 Agent 状态和未读终态结果。  ### Use case Incrementally read subagent status changes and unread terminal results using a cursor.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读；游标应原样保存并用于下一次同步。  ### Behavior and side effects Read-only; preserve the cursor unchanged for the next sync.  ### 后续调用 保存 nextCursor；pollingRequired 为 true 时继续同步。  ### Next step Save nextCursor and continue syncing when pollingRequired is true.  ### 接口摘要 增量同步子 Agent 状态 / Sync subagent task updates  ### Operation summary 增量同步子 Agent 状态 / Sync subagent task updates
+     * 增量同步子 Agent 状态 / Sync subagent task updates
+     */
+    syncConversationSubagents(requestParameters: SyncConversationSubagentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubagentTaskSync>;
 }
 /**
  * @export
@@ -234,3 +442,20 @@ export declare const ListConversationMessagesOrderNullHandlingEnum: {
     readonly NullsLast: "NULLS_LAST";
 };
 export type ListConversationMessagesOrderNullHandlingEnum = typeof ListConversationMessagesOrderNullHandlingEnum[keyof typeof ListConversationMessagesOrderNullHandlingEnum];
+/**
+ * @export
+ */
+export declare const ListConversationSubagentsOrderDirectionEnum: {
+    readonly Asc: "ASC";
+    readonly Desc: "DESC";
+};
+export type ListConversationSubagentsOrderDirectionEnum = typeof ListConversationSubagentsOrderDirectionEnum[keyof typeof ListConversationSubagentsOrderDirectionEnum];
+/**
+ * @export
+ */
+export declare const ListConversationSubagentsOrderNullHandlingEnum: {
+    readonly Native: "NATIVE";
+    readonly NullsFirst: "NULLS_FIRST";
+    readonly NullsLast: "NULLS_LAST";
+};
+export type ListConversationSubagentsOrderNullHandlingEnum = typeof ListConversationSubagentsOrderNullHandlingEnum[keyof typeof ListConversationSubagentsOrderNullHandlingEnum];