@lingya-ai/agents-sdk 0.4.0 → 0.5.0

package/dist/esm/apis/SQLApi.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,8 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { SqlChartDataset, SqlQueryResultPage } from '../models/index';
+import { type SqlChartDataset } from '../models/SqlChartDataset';
+import { type SqlQueryResultPage } from '../models/SqlQueryResultPage';
 export interface ExportSqlQueryResultRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -78,12 +79,12 @@ export declare class SQLApi extends runtime.BaseAPI {
      */
     exportSqlQueryResultRequestOpts(requestParameters: ExportSqlQueryResultRequest): Promise<runtime.RequestOpts>;
     /**
-     * 导出 SQL 结果 / Export SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 把完整 SQL 结果下载为 CSV 或 XLSX。  ### Use case Download the complete SQL result as CSV or XLSX.  ### 前置条件 resultId 有效，format 与 Accept 匹配。  ### Prerequisites The resultId is valid and format matches Accept.  ### 行为与副作用 返回二进制下载流。  ### Behavior and side effects Returns a binary download stream.  ### 后续调用 按 Content-Disposition 保存文件，不要解析为 JSON。  ### Next step Save using Content-Disposition and do not parse as JSON.  ### 接口摘要 导出 SQL 结果 / Export SQL results  ### Operation summary 导出 SQL 结果 / Export SQL results
      * 导出 SQL 结果 / Export SQL results
      */
     exportSqlQueryResultRaw(requestParameters: ExportSqlQueryResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
     /**
-     * 导出 SQL 结果 / Export SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 把完整 SQL 结果下载为 CSV 或 XLSX。  ### Use case Download the complete SQL result as CSV or XLSX.  ### 前置条件 resultId 有效，format 与 Accept 匹配。  ### Prerequisites The resultId is valid and format matches Accept.  ### 行为与副作用 返回二进制下载流。  ### Behavior and side effects Returns a binary download stream.  ### 后续调用 按 Content-Disposition 保存文件，不要解析为 JSON。  ### Next step Save using Content-Disposition and do not parse as JSON.  ### 接口摘要 导出 SQL 结果 / Export SQL results  ### Operation summary 导出 SQL 结果 / Export SQL results
      * 导出 SQL 结果 / Export SQL results
      */
     exportSqlQueryResult(requestParameters: ExportSqlQueryResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
@@ -92,12 +93,12 @@ export declare class SQLApi extends runtime.BaseAPI {
      */
     getSqlQueryChartDataRequestOpts(requestParameters: GetSqlQueryChartDataRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取 SQL 图表数据 / Get SQL chart data 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 取得适合前端图表渲染的 SQL 数据集。  ### Use case Obtain a SQL dataset prepared for chart rendering.  ### 前置条件 resultId 对应可图表化的 SQL 结果。  ### Prerequisites The resultId identifies a chartable SQL result.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 按返回的列类型构建图表。  ### Next step Build charts using the returned column types.  ### 接口摘要 读取 SQL 图表数据 / Get SQL chart data  ### Operation summary 读取 SQL 图表数据 / Get SQL chart data
      * 读取 SQL 图表数据 / Get SQL chart data
      */
     getSqlQueryChartDataRaw(requestParameters: GetSqlQueryChartDataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SqlChartDataset>>;
     /**
-     * 读取 SQL 图表数据 / Get SQL chart data 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 取得适合前端图表渲染的 SQL 数据集。  ### Use case Obtain a SQL dataset prepared for chart rendering.  ### 前置条件 resultId 对应可图表化的 SQL 结果。  ### Prerequisites The resultId identifies a chartable SQL result.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 按返回的列类型构建图表。  ### Next step Build charts using the returned column types.  ### 接口摘要 读取 SQL 图表数据 / Get SQL chart data  ### Operation summary 读取 SQL 图表数据 / Get SQL chart data
      * 读取 SQL 图表数据 / Get SQL chart data
      */
     getSqlQueryChartData(requestParameters: GetSqlQueryChartDataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SqlChartDataset>;
@@ -106,12 +107,12 @@ export declare class SQLApi extends runtime.BaseAPI {
      */
     getSqlQueryResultRequestOpts(requestParameters: GetSqlQueryResultRequest): Promise<runtime.RequestOpts>;
     /**
-     * 分页读取 SQL 结果 / Get paged SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看 SQL 工具返回的表格数据。  ### Use case Inspect tabular data returned by the SQL tool page by page.  ### 前置条件 从事件或消息中取得 conversationId 和 resultId。  ### Prerequisites Obtain conversationId and resultId from an event or message.  ### 行为与副作用 只读，返回当前页和列定义。  ### Behavior and side effects Read-only and returns a page plus column definitions.  ### 后续调用 按需读取图表数据或导出。  ### Next step Read chart data or export as needed.  ### 接口摘要 分页读取 SQL 结果 / Get paged SQL results  ### Operation summary 分页读取 SQL 结果 / Get paged SQL results
      * 分页读取 SQL 结果 / Get paged SQL results
      */
     getSqlQueryResultRaw(requestParameters: GetSqlQueryResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SqlQueryResultPage>>;
     /**
-     * 分页读取 SQL 结果 / Get paged SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看 SQL 工具返回的表格数据。  ### Use case Inspect tabular data returned by the SQL tool page by page.  ### 前置条件 从事件或消息中取得 conversationId 和 resultId。  ### Prerequisites Obtain conversationId and resultId from an event or message.  ### 行为与副作用 只读，返回当前页和列定义。  ### Behavior and side effects Read-only and returns a page plus column definitions.  ### 后续调用 按需读取图表数据或导出。  ### Next step Read chart data or export as needed.  ### 接口摘要 分页读取 SQL 结果 / Get paged SQL results  ### Operation summary 分页读取 SQL 结果 / Get paged SQL results
      * 分页读取 SQL 结果 / Get paged SQL results
      */
     getSqlQueryResult(requestParameters: GetSqlQueryResultRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SqlQueryResultPage>;

package/dist/esm/apis/SQLApi.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.
+ * 本契约描述灵涯 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).
@@ -21,6 +21,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { SqlChartDatasetFromJSON, } from '../models/SqlChartDataset';
+import { SqlQueryResultPageFromJSON, } from '../models/SqlQueryResultPage';
 /**
  *
  */
@@ -78,7 +80,7 @@ export class SQLApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 导出 SQL 结果 / Export SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 把完整 SQL 结果下载为 CSV 或 XLSX。  ### Use case Download the complete SQL result as CSV or XLSX.  ### 前置条件 resultId 有效，format 与 Accept 匹配。  ### Prerequisites The resultId is valid and format matches Accept.  ### 行为与副作用 返回二进制下载流。  ### Behavior and side effects Returns a binary download stream.  ### 后续调用 按 Content-Disposition 保存文件，不要解析为 JSON。  ### Next step Save using Content-Disposition and do not parse as JSON.  ### 接口摘要 导出 SQL 结果 / Export SQL results  ### Operation summary 导出 SQL 结果 / Export SQL results
      * 导出 SQL 结果 / Export SQL results
      */
     exportSqlQueryResultRaw(requestParameters, initOverrides) {
@@ -89,7 +91,7 @@ export class SQLApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 导出 SQL 结果 / Export SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 把完整 SQL 结果下载为 CSV 或 XLSX。  ### Use case Download the complete SQL result as CSV or XLSX.  ### 前置条件 resultId 有效，format 与 Accept 匹配。  ### Prerequisites The resultId is valid and format matches Accept.  ### 行为与副作用 返回二进制下载流。  ### Behavior and side effects Returns a binary download stream.  ### 后续调用 按 Content-Disposition 保存文件，不要解析为 JSON。  ### Next step Save using Content-Disposition and do not parse as JSON.  ### 接口摘要 导出 SQL 结果 / Export SQL results  ### Operation summary 导出 SQL 结果 / Export SQL results
      * 导出 SQL 结果 / Export SQL results
      */
     exportSqlQueryResult(requestParameters, initOverrides) {
@@ -142,18 +144,18 @@ export class SQLApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取 SQL 图表数据 / Get SQL chart data 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 取得适合前端图表渲染的 SQL 数据集。  ### Use case Obtain a SQL dataset prepared for chart rendering.  ### 前置条件 resultId 对应可图表化的 SQL 结果。  ### Prerequisites The resultId identifies a chartable SQL result.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 按返回的列类型构建图表。  ### Next step Build charts using the returned column types.  ### 接口摘要 读取 SQL 图表数据 / Get SQL chart data  ### Operation summary 读取 SQL 图表数据 / Get SQL chart data
      * 读取 SQL 图表数据 / Get SQL chart data
      */
     getSqlQueryChartDataRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getSqlQueryChartDataRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SqlChartDatasetFromJSON(jsonValue));
         });
     }
     /**
-     * 读取 SQL 图表数据 / Get SQL chart data 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 取得适合前端图表渲染的 SQL 数据集。  ### Use case Obtain a SQL dataset prepared for chart rendering.  ### 前置条件 resultId 对应可图表化的 SQL 结果。  ### Prerequisites The resultId identifies a chartable SQL result.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 按返回的列类型构建图表。  ### Next step Build charts using the returned column types.  ### 接口摘要 读取 SQL 图表数据 / Get SQL chart data  ### Operation summary 读取 SQL 图表数据 / Get SQL chart data
      * 读取 SQL 图表数据 / Get SQL chart data
      */
     getSqlQueryChartData(requestParameters, initOverrides) {
@@ -212,18 +214,18 @@ export class SQLApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 分页读取 SQL 结果 / Get paged SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看 SQL 工具返回的表格数据。  ### Use case Inspect tabular data returned by the SQL tool page by page.  ### 前置条件 从事件或消息中取得 conversationId 和 resultId。  ### Prerequisites Obtain conversationId and resultId from an event or message.  ### 行为与副作用 只读，返回当前页和列定义。  ### Behavior and side effects Read-only and returns a page plus column definitions.  ### 后续调用 按需读取图表数据或导出。  ### Next step Read chart data or export as needed.  ### 接口摘要 分页读取 SQL 结果 / Get paged SQL results  ### Operation summary 分页读取 SQL 结果 / Get paged SQL results
      * 分页读取 SQL 结果 / Get paged SQL results
      */
     getSqlQueryResultRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getSqlQueryResultRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SqlQueryResultPageFromJSON(jsonValue));
         });
     }
     /**
-     * 分页读取 SQL 结果 / Get paged SQL results 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页查看 SQL 工具返回的表格数据。  ### Use case Inspect tabular data returned by the SQL tool page by page.  ### 前置条件 从事件或消息中取得 conversationId 和 resultId。  ### Prerequisites Obtain conversationId and resultId from an event or message.  ### 行为与副作用 只读，返回当前页和列定义。  ### Behavior and side effects Read-only and returns a page plus column definitions.  ### 后续调用 按需读取图表数据或导出。  ### Next step Read chart data or export as needed.  ### 接口摘要 分页读取 SQL 结果 / Get paged SQL results  ### Operation summary 分页读取 SQL 结果 / Get paged SQL results
      * 分页读取 SQL 结果 / Get paged SQL results
      */
     getSqlQueryResult(requestParameters, initOverrides) {

package/dist/esm/apis/WorkspaceApi.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,8 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { PreSignedReadUrl, WorkspaceArtifactList } from '../models/index';
+import { type PreSignedReadUrl } from '../models/PreSignedReadUrl';
+import { type WorkspaceArtifactList } from '../models/WorkspaceArtifactList';
 export interface GetWorkspaceFilePreviewRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -72,12 +73,12 @@ export declare class WorkspaceApi extends runtime.BaseAPI {
      */
     getWorkspaceFilePreviewRequestOpts(requestParameters: GetWorkspaceFilePreviewRequest): Promise<runtime.RequestOpts>;
     /**
-     * 创建工作区文件预览地址 / Create a workspace file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为工作区中的具体文件创建预览地址。  ### Use case Create a preview URL for a specific workspace file.  ### 前置条件 path 来自工作区列表且属于当前会话。  ### Prerequisites The path comes from the workspace list and belongs to the conversation.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL。  ### Next step Use the URL before it expires.  ### 接口摘要 创建工作区文件预览地址 / Create a workspace file preview URL  ### Operation summary 创建工作区文件预览地址 / Create a workspace file preview URL
      * 创建工作区文件预览地址 / Create a workspace file preview URL
      */
     getWorkspaceFilePreviewRaw(requestParameters: GetWorkspaceFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PreSignedReadUrl>>;
     /**
-     * 创建工作区文件预览地址 / Create a workspace file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为工作区中的具体文件创建预览地址。  ### Use case Create a preview URL for a specific workspace file.  ### 前置条件 path 来自工作区列表且属于当前会话。  ### Prerequisites The path comes from the workspace list and belongs to the conversation.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL。  ### Next step Use the URL before it expires.  ### 接口摘要 创建工作区文件预览地址 / Create a workspace file preview URL  ### Operation summary 创建工作区文件预览地址 / Create a workspace file preview URL
      * 创建工作区文件预览地址 / Create a workspace file preview URL
      */
     getWorkspaceFilePreview(requestParameters: GetWorkspaceFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PreSignedReadUrl>;
@@ -86,12 +87,12 @@ export declare class WorkspaceApi extends runtime.BaseAPI {
      */
     listWorkspaceArtifactsRequestOpts(requestParameters: ListWorkspaceArtifactsRequest): Promise<runtime.RequestOpts>;
     /**
-     * 分页查询工作区制品 / List workspace artifacts 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页浏览会话工作区中的生成制品。  ### Use case Browse generated artifacts in a conversation workspace 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 file and non-file artifacts.  ### 后续调用 对文件路径请求预览，或展示非文件制品。  ### Next step Request previews for file paths or display non-file artifacts.  ### 接口摘要 分页查询工作区制品 / List workspace artifacts  ### Operation summary 分页查询工作区制品 / List workspace artifacts
      * 分页查询工作区制品 / List workspace artifacts
      */
     listWorkspaceArtifactsRaw(requestParameters: ListWorkspaceArtifactsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkspaceArtifactList>>;
     /**
-     * 分页查询工作区制品 / List workspace artifacts 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页浏览会话工作区中的生成制品。  ### Use case Browse generated artifacts in a conversation workspace 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 file and non-file artifacts.  ### 后续调用 对文件路径请求预览，或展示非文件制品。  ### Next step Request previews for file paths or display non-file artifacts.  ### 接口摘要 分页查询工作区制品 / List workspace artifacts  ### Operation summary 分页查询工作区制品 / List workspace artifacts
      * 分页查询工作区制品 / List workspace artifacts
      */
     listWorkspaceArtifacts(requestParameters: ListWorkspaceArtifactsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkspaceArtifactList>;

package/dist/esm/apis/WorkspaceApi.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.
+ * 本契约描述灵涯 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).
@@ -21,6 +21,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { PreSignedReadUrlFromJSON, } from '../models/PreSignedReadUrl';
+import { WorkspaceArtifactListFromJSON, } from '../models/WorkspaceArtifactList';
 /**
  *
  */
@@ -71,18 +73,18 @@ export class WorkspaceApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 创建工作区文件预览地址 / Create a workspace file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为工作区中的具体文件创建预览地址。  ### Use case Create a preview URL for a specific workspace file.  ### 前置条件 path 来自工作区列表且属于当前会话。  ### Prerequisites The path comes from the workspace list and belongs to the conversation.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL。  ### Next step Use the URL before it expires.  ### 接口摘要 创建工作区文件预览地址 / Create a workspace file preview URL  ### Operation summary 创建工作区文件预览地址 / Create a workspace file preview URL
      * 创建工作区文件预览地址 / Create a workspace file preview URL
      */
     getWorkspaceFilePreviewRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getWorkspaceFilePreviewRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PreSignedReadUrlFromJSON(jsonValue));
         });
     }
     /**
-     * 创建工作区文件预览地址 / Create a workspace file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为工作区中的具体文件创建预览地址。  ### Use case Create a preview URL for a specific workspace file.  ### 前置条件 path 来自工作区列表且属于当前会话。  ### Prerequisites The path comes from the workspace list and belongs to the conversation.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL。  ### Next step Use the URL before it expires.  ### 接口摘要 创建工作区文件预览地址 / Create a workspace file preview URL  ### Operation summary 创建工作区文件预览地址 / Create a workspace file preview URL
      * 创建工作区文件预览地址 / Create a workspace file preview URL
      */
     getWorkspaceFilePreview(requestParameters, initOverrides) {
@@ -152,18 +154,18 @@ export class WorkspaceApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 分页查询工作区制品 / List workspace artifacts 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页浏览会话工作区中的生成制品。  ### Use case Browse generated artifacts in a conversation workspace 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 file and non-file artifacts.  ### 后续调用 对文件路径请求预览，或展示非文件制品。  ### Next step Request previews for file paths or display non-file artifacts.  ### 接口摘要 分页查询工作区制品 / List workspace artifacts  ### Operation summary 分页查询工作区制品 / List workspace artifacts
      * 分页查询工作区制品 / List workspace artifacts
      */
     listWorkspaceArtifactsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.listWorkspaceArtifactsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => WorkspaceArtifactListFromJSON(jsonValue));
         });
     }
     /**
-     * 分页查询工作区制品 / List workspace artifacts 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 分页浏览会话工作区中的生成制品。  ### Use case Browse generated artifacts in a conversation workspace 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 file and non-file artifacts.  ### 后续调用 对文件路径请求预览，或展示非文件制品。  ### Next step Request previews for file paths or display non-file artifacts.  ### 接口摘要 分页查询工作区制品 / List workspace artifacts  ### Operation summary 分页查询工作区制品 / List workspace artifacts
      * 分页查询工作区制品 / List workspace artifacts
      */
     listWorkspaceArtifacts(requestParameters, initOverrides) {

package/dist/esm/bound.d.ts

@@ -1,4 +1,4 @@
-import { ConfigurationApi as GeneratedConfigurationApi, ChatApi as GeneratedChatApi, ConversationsApi as GeneratedConversationsApi, SQLApi as GeneratedSQLApi, MessagesApi as GeneratedMessagesApi, EventsApi as GeneratedEventsApi, InteractionsApi as GeneratedInteractionsApi, FilesApi as GeneratedFilesApi, KnowledgeApi as GeneratedKnowledgeApi, WorkspaceApi as GeneratedWorkspaceApi, type GetConversationConfigRequest, type CreateChatRequest, type ContinueChatRequest, type DeleteConversationRequest, type StreamChatEventsRequest, type ProbeEventStreamRequest, type InterruptConversationRequest, type CompactConversationRequest, type GetConversationContextUsageRequest, type ListConversationsRequest, type QueryConversationActivitiesRequest, type MarkConversationReadRequest, type GetConversationTitleRequest, type UpdateConversationTitleRequest, type UpdateConversationStatusRequest, type GetSqlQueryResultRequest, type GetSqlQueryChartDataRequest, type ExportSqlQueryResultRequest, type ListConversationMessagesRequest, type GetConversationMessageRequest, type ListConversationAsyncTasksRequest, type GetConversationAsyncTaskRequest, type CancelQueuedMessageRequest, type GetChatEventsRequest, type GetChatEventsBatchRequest, type ListConversationSharesRequest, type CreateConversationShareRequest, type RevokeConversationShareRequest, type ApprovePlanRequest, type GetPlanStatusRequest, type GetUserInputStatusRequest, type AnswerUserInputRequest, type CreatePreSignedUploadRequest, type ConfirmPreSignedUploadRequest, type CreateFileByContentMd5Request, type FileExistsByContentMd5Request, type GetConversationFilePreviewRequest, type GetPlanIntermediateFilePreviewRequest, type GetCitationMetadataBatchRequest, type GetCitationMetadataRequest, type ListWorkspaceArtifactsRequest, type GetWorkspaceFilePreviewRequest } from './apis';
+import { ConfigurationApi as GeneratedConfigurationApi, ChatApi as GeneratedChatApi, ConversationsApi as GeneratedConversationsApi, SQLApi as GeneratedSQLApi, MessagesApi as GeneratedMessagesApi, EventsApi as GeneratedEventsApi, InteractionsApi as GeneratedInteractionsApi, FilesApi as GeneratedFilesApi, KnowledgeApi as GeneratedKnowledgeApi, WorkspaceApi as GeneratedWorkspaceApi, type GetConversationConfigRequest, type CreateChatRequest, type ContinueChatRequest, type DeleteConversationRequest, type StreamChatEventsRequest, type ProbeEventStreamRequest, type InterruptConversationRequest, type CompactConversationRequest, type GetConversationContextUsageRequest, type ListConversationsRequest, type QueryConversationActivitiesRequest, type MarkConversationReadRequest, type GetConversationTitleRequest, type UpdateConversationTitleRequest, type UpdateConversationStatusRequest, type GetSqlQueryResultRequest, type GetSqlQueryChartDataRequest, type ExportSqlQueryResultRequest, type ListConversationMessagesRequest, type GetConversationMessageRequest, type ListConversationAsyncTasksRequest, type SyncConversationAsyncTasksRequest, type GetConversationAsyncTaskRequest, type ListConversationSubagentsRequest, type SyncConversationSubagentsRequest, type GetConversationSubagentRequest, type CancelConversationSubagentRequest, type GetConversationSubagentResultRequest, type CancelQueuedMessageRequest, type GetChatEventsRequest, type GetChatEventsBatchRequest, type ListConversationSharesRequest, type CreateConversationShareRequest, type RevokeConversationShareRequest, type ApprovePlanRequest, type GetPlanStatusRequest, type GetUserInputStatusRequest, type AnswerUserInputRequest, type CreatePreSignedUploadRequest, type ConfirmPreSignedUploadRequest, type CreateFileByContentMd5Request, type FileExistsByContentMd5Request, type GetConversationFilePreviewRequest, type GetPlanIntermediateFilePreviewRequest, type GetCitationMetadataBatchRequest, type GetCitationMetadataRequest, type ListWorkspaceArtifactsRequest, type GetWorkspaceFilePreviewRequest } from './apis';
 import { type ChatStreamProbeEvent } from './models/ChatStreamProbeEvent';
 import { type AiChatBriefEvent } from './events';
 type BoundRawRequest = (method: string, suffix: string, bodyJson: string | undefined, query: URLSearchParams | undefined, accept: string, requestId?: string) => Promise<Response>;
@@ -19,6 +19,12 @@ export type ListConversationMessagesOptions = Omit<ListConversationMessagesReque
 /** Query values and optional request headers that are not bound by the client. */
 export type ListConversationAsyncTasksOptions = Omit<ListConversationAsyncTasksRequest, 'channelId' | 'conversationId'>;
 /** Query values and optional request headers that are not bound by the client. */
+export type SyncConversationAsyncTasksOptions = Omit<SyncConversationAsyncTasksRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationSubagentsOptions = Omit<ListConversationSubagentsRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type SyncConversationSubagentsOptions = Omit<SyncConversationSubagentsRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
 export type GetChatEventsOptions = Omit<GetChatEventsRequest, 'channelId'>;
 /** Query values and optional request headers that are not bound by the client. */
 export type GetUserInputStatusOptions = Omit<GetUserInputStatusRequest, 'channelId' | 'questionId'>;
@@ -282,6 +288,14 @@ export declare class MessagesApi {
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
     listConversationAsyncTasks(conversationId: ListConversationAsyncTasksRequest['conversationId'], options?: ListConversationAsyncTasksOptions): ReturnType<GeneratedMessagesApi['listConversationAsyncTasks']>;
+    /**
+     * 增量同步异步任务 / Sync asynchronous task updates
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    syncConversationAsyncTasks(conversationId: SyncConversationAsyncTasksRequest['conversationId'], options?: SyncConversationAsyncTasksOptions): ReturnType<GeneratedMessagesApi['syncConversationAsyncTasks']>;
     /**
      * 读取异步任务 / Get an asynchronous task
      *
@@ -290,6 +304,46 @@ export declare class MessagesApi {
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
     getConversationAsyncTask(conversationId: GetConversationAsyncTaskRequest['conversationId'], asyncTaskId: GetConversationAsyncTaskRequest['asyncTaskId']): ReturnType<GeneratedMessagesApi['getConversationAsyncTask']>;
+    /**
+     * 分页查询子 Agent 任务 / List subagent tasks
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversationSubagents(conversationId: ListConversationSubagentsRequest['conversationId'], options?: ListConversationSubagentsOptions): ReturnType<GeneratedMessagesApi['listConversationSubagents']>;
+    /**
+     * 增量同步子 Agent 状态 / Sync subagent task updates
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    syncConversationSubagents(conversationId: SyncConversationSubagentsRequest['conversationId'], options?: SyncConversationSubagentsOptions): ReturnType<GeneratedMessagesApi['syncConversationSubagents']>;
+    /**
+     * 读取子 Agent 状态 / Get a subagent task
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationSubagent(conversationId: GetConversationSubagentRequest['conversationId'], subagentTaskId: GetConversationSubagentRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['getConversationSubagent']>;
+    /**
+     * 取消子 Agent 任务 / Cancel a subagent task
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    cancelConversationSubagent(conversationId: CancelConversationSubagentRequest['conversationId'], subagentTaskId: CancelConversationSubagentRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['cancelConversationSubagent']>;
+    /**
+     * 读取子 Agent 结果 / Get a subagent result
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationSubagentResult(conversationId: GetConversationSubagentResultRequest['conversationId'], subagentTaskId: GetConversationSubagentResultRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['getConversationSubagentResult']>;
     /**
      * 取消排队消息 / Cancel a queued message
      *

package/dist/esm/bound.js

@@ -391,6 +391,16 @@ export class MessagesApi {
     listConversationAsyncTasks(conversationId, options = {}) {
         return this.delegate.listConversationAsyncTasks(Object.assign({ channelId: this.channelId, conversationId }, options));
     }
+    /**
+     * 增量同步异步任务 / Sync asynchronous task updates
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    syncConversationAsyncTasks(conversationId, options = {}) {
+        return this.delegate.syncConversationAsyncTasks(Object.assign({ channelId: this.channelId, conversationId }, options));
+    }
     /**
      * 读取异步任务 / Get an asynchronous task
      *
@@ -401,6 +411,56 @@ export class MessagesApi {
     getConversationAsyncTask(conversationId, asyncTaskId) {
         return this.delegate.getConversationAsyncTask({ channelId: this.channelId, conversationId, asyncTaskId });
     }
+    /**
+     * 分页查询子 Agent 任务 / List subagent tasks
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversationSubagents(conversationId, options = {}) {
+        return this.delegate.listConversationSubagents(Object.assign({ channelId: this.channelId, conversationId }, options));
+    }
+    /**
+     * 增量同步子 Agent 状态 / Sync subagent task updates
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    syncConversationSubagents(conversationId, options = {}) {
+        return this.delegate.syncConversationSubagents(Object.assign({ channelId: this.channelId, conversationId }, options));
+    }
+    /**
+     * 读取子 Agent 状态 / Get a subagent task
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationSubagent(conversationId, subagentTaskId) {
+        return this.delegate.getConversationSubagent({ channelId: this.channelId, conversationId, subagentTaskId });
+    }
+    /**
+     * 取消子 Agent 任务 / Cancel a subagent task
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    cancelConversationSubagent(conversationId, subagentTaskId) {
+        return this.delegate.cancelConversationSubagent({ channelId: this.channelId, conversationId, subagentTaskId });
+    }
+    /**
+     * 读取子 Agent 结果 / Get a subagent result
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationSubagentResult(conversationId, subagentTaskId) {
+        return this.delegate.getConversationSubagentResult({ channelId: this.channelId, conversationId, subagentTaskId });
+    }
     /**
      * 取消排队消息 / Cancel a queued message
      *

package/dist/esm/models/AgentAsyncTaskSync.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ *
+ * The version of the OpenAPI document: 0.1.5
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { ConversationMessage } from './ConversationMessage';
+import type { AsyncTask } from './AsyncTask';
+/**
+ * AgentAsyncTaskSync 的公开协议结构。 / Public contract for agent async task sync.
+ * @export
+ * @interface AgentAsyncTaskSync
+ */
+export interface AgentAsyncTaskSync {
+    /**
+     * 字段 activeTasks / active tasks field。
+     */
+    activeTasks: Array<AsyncTask>;
+    /**
+     * 字段 notificationMessages / notification messages field。
+     */
+    notificationMessages: Array<ConversationMessage>;
+    /**
+     * 字段 nextMessageId / next message id field。
+     */
+    nextMessageId: string | null;
+    /**
+     * 字段 hasMore / has more field。
+     */
+    hasMore: boolean;
+    /**
+     * 字段 pollingRequired / polling required field。
+     */
+    pollingRequired: boolean;
+}
+/**
+ * Check if a given object implements the AgentAsyncTaskSync interface.
+ */
+export declare function instanceOfAgentAsyncTaskSync(value: object): value is AgentAsyncTaskSync;
+export declare function AgentAsyncTaskSyncFromJSON(json: any): AgentAsyncTaskSync;
+export declare function AgentAsyncTaskSyncFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentAsyncTaskSync;
+export declare function AgentAsyncTaskSyncToJSON(json: any): AgentAsyncTaskSync;
+export declare function AgentAsyncTaskSyncToJSONTyped(value?: AgentAsyncTaskSync | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/AgentAsyncTaskSync.js

@@ -0,0 +1,61 @@
+/* tslint:disable */
+/* 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.
+ *
+ * The version of the OpenAPI document: 0.1.5
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { ConversationMessageFromJSON, ConversationMessageToJSON, } from './ConversationMessage';
+import { AsyncTaskFromJSON, AsyncTaskToJSON, } from './AsyncTask';
+/**
+ * Check if a given object implements the AgentAsyncTaskSync interface.
+ */
+export function instanceOfAgentAsyncTaskSync(value) {
+    if (!('activeTasks' in value) || value['activeTasks'] === undefined)
+        return false;
+    if (!('notificationMessages' in value) || value['notificationMessages'] === undefined)
+        return false;
+    if (!('nextMessageId' in value) || value['nextMessageId'] === undefined)
+        return false;
+    if (!('hasMore' in value) || value['hasMore'] === undefined)
+        return false;
+    if (!('pollingRequired' in value) || value['pollingRequired'] === undefined)
+        return false;
+    return true;
+}
+export function AgentAsyncTaskSyncFromJSON(json) {
+    return AgentAsyncTaskSyncFromJSONTyped(json, false);
+}
+export function AgentAsyncTaskSyncFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'activeTasks': (json['activeTasks'].map(AsyncTaskFromJSON)),
+        'notificationMessages': (json['notificationMessages'].map(ConversationMessageFromJSON)),
+        'nextMessageId': json['nextMessageId'],
+        'hasMore': json['hasMore'],
+        'pollingRequired': json['pollingRequired'],
+    };
+}
+export function AgentAsyncTaskSyncToJSON(json) {
+    return AgentAsyncTaskSyncToJSONTyped(json, false);
+}
+export function AgentAsyncTaskSyncToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'activeTasks': (value['activeTasks'].map(AsyncTaskToJSON)),
+        'notificationMessages': (value['notificationMessages'].map(ConversationMessageToJSON)),
+        'nextMessageId': value['nextMessageId'],
+        'hasMore': value['hasMore'],
+        'pollingRequired': value['pollingRequired'],
+    };
+}

package/dist/esm/models/AgentFile.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).