@lingya-ai/agents-sdk 0.3.0 → 0.5.0

package/dist/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/apis/SQLApi.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,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExportSqlQueryResultFormatEnum = exports.SQLApi = void 0;
 const runtime = require("../runtime");
+const SqlChartDataset_1 = require("../models/SqlChartDataset");
+const SqlQueryResultPage_1 = require("../models/SqlQueryResultPage");
 /**
  *
  */
@@ -81,7 +83,7 @@ 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) {
@@ -92,7 +94,7 @@ 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) {
@@ -145,18 +147,18 @@ 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) => (0, SqlChartDataset_1.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) {
@@ -215,18 +217,18 @@ 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) => (0, SqlQueryResultPage_1.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/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/apis/WorkspaceApi.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,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListWorkspaceArtifactsOrderNullHandlingEnum = exports.ListWorkspaceArtifactsOrderDirectionEnum = exports.WorkspaceApi = void 0;
 const runtime = require("../runtime");
+const PreSignedReadUrl_1 = require("../models/PreSignedReadUrl");
+const WorkspaceArtifactList_1 = require("../models/WorkspaceArtifactList");
 /**
  *
  */
@@ -74,18 +76,18 @@ 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) => (0, PreSignedReadUrl_1.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) {
@@ -155,18 +157,18 @@ 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) => (0, WorkspaceArtifactList_1.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) {