@lingya-ai/agents-sdk 0.4.0 → 0.7.0

package/dist/esm/apis/EventsApi.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.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,9 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AiChatBriefEventList, AiChatEventsBatch, AiChatEventsBatchInput } from '../models/index';
+import { type AiChatBriefEventList } from '../models/AiChatBriefEventList';
+import { type AiChatEventsBatch } from '../models/AiChatEventsBatch';
+import { type AiChatEventsBatchInput } from '../models/AiChatEventsBatchInput';
 export interface GetChatEventsRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -44,12 +46,12 @@ export declare class EventsApi extends runtime.BaseAPI {
      */
     getChatEventsRequestOpts(requestParameters: GetChatEventsRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取消息事件 / Get message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复单条消息已经持久化的事件。  ### Use case Recover persisted events for one message.  ### 前置条件 conversationId 与 messageId 匹配。  ### Prerequisites conversationId and messageId match.  ### 行为与副作用 只读，不重新执行 Agent。  ### Behavior and side effects Read-only and does not re-run the Agent.  ### 后续调用 重建 UI 状态或与 SSE 后续事件合并。  ### Next step Rebuild UI state or merge with later SSE events.  ### 接口摘要 读取消息事件 / Get message events  ### Operation summary 读取消息事件 / Get message events
      * 读取消息事件 / Get message events
      */
     getChatEventsRaw(requestParameters: GetChatEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiChatBriefEventList>>;
     /**
-     * 读取消息事件 / Get message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复单条消息已经持久化的事件。  ### Use case Recover persisted events for one message.  ### 前置条件 conversationId 与 messageId 匹配。  ### Prerequisites conversationId and messageId match.  ### 行为与副作用 只读，不重新执行 Agent。  ### Behavior and side effects Read-only and does not re-run the Agent.  ### 后续调用 重建 UI 状态或与 SSE 后续事件合并。  ### Next step Rebuild UI state or merge with later SSE events.  ### 接口摘要 读取消息事件 / Get message events  ### Operation summary 读取消息事件 / Get message events
      * 读取消息事件 / Get message events
      */
     getChatEvents(requestParameters: GetChatEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiChatBriefEventList>;
@@ -58,12 +60,12 @@ export declare class EventsApi extends runtime.BaseAPI {
      */
     getChatEventsBatchRequestOpts(requestParameters: GetChatEventsBatchRequest): Promise<runtime.RequestOpts>;
     /**
-     * 批量读取消息事件 / Get message events in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 客户端重启后一次恢复多条消息事件。  ### Use case Recover events for multiple messages after a client restart.  ### 前置条件 请求包含一个会话和最多 50 个消息 ID。  ### Prerequisites The request contains one conversation and up to 50 message IDs.  ### 行为与副作用 只读，并明确返回跳过项。  ### Behavior and side effects Read-only and explicitly reports skipped items.  ### 后续调用 按 messageId 合并记录并处理 skipped。  ### Next step Merge records by messageId and handle skipped entries.  ### 接口摘要 批量读取消息事件 / Get message events in batch  ### Operation summary 批量读取消息事件 / Get message events in batch
      * 批量读取消息事件 / Get message events in batch
      */
     getChatEventsBatchRaw(requestParameters: GetChatEventsBatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AiChatEventsBatch>>;
     /**
-     * 批量读取消息事件 / Get message events in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 客户端重启后一次恢复多条消息事件。  ### Use case Recover events for multiple messages after a client restart.  ### 前置条件 请求包含一个会话和最多 50 个消息 ID。  ### Prerequisites The request contains one conversation and up to 50 message IDs.  ### 行为与副作用 只读，并明确返回跳过项。  ### Behavior and side effects Read-only and explicitly reports skipped items.  ### 后续调用 按 messageId 合并记录并处理 skipped。  ### Next step Merge records by messageId and handle skipped entries.  ### 接口摘要 批量读取消息事件 / Get message events in batch  ### Operation summary 批量读取消息事件 / Get message events in batch
      * 批量读取消息事件 / Get message events in batch
      */
     getChatEventsBatch(requestParameters: GetChatEventsBatchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AiChatEventsBatch>;

package/dist/esm/apis/EventsApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -21,6 +21,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { AiChatBriefEventListFromJSON, } from '../models/AiChatBriefEventList';
+import { AiChatEventsBatchFromJSON, } from '../models/AiChatEventsBatch';
+import { AiChatEventsBatchInputToJSON, } from '../models/AiChatEventsBatchInput';
 /**
  *
  */
@@ -47,6 +50,9 @@ export class EventsApi extends runtime.BaseAPI {
                 queryParameters['messageId'] = requestParameters['messageId'];
             }
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -73,18 +79,18 @@ export class EventsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取消息事件 / Get message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复单条消息已经持久化的事件。  ### Use case Recover persisted events for one message.  ### 前置条件 conversationId 与 messageId 匹配。  ### Prerequisites conversationId and messageId match.  ### 行为与副作用 只读，不重新执行 Agent。  ### Behavior and side effects Read-only and does not re-run the Agent.  ### 后续调用 重建 UI 状态或与 SSE 后续事件合并。  ### Next step Rebuild UI state or merge with later SSE events.  ### 接口摘要 读取消息事件 / Get message events  ### Operation summary 读取消息事件 / Get message events
      * 读取消息事件 / Get message events
      */
     getChatEventsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getChatEventsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatBriefEventListFromJSON(jsonValue));
         });
     }
     /**
-     * 读取消息事件 / Get message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复单条消息已经持久化的事件。  ### Use case Recover persisted events for one message.  ### 前置条件 conversationId 与 messageId 匹配。  ### Prerequisites conversationId and messageId match.  ### 行为与副作用 只读，不重新执行 Agent。  ### Behavior and side effects Read-only and does not re-run the Agent.  ### 后续调用 重建 UI 状态或与 SSE 后续事件合并。  ### Next step Rebuild UI state or merge with later SSE events.  ### 接口摘要 读取消息事件 / Get message events  ### Operation summary 读取消息事件 / Get message events
      * 读取消息事件 / Get message events
      */
     getChatEvents(requestParameters, initOverrides) {
@@ -107,6 +113,9 @@ export class EventsApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -129,23 +138,23 @@ export class EventsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatEventsBatchInput'],
+                body: AiChatEventsBatchInputToJSON(requestParameters['aiChatEventsBatchInput']),
             };
         });
     }
     /**
-     * 批量读取消息事件 / Get message events in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 客户端重启后一次恢复多条消息事件。  ### Use case Recover events for multiple messages after a client restart.  ### 前置条件 请求包含一个会话和最多 50 个消息 ID。  ### Prerequisites The request contains one conversation and up to 50 message IDs.  ### 行为与副作用 只读，并明确返回跳过项。  ### Behavior and side effects Read-only and explicitly reports skipped items.  ### 后续调用 按 messageId 合并记录并处理 skipped。  ### Next step Merge records by messageId and handle skipped entries.  ### 接口摘要 批量读取消息事件 / Get message events in batch  ### Operation summary 批量读取消息事件 / Get message events in batch
      * 批量读取消息事件 / Get message events in batch
      */
     getChatEventsBatchRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getChatEventsBatchRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatEventsBatchFromJSON(jsonValue));
         });
     }
     /**
-     * 批量读取消息事件 / Get message events in batch 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 客户端重启后一次恢复多条消息事件。  ### Use case Recover events for multiple messages after a client restart.  ### 前置条件 请求包含一个会话和最多 50 个消息 ID。  ### Prerequisites The request contains one conversation and up to 50 message IDs.  ### 行为与副作用 只读，并明确返回跳过项。  ### Behavior and side effects Read-only and explicitly reports skipped items.  ### 后续调用 按 messageId 合并记录并处理 skipped。  ### Next step Merge records by messageId and handle skipped entries.  ### 接口摘要 批量读取消息事件 / Get message events in batch  ### Operation summary 批量读取消息事件 / Get message events in batch
      * 批量读取消息事件 / Get message events in batch
      */
     getChatEventsBatch(requestParameters, initOverrides) {

package/dist/esm/apis/FilesApi.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.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,13 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AgentFile, ConfirmUploadInput, CreateFileInput, FileExists, GeneratePreSignedUrlInput, GeneratePreSignedUrlOutput, PreSignedReadUrl } from '../models/index';
+import { type AgentFile } from '../models/AgentFile';
+import { type ConfirmUploadInput } from '../models/ConfirmUploadInput';
+import { type CreateFileInput } from '../models/CreateFileInput';
+import { type FileExists } from '../models/FileExists';
+import { type GeneratePreSignedUrlInput } from '../models/GeneratePreSignedUrlInput';
+import { type GeneratePreSignedUrlOutput } from '../models/GeneratePreSignedUrlOutput';
+import { type PreSignedReadUrl } from '../models/PreSignedReadUrl';
 export interface ConfirmPreSignedUploadRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -92,12 +98,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     confirmPreSignedUploadRequestOpts(requestParameters: ConfirmPreSignedUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * 确认预签名上传 / Confirm a presigned upload 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 对象存储上传成功后登记文件。  ### Use case Register a file after object-storage upload succeeds.  ### 前置条件 持有预签名响应的 fileUk 和同一 contentMd5。  ### Prerequisites The fileUk and matching contentMd5 from the presign response are available.  ### 行为与副作用 确认文件并返回可用于聊天的文件记录。  ### Behavior and side effects Confirms the file and returns a record usable in chat.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 确认预签名上传 / Confirm a presigned upload  ### Operation summary 确认预签名上传 / Confirm a presigned upload
      * 确认预签名上传 / Confirm a presigned upload
      */
     confirmPreSignedUploadRaw(requestParameters: ConfirmPreSignedUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentFile>>;
     /**
-     * 确认预签名上传 / Confirm a presigned upload 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 对象存储上传成功后登记文件。  ### Use case Register a file after object-storage upload succeeds.  ### 前置条件 持有预签名响应的 fileUk 和同一 contentMd5。  ### Prerequisites The fileUk and matching contentMd5 from the presign response are available.  ### 行为与副作用 确认文件并返回可用于聊天的文件记录。  ### Behavior and side effects Confirms the file and returns a record usable in chat.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 确认预签名上传 / Confirm a presigned upload  ### Operation summary 确认预签名上传 / Confirm a presigned upload
      * 确认预签名上传 / Confirm a presigned upload
      */
     confirmPreSignedUpload(requestParameters: ConfirmPreSignedUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentFile>;
@@ -106,12 +112,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     createFileByContentMd5RequestOpts(requestParameters: CreateFileByContentMd5Request): Promise<runtime.RequestOpts>;
     /**
-     * 按 MD5 复用文件 / Reuse a file by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 复用服务端已经存在的相同内容文件。  ### Use case Reuse an existing server-side file with identical content.  ### 前置条件 已计算 MD5 并确认内容可复用。  ### Prerequisites The MD5 is known and the content is safe to reuse.  ### 行为与副作用 创建当前用户可引用的文件记录，不上传字节。  ### Behavior and side effects Creates a user-visible file record without uploading bytes.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 按 MD5 复用文件 / Reuse a file by MD5  ### Operation summary 按 MD5 复用文件 / Reuse a file by MD5
      * 按 MD5 复用文件 / Reuse a file by MD5
      */
     createFileByContentMd5Raw(requestParameters: CreateFileByContentMd5Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentFile>>;
     /**
-     * 按 MD5 复用文件 / Reuse a file by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 复用服务端已经存在的相同内容文件。  ### Use case Reuse an existing server-side file with identical content.  ### 前置条件 已计算 MD5 并确认内容可复用。  ### Prerequisites The MD5 is known and the content is safe to reuse.  ### 行为与副作用 创建当前用户可引用的文件记录，不上传字节。  ### Behavior and side effects Creates a user-visible file record without uploading bytes.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 按 MD5 复用文件 / Reuse a file by MD5  ### Operation summary 按 MD5 复用文件 / Reuse a file by MD5
      * 按 MD5 复用文件 / Reuse a file by MD5
      */
     createFileByContentMd5(requestParameters: CreateFileByContentMd5Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentFile>;
@@ -120,12 +126,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     createPreSignedUploadRequestOpts(requestParameters: CreatePreSignedUploadRequest): Promise<runtime.RequestOpts>;
     /**
-     * 创建预签名上传地址 / Create a presigned upload URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为需要上传的新附件申请对象存储地址。  ### Use case Request an object-storage URL for a new attachment.  ### 前置条件 已计算文件 MD5，文件模块为 ai-chat-attachments。  ### Prerequisites The file MD5 is known and the module is ai-chat-attachments.  ### 行为与副作用 创建短期上传授权，不代表上传完成。  ### Behavior and side effects Creates short-lived upload authorization; upload is not yet complete.  ### 后续调用 按返回 headers 上传文件，再调用确认接口。  ### Next step Upload with the returned headers, then call confirmation.  ### 接口摘要 创建预签名上传地址 / Create a presigned upload URL  ### Operation summary 创建预签名上传地址 / Create a presigned upload URL
      * 创建预签名上传地址 / Create a presigned upload URL
      */
     createPreSignedUploadRaw(requestParameters: CreatePreSignedUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GeneratePreSignedUrlOutput>>;
     /**
-     * 创建预签名上传地址 / Create a presigned upload URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为需要上传的新附件申请对象存储地址。  ### Use case Request an object-storage URL for a new attachment.  ### 前置条件 已计算文件 MD5，文件模块为 ai-chat-attachments。  ### Prerequisites The file MD5 is known and the module is ai-chat-attachments.  ### 行为与副作用 创建短期上传授权，不代表上传完成。  ### Behavior and side effects Creates short-lived upload authorization; upload is not yet complete.  ### 后续调用 按返回 headers 上传文件，再调用确认接口。  ### Next step Upload with the returned headers, then call confirmation.  ### 接口摘要 创建预签名上传地址 / Create a presigned upload URL  ### Operation summary 创建预签名上传地址 / Create a presigned upload URL
      * 创建预签名上传地址 / Create a presigned upload URL
      */
     createPreSignedUpload(requestParameters: CreatePreSignedUploadRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GeneratePreSignedUrlOutput>;
@@ -134,12 +140,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     fileExistsByContentMd5RequestOpts(requestParameters: FileExistsByContentMd5Request): Promise<runtime.RequestOpts>;
     /**
-     * 检查 MD5 文件是否存在 / Check file existence by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上传前检查相同内容是否已经存在。  ### Use case Check whether identical content exists before uploading.  ### 前置条件 已计算文件 MD5。  ### Prerequisites The file MD5 is known.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 存在时尝试复用，否则走预签名上传。  ### Next step Attempt reuse when present; otherwise use presigned upload.  ### 接口摘要 检查 MD5 文件是否存在 / Check file existence by MD5  ### Operation summary 检查 MD5 文件是否存在 / Check file existence by MD5
      * 检查 MD5 文件是否存在 / Check file existence by MD5
      */
     fileExistsByContentMd5Raw(requestParameters: FileExistsByContentMd5Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileExists>>;
     /**
-     * 检查 MD5 文件是否存在 / Check file existence by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上传前检查相同内容是否已经存在。  ### Use case Check whether identical content exists before uploading.  ### 前置条件 已计算文件 MD5。  ### Prerequisites The file MD5 is known.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 存在时尝试复用，否则走预签名上传。  ### Next step Attempt reuse when present; otherwise use presigned upload.  ### 接口摘要 检查 MD5 文件是否存在 / Check file existence by MD5  ### Operation summary 检查 MD5 文件是否存在 / Check file existence by MD5
      * 检查 MD5 文件是否存在 / Check file existence by MD5
      */
     fileExistsByContentMd5(requestParameters: FileExistsByContentMd5Request, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileExists>;
@@ -148,12 +154,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     getConversationFilePreviewRequestOpts(requestParameters: GetConversationFilePreviewRequest): Promise<runtime.RequestOpts>;
     /**
-     * 创建会话文件预览地址 / Create a conversation file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为会话附件创建短期预览地址。  ### Use case Create a short-lived preview URL for a conversation attachment.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权，不修改文件。  ### Behavior and side effects Creates temporary read authorization without changing the file.  ### 后续调用 在过期前打开或下载 URL。  ### Next step Open or download the URL before it expires.  ### 接口摘要 创建会话文件预览地址 / Create a conversation file preview URL  ### Operation summary 创建会话文件预览地址 / Create a conversation file preview URL
      * 创建会话文件预览地址 / Create a conversation file preview URL
      */
     getConversationFilePreviewRaw(requestParameters: GetConversationFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PreSignedReadUrl>>;
     /**
-     * 创建会话文件预览地址 / Create a conversation file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为会话附件创建短期预览地址。  ### Use case Create a short-lived preview URL for a conversation attachment.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权，不修改文件。  ### Behavior and side effects Creates temporary read authorization without changing the file.  ### 后续调用 在过期前打开或下载 URL。  ### Next step Open or download the URL before it expires.  ### 接口摘要 创建会话文件预览地址 / Create a conversation file preview URL  ### Operation summary 创建会话文件预览地址 / Create a conversation file preview URL
      * 创建会话文件预览地址 / Create a conversation file preview URL
      */
     getConversationFilePreview(requestParameters: GetConversationFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PreSignedReadUrl>;
@@ -162,12 +168,12 @@ export declare class FilesApi extends runtime.BaseAPI {
      */
     getPlanIntermediateFilePreviewRequestOpts(requestParameters: GetPlanIntermediateFilePreviewRequest): Promise<runtime.RequestOpts>;
     /**
-     * 创建计划快照预览地址 / Create a plan snapshot preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 预览计划执行过程中生成的中间文件。  ### Use case Preview an intermediate file produced during plan execution.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL，并保留消息上下文。  ### Next step Use the URL before expiry and preserve message context.  ### 接口摘要 创建计划快照预览地址 / Create a plan snapshot preview URL  ### Operation summary 创建计划快照预览地址 / Create a plan snapshot preview URL
      * 创建计划快照预览地址 / Create a plan snapshot preview URL
      */
     getPlanIntermediateFilePreviewRaw(requestParameters: GetPlanIntermediateFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PreSignedReadUrl>>;
     /**
-     * 创建计划快照预览地址 / Create a plan snapshot preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 预览计划执行过程中生成的中间文件。  ### Use case Preview an intermediate file produced during plan execution.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL，并保留消息上下文。  ### Next step Use the URL before expiry and preserve message context.  ### 接口摘要 创建计划快照预览地址 / Create a plan snapshot preview URL  ### Operation summary 创建计划快照预览地址 / Create a plan snapshot preview URL
      * 创建计划快照预览地址 / Create a plan snapshot preview URL
      */
     getPlanIntermediateFilePreview(requestParameters: GetPlanIntermediateFilePreviewRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PreSignedReadUrl>;

package/dist/esm/apis/FilesApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * Public Lingya Agents channel API. HMAC credentials belong on trusted servers; client tokens are single-use.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.7
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -21,6 +21,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { AgentFileFromJSON, } from '../models/AgentFile';
+import { ConfirmUploadInputToJSON, } from '../models/ConfirmUploadInput';
+import { CreateFileInputToJSON, } from '../models/CreateFileInput';
+import { FileExistsFromJSON, } from '../models/FileExists';
+import { GeneratePreSignedUrlInputToJSON, } from '../models/GeneratePreSignedUrlInput';
+import { GeneratePreSignedUrlOutputFromJSON, } from '../models/GeneratePreSignedUrlOutput';
+import { PreSignedReadUrlFromJSON, } from '../models/PreSignedReadUrl';
 /**
  *
  */
@@ -39,6 +46,9 @@ export class FilesApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -61,23 +71,23 @@ export class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['confirmUploadInput'],
+                body: ConfirmUploadInputToJSON(requestParameters['confirmUploadInput']),
             };
         });
     }
     /**
-     * 确认预签名上传 / Confirm a presigned upload 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 对象存储上传成功后登记文件。  ### Use case Register a file after object-storage upload succeeds.  ### 前置条件 持有预签名响应的 fileUk 和同一 contentMd5。  ### Prerequisites The fileUk and matching contentMd5 from the presign response are available.  ### 行为与副作用 确认文件并返回可用于聊天的文件记录。  ### Behavior and side effects Confirms the file and returns a record usable in chat.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 确认预签名上传 / Confirm a presigned upload  ### Operation summary 确认预签名上传 / Confirm a presigned upload
      * 确认预签名上传 / Confirm a presigned upload
      */
     confirmPreSignedUploadRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.confirmPreSignedUploadRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentFileFromJSON(jsonValue));
         });
     }
     /**
-     * 确认预签名上传 / Confirm a presigned upload 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 对象存储上传成功后登记文件。  ### Use case Register a file after object-storage upload succeeds.  ### 前置条件 持有预签名响应的 fileUk 和同一 contentMd5。  ### Prerequisites The fileUk and matching contentMd5 from the presign response are available.  ### 行为与副作用 确认文件并返回可用于聊天的文件记录。  ### Behavior and side effects Confirms the file and returns a record usable in chat.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 确认预签名上传 / Confirm a presigned upload  ### Operation summary 确认预签名上传 / Confirm a presigned upload
      * 确认预签名上传 / Confirm a presigned upload
      */
     confirmPreSignedUpload(requestParameters, initOverrides) {
@@ -100,6 +110,9 @@ export class FilesApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -122,23 +135,23 @@ export class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['createFileInput'],
+                body: CreateFileInputToJSON(requestParameters['createFileInput']),
             };
         });
     }
     /**
-     * 按 MD5 复用文件 / Reuse a file by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 复用服务端已经存在的相同内容文件。  ### Use case Reuse an existing server-side file with identical content.  ### 前置条件 已计算 MD5 并确认内容可复用。  ### Prerequisites The MD5 is known and the content is safe to reuse.  ### 行为与副作用 创建当前用户可引用的文件记录，不上传字节。  ### Behavior and side effects Creates a user-visible file record without uploading bytes.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 按 MD5 复用文件 / Reuse a file by MD5  ### Operation summary 按 MD5 复用文件 / Reuse a file by MD5
      * 按 MD5 复用文件 / Reuse a file by MD5
      */
     createFileByContentMd5Raw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.createFileByContentMd5RequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentFileFromJSON(jsonValue));
         });
     }
     /**
-     * 按 MD5 复用文件 / Reuse a file by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 复用服务端已经存在的相同内容文件。  ### Use case Reuse an existing server-side file with identical content.  ### 前置条件 已计算 MD5 并确认内容可复用。  ### Prerequisites The MD5 is known and the content is safe to reuse.  ### 行为与副作用 创建当前用户可引用的文件记录，不上传字节。  ### Behavior and side effects Creates a user-visible file record without uploading bytes.  ### 后续调用 把返回的文件 ID 放入聊天请求。  ### Next step Place the returned file ID in a chat request.  ### 接口摘要 按 MD5 复用文件 / Reuse a file by MD5  ### Operation summary 按 MD5 复用文件 / Reuse a file by MD5
      * 按 MD5 复用文件 / Reuse a file by MD5
      */
     createFileByContentMd5(requestParameters, initOverrides) {
@@ -161,6 +174,9 @@ export class FilesApi extends runtime.BaseAPI {
             const queryParameters = {};
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -183,23 +199,23 @@ export class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['generatePreSignedUrlInput'],
+                body: GeneratePreSignedUrlInputToJSON(requestParameters['generatePreSignedUrlInput']),
             };
         });
     }
     /**
-     * 创建预签名上传地址 / Create a presigned upload URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为需要上传的新附件申请对象存储地址。  ### Use case Request an object-storage URL for a new attachment.  ### 前置条件 已计算文件 MD5，文件模块为 ai-chat-attachments。  ### Prerequisites The file MD5 is known and the module is ai-chat-attachments.  ### 行为与副作用 创建短期上传授权，不代表上传完成。  ### Behavior and side effects Creates short-lived upload authorization; upload is not yet complete.  ### 后续调用 按返回 headers 上传文件，再调用确认接口。  ### Next step Upload with the returned headers, then call confirmation.  ### 接口摘要 创建预签名上传地址 / Create a presigned upload URL  ### Operation summary 创建预签名上传地址 / Create a presigned upload URL
      * 创建预签名上传地址 / Create a presigned upload URL
      */
     createPreSignedUploadRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.createPreSignedUploadRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => GeneratePreSignedUrlOutputFromJSON(jsonValue));
         });
     }
     /**
-     * 创建预签名上传地址 / Create a presigned upload URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为需要上传的新附件申请对象存储地址。  ### Use case Request an object-storage URL for a new attachment.  ### 前置条件 已计算文件 MD5，文件模块为 ai-chat-attachments。  ### Prerequisites The file MD5 is known and the module is ai-chat-attachments.  ### 行为与副作用 创建短期上传授权，不代表上传完成。  ### Behavior and side effects Creates short-lived upload authorization; upload is not yet complete.  ### 后续调用 按返回 headers 上传文件，再调用确认接口。  ### Next step Upload with the returned headers, then call confirmation.  ### 接口摘要 创建预签名上传地址 / Create a presigned upload URL  ### Operation summary 创建预签名上传地址 / Create a presigned upload URL
      * 创建预签名上传地址 / Create a presigned upload URL
      */
     createPreSignedUpload(requestParameters, initOverrides) {
@@ -224,6 +240,9 @@ export class FilesApi extends runtime.BaseAPI {
                 queryParameters['contentMd5'] = requestParameters['contentMd5'];
             }
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -250,18 +269,18 @@ export class FilesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 检查 MD5 文件是否存在 / Check file existence by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上传前检查相同内容是否已经存在。  ### Use case Check whether identical content exists before uploading.  ### 前置条件 已计算文件 MD5。  ### Prerequisites The file MD5 is known.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 存在时尝试复用，否则走预签名上传。  ### Next step Attempt reuse when present; otherwise use presigned upload.  ### 接口摘要 检查 MD5 文件是否存在 / Check file existence by MD5  ### Operation summary 检查 MD5 文件是否存在 / Check file existence by MD5
      * 检查 MD5 文件是否存在 / Check file existence by MD5
      */
     fileExistsByContentMd5Raw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.fileExistsByContentMd5RequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => FileExistsFromJSON(jsonValue));
         });
     }
     /**
-     * 检查 MD5 文件是否存在 / Check file existence by MD5 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上传前检查相同内容是否已经存在。  ### Use case Check whether identical content exists before uploading.  ### 前置条件 已计算文件 MD5。  ### Prerequisites The file MD5 is known.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 存在时尝试复用，否则走预签名上传。  ### Next step Attempt reuse when present; otherwise use presigned upload.  ### 接口摘要 检查 MD5 文件是否存在 / Check file existence by MD5  ### Operation summary 检查 MD5 文件是否存在 / Check file existence by MD5
      * 检查 MD5 文件是否存在 / Check file existence by MD5
      */
     fileExistsByContentMd5(requestParameters, initOverrides) {
@@ -286,6 +305,9 @@ export class FilesApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -314,18 +336,18 @@ export class FilesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 创建会话文件预览地址 / Create a conversation file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为会话附件创建短期预览地址。  ### Use case Create a short-lived preview URL for a conversation attachment.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权，不修改文件。  ### Behavior and side effects Creates temporary read authorization without changing the file.  ### 后续调用 在过期前打开或下载 URL。  ### Next step Open or download the URL before it expires.  ### 接口摘要 创建会话文件预览地址 / Create a conversation file preview URL  ### Operation summary 创建会话文件预览地址 / Create a conversation file preview URL
      * 创建会话文件预览地址 / Create a conversation file preview URL
      */
     getConversationFilePreviewRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getConversationFilePreviewRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PreSignedReadUrlFromJSON(jsonValue));
         });
     }
     /**
-     * 创建会话文件预览地址 / Create a conversation file preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 为会话附件创建短期预览地址。  ### Use case Create a short-lived preview URL for a conversation attachment.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权，不修改文件。  ### Behavior and side effects Creates temporary read authorization without changing the file.  ### 后续调用 在过期前打开或下载 URL。  ### Next step Open or download the URL before it expires.  ### 接口摘要 创建会话文件预览地址 / Create a conversation file preview URL  ### Operation summary 创建会话文件预览地址 / Create a conversation file preview URL
      * 创建会话文件预览地址 / Create a conversation file preview URL
      */
     getConversationFilePreview(requestParameters, initOverrides) {
@@ -353,6 +375,9 @@ export class FilesApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-OpenAPI-Token"] = yield this.configuration.apiKey("X-OpenAPI-Token"); // OpenApiToken authentication
+            }
             if (this.configuration && this.configuration.apiKey) {
                 headerParameters["X-OpenAPI-User"] = yield this.configuration.apiKey("X-OpenAPI-User"); // OpenApiUser authentication
             }
@@ -382,18 +407,18 @@ export class FilesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 创建计划快照预览地址 / Create a plan snapshot preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 预览计划执行过程中生成的中间文件。  ### Use case Preview an intermediate file produced during plan execution.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL，并保留消息上下文。  ### Next step Use the URL before expiry and preserve message context.  ### 接口摘要 创建计划快照预览地址 / Create a plan snapshot preview URL  ### Operation summary 创建计划快照预览地址 / Create a plan snapshot preview URL
      * 创建计划快照预览地址 / Create a plan snapshot preview URL
      */
     getPlanIntermediateFilePreviewRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getPlanIntermediateFilePreviewRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PreSignedReadUrlFromJSON(jsonValue));
         });
     }
     /**
-     * 创建计划快照预览地址 / Create a plan snapshot preview URL 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 预览计划执行过程中生成的中间文件。  ### Use case Preview an intermediate file produced during plan execution.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 生成临时读取授权。  ### Behavior and side effects Creates temporary read authorization.  ### 后续调用 在过期前使用 URL，并保留消息上下文。  ### Next step Use the URL before expiry and preserve message context.  ### 接口摘要 创建计划快照预览地址 / Create a plan snapshot preview URL  ### Operation summary 创建计划快照预览地址 / Create a plan snapshot preview URL
      * 创建计划快照预览地址 / Create a plan snapshot preview URL
      */
     getPlanIntermediateFilePreview(requestParameters, initOverrides) {