@lingya-ai/agents-sdk 0.3.0 → 0.5.0

package/dist/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.
+ * 本契约描述灵涯 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,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/apis/FilesApi.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,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilesApi = void 0;
 const runtime = require("../runtime");
+const AgentFile_1 = require("../models/AgentFile");
+const ConfirmUploadInput_1 = require("../models/ConfirmUploadInput");
+const CreateFileInput_1 = require("../models/CreateFileInput");
+const FileExists_1 = require("../models/FileExists");
+const GeneratePreSignedUrlInput_1 = require("../models/GeneratePreSignedUrlInput");
+const GeneratePreSignedUrlOutput_1 = require("../models/GeneratePreSignedUrlOutput");
+const PreSignedReadUrl_1 = require("../models/PreSignedReadUrl");
 /**
  *
  */
@@ -64,23 +71,23 @@ class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['confirmUploadInput'],
+                body: (0, ConfirmUploadInput_1.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) => (0, AgentFile_1.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) {
@@ -125,23 +132,23 @@ class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['createFileInput'],
+                body: (0, CreateFileInput_1.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) => (0, AgentFile_1.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) {
@@ -186,23 +193,23 @@ class FilesApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['generatePreSignedUrlInput'],
+                body: (0, GeneratePreSignedUrlInput_1.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) => (0, GeneratePreSignedUrlOutput_1.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) {
@@ -253,18 +260,18 @@ 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) => (0, FileExists_1.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) {
@@ -317,18 +324,18 @@ 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) => (0, PreSignedReadUrl_1.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) {
@@ -385,18 +392,18 @@ 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) => (0, PreSignedReadUrl_1.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) {

package/dist/apis/InteractionsApi.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,11 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { OperationResult, PlanApprovalInput, PlanStatus, UserInputAnswerInput, UserInputStatus } from '../models/index';
+import { type OperationResult } from '../models/OperationResult';
+import { type PlanApprovalInput } from '../models/PlanApprovalInput';
+import { type PlanStatus } from '../models/PlanStatus';
+import { type UserInputAnswerInput } from '../models/UserInputAnswerInput';
+import { type UserInputStatus } from '../models/UserInputStatus';
 export interface AnswerUserInputRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -68,12 +72,12 @@ export declare class InteractionsApi extends runtime.BaseAPI {
      */
     answerUserInputRequestOpts(requestParameters: AnswerUserInputRequest): Promise<runtime.RequestOpts>;
     /**
-     * 提交用户回答 / Submit a user answer 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 提交用户对 Agent 问题的选项或自定义回答。  ### Use case Submit selected options or custom input for an Agent question.  ### 前置条件 问题仍处于 pending 且标识与消息匹配。  ### Prerequisites The question is pending and identifiers match the message.  ### 行为与副作用 保存回答并可能推动执行继续。  ### Behavior and side effects Stores the answer and may resume execution.  ### 后续调用 继续监听 SSE 或查询消息状态。  ### Next step Continue listening to SSE or query message state.  ### 接口摘要 提交用户回答 / Submit a user answer  ### Operation summary 提交用户回答 / Submit a user answer
      * 提交用户回答 / Submit a user answer
      */
     answerUserInputRaw(requestParameters: AnswerUserInputRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<OperationResult>>;
     /**
-     * 提交用户回答 / Submit a user answer 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 提交用户对 Agent 问题的选项或自定义回答。  ### Use case Submit selected options or custom input for an Agent question.  ### 前置条件 问题仍处于 pending 且标识与消息匹配。  ### Prerequisites The question is pending and identifiers match the message.  ### 行为与副作用 保存回答并可能推动执行继续。  ### Behavior and side effects Stores the answer and may resume execution.  ### 后续调用 继续监听 SSE 或查询消息状态。  ### Next step Continue listening to SSE or query message state.  ### 接口摘要 提交用户回答 / Submit a user answer  ### Operation summary 提交用户回答 / Submit a user answer
      * 提交用户回答 / Submit a user answer
      */
     answerUserInput(requestParameters: AnswerUserInputRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<OperationResult>;
@@ -82,12 +86,12 @@ export declare class InteractionsApi extends runtime.BaseAPI {
      */
     approvePlanRequestOpts(requestParameters: ApprovePlanRequest): Promise<runtime.RequestOpts>;
     /**
-     * 提交计划审批 / Submit plan approval 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 响应 Agent 发出的计划审批请求。  ### Use case Respond to a plan-approval request emitted by the Agent.  ### 前置条件 从事件取得 planId、conversationId 和 messageId。  ### Prerequisites Obtain planId, conversationId, and messageId from the event.  ### 行为与副作用 提交批准或拒绝，可能推动执行继续。  ### Behavior and side effects Submits approval or rejection and may resume execution.  ### 后续调用 查询计划状态并继续监听事件。  ### Next step Check plan status and continue listening for events.  ### 接口摘要 提交计划审批 / Submit plan approval  ### Operation summary 提交计划审批 / Submit plan approval
      * 提交计划审批 / Submit plan approval
      */
     approvePlanRaw(requestParameters: ApprovePlanRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<OperationResult>>;
     /**
-     * 提交计划审批 / Submit plan approval 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 响应 Agent 发出的计划审批请求。  ### Use case Respond to a plan-approval request emitted by the Agent.  ### 前置条件 从事件取得 planId、conversationId 和 messageId。  ### Prerequisites Obtain planId, conversationId, and messageId from the event.  ### 行为与副作用 提交批准或拒绝，可能推动执行继续。  ### Behavior and side effects Submits approval or rejection and may resume execution.  ### 后续调用 查询计划状态并继续监听事件。  ### Next step Check plan status and continue listening for events.  ### 接口摘要 提交计划审批 / Submit plan approval  ### Operation summary 提交计划审批 / Submit plan approval
      * 提交计划审批 / Submit plan approval
      */
     approvePlan(requestParameters: ApprovePlanRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<OperationResult>;
@@ -96,12 +100,12 @@ export declare class InteractionsApi extends runtime.BaseAPI {
      */
     getPlanStatusRequestOpts(requestParameters: GetPlanStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 查询计划审批状态 / Get plan approval status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 确认计划是否仍在等待或已经处理。  ### Use case Check whether a plan is still pending or has been handled.  ### 前置条件 持有事件返回的 planId。  ### Prerequisites A planId returned by an event is available.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 pending 时等待用户操作，否则刷新执行状态。  ### Next step Wait for user action while pending; otherwise refresh execution state.  ### 接口摘要 查询计划审批状态 / Get plan approval status  ### Operation summary 查询计划审批状态 / Get plan approval status
      * 查询计划审批状态 / Get plan approval status
      */
     getPlanStatusRaw(requestParameters: GetPlanStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PlanStatus>>;
     /**
-     * 查询计划审批状态 / Get plan approval status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 确认计划是否仍在等待或已经处理。  ### Use case Check whether a plan is still pending or has been handled.  ### 前置条件 持有事件返回的 planId。  ### Prerequisites A planId returned by an event is available.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 pending 时等待用户操作，否则刷新执行状态。  ### Next step Wait for user action while pending; otherwise refresh execution state.  ### 接口摘要 查询计划审批状态 / Get plan approval status  ### Operation summary 查询计划审批状态 / Get plan approval status
      * 查询计划审批状态 / Get plan approval status
      */
     getPlanStatus(requestParameters: GetPlanStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PlanStatus>;
@@ -110,12 +114,12 @@ export declare class InteractionsApi extends runtime.BaseAPI {
      */
     getUserInputStatusRequestOpts(requestParameters: GetUserInputStatusRequest): Promise<runtime.RequestOpts>;
     /**
-     * 查询用户问答状态 / Get user-input status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复页面时确认 Agent 问题是否仍待回答。  ### Use case Check whether an Agent question is still awaiting an answer after restoring a page.  ### 前置条件 questionId、conversationId 和 messageId 来自同一事件。  ### Prerequisites questionId, conversationId, and messageId come from the same event.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 仍 pending 时展示问题，否则继续恢复事件。  ### Next step Show the question while pending; otherwise continue event recovery.  ### 接口摘要 查询用户问答状态 / Get user-input status  ### Operation summary 查询用户问答状态 / Get user-input status
      * 查询用户问答状态 / Get user-input status
      */
     getUserInputStatusRaw(requestParameters: GetUserInputStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UserInputStatus>>;
     /**
-     * 查询用户问答状态 / Get user-input status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复页面时确认 Agent 问题是否仍待回答。  ### Use case Check whether an Agent question is still awaiting an answer after restoring a page.  ### 前置条件 questionId、conversationId 和 messageId 来自同一事件。  ### Prerequisites questionId, conversationId, and messageId come from the same event.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 仍 pending 时展示问题，否则继续恢复事件。  ### Next step Show the question while pending; otherwise continue event recovery.  ### 接口摘要 查询用户问答状态 / Get user-input status  ### Operation summary 查询用户问答状态 / Get user-input status
      * 查询用户问答状态 / Get user-input status
      */
     getUserInputStatus(requestParameters: GetUserInputStatusRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UserInputStatus>;

package/dist/apis/InteractionsApi.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,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InteractionsApi = void 0;
 const runtime = require("../runtime");
+const OperationResult_1 = require("../models/OperationResult");
+const PlanApprovalInput_1 = require("../models/PlanApprovalInput");
+const PlanStatus_1 = require("../models/PlanStatus");
+const UserInputAnswerInput_1 = require("../models/UserInputAnswerInput");
+const UserInputStatus_1 = require("../models/UserInputStatus");
 /**
  *
  */
@@ -64,23 +69,23 @@ class InteractionsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['userInputAnswerInput'],
+                body: (0, UserInputAnswerInput_1.UserInputAnswerInputToJSON)(requestParameters['userInputAnswerInput']),
             };
         });
     }
     /**
-     * 提交用户回答 / Submit a user answer 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 提交用户对 Agent 问题的选项或自定义回答。  ### Use case Submit selected options or custom input for an Agent question.  ### 前置条件 问题仍处于 pending 且标识与消息匹配。  ### Prerequisites The question is pending and identifiers match the message.  ### 行为与副作用 保存回答并可能推动执行继续。  ### Behavior and side effects Stores the answer and may resume execution.  ### 后续调用 继续监听 SSE 或查询消息状态。  ### Next step Continue listening to SSE or query message state.  ### 接口摘要 提交用户回答 / Submit a user answer  ### Operation summary 提交用户回答 / Submit a user answer
      * 提交用户回答 / Submit a user answer
      */
     answerUserInputRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.answerUserInputRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, OperationResult_1.OperationResultFromJSON)(jsonValue));
         });
     }
     /**
-     * 提交用户回答 / Submit a user answer 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 提交用户对 Agent 问题的选项或自定义回答。  ### Use case Submit selected options or custom input for an Agent question.  ### 前置条件 问题仍处于 pending 且标识与消息匹配。  ### Prerequisites The question is pending and identifiers match the message.  ### 行为与副作用 保存回答并可能推动执行继续。  ### Behavior and side effects Stores the answer and may resume execution.  ### 后续调用 继续监听 SSE 或查询消息状态。  ### Next step Continue listening to SSE or query message state.  ### 接口摘要 提交用户回答 / Submit a user answer  ### Operation summary 提交用户回答 / Submit a user answer
      * 提交用户回答 / Submit a user answer
      */
     answerUserInput(requestParameters, initOverrides) {
@@ -125,23 +130,23 @@ class InteractionsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['planApprovalInput'],
+                body: (0, PlanApprovalInput_1.PlanApprovalInputToJSON)(requestParameters['planApprovalInput']),
             };
         });
     }
     /**
-     * 提交计划审批 / Submit plan approval 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 响应 Agent 发出的计划审批请求。  ### Use case Respond to a plan-approval request emitted by the Agent.  ### 前置条件 从事件取得 planId、conversationId 和 messageId。  ### Prerequisites Obtain planId, conversationId, and messageId from the event.  ### 行为与副作用 提交批准或拒绝，可能推动执行继续。  ### Behavior and side effects Submits approval or rejection and may resume execution.  ### 后续调用 查询计划状态并继续监听事件。  ### Next step Check plan status and continue listening for events.  ### 接口摘要 提交计划审批 / Submit plan approval  ### Operation summary 提交计划审批 / Submit plan approval
      * 提交计划审批 / Submit plan approval
      */
     approvePlanRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.approvePlanRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, OperationResult_1.OperationResultFromJSON)(jsonValue));
         });
     }
     /**
-     * 提交计划审批 / Submit plan approval 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 响应 Agent 发出的计划审批请求。  ### Use case Respond to a plan-approval request emitted by the Agent.  ### 前置条件 从事件取得 planId、conversationId 和 messageId。  ### Prerequisites Obtain planId, conversationId, and messageId from the event.  ### 行为与副作用 提交批准或拒绝，可能推动执行继续。  ### Behavior and side effects Submits approval or rejection and may resume execution.  ### 后续调用 查询计划状态并继续监听事件。  ### Next step Check plan status and continue listening for events.  ### 接口摘要 提交计划审批 / Submit plan approval  ### Operation summary 提交计划审批 / Submit plan approval
      * 提交计划审批 / Submit plan approval
      */
     approvePlan(requestParameters, initOverrides) {
@@ -190,18 +195,18 @@ class InteractionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 查询计划审批状态 / Get plan approval status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 确认计划是否仍在等待或已经处理。  ### Use case Check whether a plan is still pending or has been handled.  ### 前置条件 持有事件返回的 planId。  ### Prerequisites A planId returned by an event is available.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 pending 时等待用户操作，否则刷新执行状态。  ### Next step Wait for user action while pending; otherwise refresh execution state.  ### 接口摘要 查询计划审批状态 / Get plan approval status  ### Operation summary 查询计划审批状态 / Get plan approval status
      * 查询计划审批状态 / Get plan approval status
      */
     getPlanStatusRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getPlanStatusRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, PlanStatus_1.PlanStatusFromJSON)(jsonValue));
         });
     }
     /**
-     * 查询计划审批状态 / Get plan approval status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 确认计划是否仍在等待或已经处理。  ### Use case Check whether a plan is still pending or has been handled.  ### 前置条件 持有事件返回的 planId。  ### Prerequisites A planId returned by an event is available.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 pending 时等待用户操作，否则刷新执行状态。  ### Next step Wait for user action while pending; otherwise refresh execution state.  ### 接口摘要 查询计划审批状态 / Get plan approval status  ### Operation summary 查询计划审批状态 / Get plan approval status
      * 查询计划审批状态 / Get plan approval status
      */
     getPlanStatus(requestParameters, initOverrides) {
@@ -262,18 +267,18 @@ class InteractionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 查询用户问答状态 / Get user-input status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复页面时确认 Agent 问题是否仍待回答。  ### Use case Check whether an Agent question is still awaiting an answer after restoring a page.  ### 前置条件 questionId、conversationId 和 messageId 来自同一事件。  ### Prerequisites questionId, conversationId, and messageId come from the same event.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 仍 pending 时展示问题，否则继续恢复事件。  ### Next step Show the question while pending; otherwise continue event recovery.  ### 接口摘要 查询用户问答状态 / Get user-input status  ### Operation summary 查询用户问答状态 / Get user-input status
      * 查询用户问答状态 / Get user-input status
      */
     getUserInputStatusRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getUserInputStatusRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, UserInputStatus_1.UserInputStatusFromJSON)(jsonValue));
         });
     }
     /**
-     * 查询用户问答状态 / Get user-input status 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复页面时确认 Agent 问题是否仍待回答。  ### Use case Check whether an Agent question is still awaiting an answer after restoring a page.  ### 前置条件 questionId、conversationId 和 messageId 来自同一事件。  ### Prerequisites questionId, conversationId, and messageId come from the same event.  ### 行为与副作用 只读。  ### Behavior and side effects Read-only.  ### 后续调用 仍 pending 时展示问题，否则继续恢复事件。  ### Next step Show the question while pending; otherwise continue event recovery.  ### 接口摘要 查询用户问答状态 / Get user-input status  ### Operation summary 查询用户问答状态 / Get user-input status
      * 查询用户问答状态 / Get user-input status
      */
     getUserInputStatus(requestParameters, initOverrides) {