@lingya-ai/agents-sdk 0.3.0 → 0.5.0

package/dist/esm/apis/ChatApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -21,6 +21,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { AiChatBriefEventFromJSON, } from '../models/AiChatBriefEvent';
+import { AiChatInputToJSON, } from '../models/AiChatInput';
+import { AiChatStreamInputToJSON, } from '../models/AiChatStreamInput';
+import { AiChatSubmissionFromJSON, } from '../models/AiChatSubmission';
+import { ChatStreamProbeEventFromJSON, } from '../models/ChatStreamProbeEvent';
+import { ChatStreamProbeInputToJSON, } from '../models/ChatStreamProbeInput';
 /**
  *
  */
@@ -68,7 +74,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 压缩会话上下文 / Compact conversation context 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上下文接近模型上限或用户要求时触发压缩。  ### Use case Trigger context compaction near the model limit or on explicit user request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步安排上下文压缩。  ### Behavior and side effects Schedules asynchronous context compaction.  ### 后续调用 轮询上下文占用或等待相关事件。  ### Next step Poll context usage or wait for related events.  ### 接口摘要 压缩会话上下文 / Compact conversation context  ### Operation summary 压缩会话上下文 / Compact conversation context
      * 压缩会话上下文 / Compact conversation context
      */
     compactConversationRaw(requestParameters, initOverrides) {
@@ -79,7 +85,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 压缩会话上下文 / Compact conversation context 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 上下文接近模型上限或用户要求时触发压缩。  ### Use case Trigger context compaction near the model limit or on explicit user request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 异步安排上下文压缩。  ### Behavior and side effects Schedules asynchronous context compaction.  ### 后续调用 轮询上下文占用或等待相关事件。  ### Next step Poll context usage or wait for related events.  ### 接口摘要 压缩会话上下文 / Compact conversation context  ### Operation summary 压缩会话上下文 / Compact conversation context
      * 压缩会话上下文 / Compact conversation context
      */
     compactConversation(requestParameters, initOverrides) {
@@ -127,23 +133,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatInput'],
+                body: AiChatInputToJSON(requestParameters['aiChatInput']),
             };
         });
     }
     /**
-     * 向已有会话提交消息 / Submit a message to an existing conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在已有会话中提交下一轮用户消息。  ### Use case Submit the next user turn to an existing conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新消息并安排继续执行。  ### Behavior and side effects Creates a new message and schedules continued execution.  ### 后续调用 订阅该 messageId 的 SSE 或稍后补取事件。  ### Next step Subscribe to SSE for the messageId or recover its events later.  ### 接口摘要 向已有会话提交消息 / Submit a message to an existing conversation  ### Operation summary 向已有会话提交消息 / Submit a message to an existing conversation
      * 向已有会话提交消息 / Submit a message to an existing conversation
      */
     continueChatRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.continueChatRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatSubmissionFromJSON(jsonValue));
         });
     }
     /**
-     * 向已有会话提交消息 / Submit a message to an existing conversation 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在已有会话中提交下一轮用户消息。  ### Use case Submit the next user turn to an existing conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 创建新消息并安排继续执行。  ### Behavior and side effects Creates a new message and schedules continued execution.  ### 后续调用 订阅该 messageId 的 SSE 或稍后补取事件。  ### Next step Subscribe to SSE for the messageId or recover its events later.  ### 接口摘要 向已有会话提交消息 / Submit a message to an existing conversation  ### Operation summary 向已有会话提交消息 / Submit a message to an existing conversation
      * 向已有会话提交消息 / Submit a message to an existing conversation
      */
     continueChat(requestParameters, initOverrides) {
@@ -188,23 +194,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatInput'],
+                body: AiChatInputToJSON(requestParameters['aiChatInput']),
             };
         });
     }
     /**
-     * 创建会话并提交消息 / Create a conversation and submit a message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 创建新会话并提交第一条用户消息。  ### Use case Create a conversation and submit its first user message.  ### 前置条件 已读取配置；引用的文件已经确认上传。  ### Prerequisites Configuration has been read and referenced files are confirmed uploads.  ### 行为与副作用 创建会话和消息，并安排 Agent 执行。  ### Behavior and side effects Creates a conversation and message and schedules Agent execution.  ### 后续调用 使用返回的 conversationId 和 messageId 订阅 SSE。  ### Next step Use the returned conversationId and messageId to subscribe to SSE.  ### 接口摘要 创建会话并提交消息 / Create a conversation and submit a message  ### Operation summary 创建会话并提交消息 / Create a conversation and submit a message
      * 创建会话并提交消息 / Create a conversation and submit a message
      */
     createChatRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.createChatRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatSubmissionFromJSON(jsonValue));
         });
     }
     /**
-     * 创建会话并提交消息 / Create a conversation and submit a message 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 创建新会话并提交第一条用户消息。  ### Use case Create a conversation and submit its first user message.  ### 前置条件 已读取配置；引用的文件已经确认上传。  ### Prerequisites Configuration has been read and referenced files are confirmed uploads.  ### 行为与副作用 创建会话和消息，并安排 Agent 执行。  ### Behavior and side effects Creates a conversation and message and schedules Agent execution.  ### 后续调用 使用返回的 conversationId 和 messageId 订阅 SSE。  ### Next step Use the returned conversationId and messageId to subscribe to SSE.  ### 接口摘要 创建会话并提交消息 / Create a conversation and submit a message  ### Operation summary 创建会话并提交消息 / Create a conversation and submit a message
      * 创建会话并提交消息 / Create a conversation and submit a message
      */
     createChat(requestParameters, initOverrides) {
@@ -253,7 +259,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 中断会话执行 / Interrupt conversation execution 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户主动停止正在执行的会话。  ### Use case Stop an actively executing conversation at the user\'s request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求终止当前执行；已完成输出不会回滚。  ### Behavior and side effects Requests termination of active execution; completed output is not rolled back.  ### 后续调用 查询活动状态或消息详情确认终态。  ### Next step Query activity or message detail to confirm the terminal state.  ### 接口摘要 中断会话执行 / Interrupt conversation execution  ### Operation summary 中断会话执行 / Interrupt conversation execution
      * 中断会话执行 / Interrupt conversation execution
      */
     interruptConversationRaw(requestParameters, initOverrides) {
@@ -264,7 +270,7 @@ export class ChatApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 中断会话执行 / Interrupt conversation execution 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 用户主动停止正在执行的会话。  ### Use case Stop an actively executing conversation at the user\'s request.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 请求终止当前执行；已完成输出不会回滚。  ### Behavior and side effects Requests termination of active execution; completed output is not rolled back.  ### 后续调用 查询活动状态或消息详情确认终态。  ### Next step Query activity or message detail to confirm the terminal state.  ### 接口摘要 中断会话执行 / Interrupt conversation execution  ### Operation summary 中断会话执行 / Interrupt conversation execution
      * 中断会话执行 / Interrupt conversation execution
      */
     interruptConversation(requestParameters, initOverrides) {
@@ -311,23 +317,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['chatStreamProbeInput'],
+                body: ChatStreamProbeInputToJSON(requestParameters['chatStreamProbeInput']),
             };
         });
     }
     /**
-     * 探测 SSE 连接 / Probe the SSE connection 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在接入或排障时验证网关、代理和客户端对 SSE 的支持。  ### Use case Verify SSE support across the gateway, proxy, and client during integration or diagnosis.  ### 前置条件 准备符合格式的 probeId。  ### Prerequisites Prepare a valid probeId.  ### 行为与副作用 只产生诊断事件，不创建业务会话。  ### Behavior and side effects Produces diagnostic events without creating a business conversation.  ### 后续调用 确认分片、心跳和 EOF 行为后再接入正式流。  ### Next step Confirm chunking, heartbeat, and EOF behavior before using the production stream.  ### 接口摘要 探测 SSE 连接 / Probe the SSE connection  ### Operation summary 探测 SSE 连接 / Probe the SSE connection
      * 探测 SSE 连接 / Probe the SSE connection
      */
     probeEventStreamRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.probeEventStreamRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => ChatStreamProbeEventFromJSON(jsonValue));
         });
     }
     /**
-     * 探测 SSE 连接 / Probe the SSE connection 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在接入或排障时验证网关、代理和客户端对 SSE 的支持。  ### Use case Verify SSE support across the gateway, proxy, and client during integration or diagnosis.  ### 前置条件 准备符合格式的 probeId。  ### Prerequisites Prepare a valid probeId.  ### 行为与副作用 只产生诊断事件，不创建业务会话。  ### Behavior and side effects Produces diagnostic events without creating a business conversation.  ### 后续调用 确认分片、心跳和 EOF 行为后再接入正式流。  ### Next step Confirm chunking, heartbeat, and EOF behavior before using the production stream.  ### 接口摘要 探测 SSE 连接 / Probe the SSE connection  ### Operation summary 探测 SSE 连接 / Probe the SSE connection
      * 探测 SSE 连接 / Probe the SSE connection
      */
     probeEventStream(requestParameters, initOverrides) {
@@ -379,23 +385,23 @@ export class ChatApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
-                body: requestParameters['aiChatStreamInput'],
+                body: AiChatStreamInputToJSON(requestParameters['aiChatStreamInput']),
             };
         });
     }
     /**
-     * 订阅消息事件流 / Stream message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 实时接收指定消息的思考、工具、回答和结束事件。  ### Use case Receive thought, tool, answer, and completion events for a message in real time.  ### 前置条件 消息已经创建且 messageId 与会话匹配。  ### Prerequisites The message exists and its messageId belongs to the conversation.  ### 行为与副作用 保持流式连接；断开不会取消服务端执行。  ### Behavior and side effects Keeps a streaming connection; disconnecting does not cancel server execution.  ### 后续调用 正常 EOF 后读取消息详情；异常断开时使用 Events 补取。  ### Next step After normal EOF read message detail; after an unexpected disconnect recover through Events.  ### 接口摘要 订阅消息事件流 / Stream message events  ### Operation summary 订阅消息事件流 / Stream message events
      * 订阅消息事件流 / Stream message events
      */
     streamChatEventsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.streamChatEventsRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AiChatBriefEventFromJSON(jsonValue));
         });
     }
     /**
-     * 订阅消息事件流 / Stream message events 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 实时接收指定消息的思考、工具、回答和结束事件。  ### Use case Receive thought, tool, answer, and completion events for a message in real time.  ### 前置条件 消息已经创建且 messageId 与会话匹配。  ### Prerequisites The message exists and its messageId belongs to the conversation.  ### 行为与副作用 保持流式连接；断开不会取消服务端执行。  ### Behavior and side effects Keeps a streaming connection; disconnecting does not cancel server execution.  ### 后续调用 正常 EOF 后读取消息详情；异常断开时使用 Events 补取。  ### Next step After normal EOF read message detail; after an unexpected disconnect recover through Events.  ### 接口摘要 订阅消息事件流 / Stream message events  ### Operation summary 订阅消息事件流 / Stream message events
      * 订阅消息事件流 / Stream message events
      */
     streamChatEvents(requestParameters, initOverrides) {

package/dist/esm/apis/ConfigurationApi.d.ts

@@ -1,8 +1,8 @@
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -10,7 +10,8 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AgentsConfig, ConversationConfig } from '../models/index';
+import { type AgentsConfig } from '../models/AgentsConfig';
+import { type ConversationConfig } from '../models/ConversationConfig';
 export interface GetAgentsConfigRequest {
     /**
      * Agent OpenAPI 渠道 UUID。 / Agent OpenAPI channel UUID.
@@ -36,12 +37,12 @@ export declare class ConfigurationApi extends runtime.BaseAPI {
      */
     getAgentsConfigRequestOpts(requestParameters: GetAgentsConfigRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取 Agent 配置 / Get Agent configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在初始化客户端能力或展示模型选择器前读取渠道配置。  ### Use case Read channel configuration before initializing client capabilities or showing model choices.  ### 前置条件 仅需有效渠道凭证。  ### Prerequisites Only valid channel credentials are required.  ### 行为与副作用 只读，不修改配置。  ### Behavior and side effects Read-only; no configuration is changed.  ### 后续调用 按附件限制准备文件，或创建会话。  ### Next step Prepare files according to the limits or create a conversation.  ### 接口摘要 读取 Agent 配置 / Get Agent configuration  ### Operation summary 读取 Agent 配置 / Get Agent configuration
      * 读取 Agent 配置 / Get Agent configuration
      */
     getAgentsConfigRaw(requestParameters: GetAgentsConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentsConfig>>;
     /**
-     * 读取 Agent 配置 / Get Agent configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在初始化客户端能力或展示模型选择器前读取渠道配置。  ### Use case Read channel configuration before initializing client capabilities or showing model choices.  ### 前置条件 仅需有效渠道凭证。  ### Prerequisites Only valid channel credentials are required.  ### 行为与副作用 只读，不修改配置。  ### Behavior and side effects Read-only; no configuration is changed.  ### 后续调用 按附件限制准备文件，或创建会话。  ### Next step Prepare files according to the limits or create a conversation.  ### 接口摘要 读取 Agent 配置 / Get Agent configuration  ### Operation summary 读取 Agent 配置 / Get Agent configuration
      * 读取 Agent 配置 / Get Agent configuration
      */
     getAgentsConfig(requestParameters: GetAgentsConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentsConfig>;
@@ -50,12 +51,12 @@ export declare class ConfigurationApi extends runtime.BaseAPI {
      */
     getConversationConfigRequestOpts(requestParameters: GetConversationConfigRequest): Promise<runtime.RequestOpts>;
     /**
-     * 读取会话配置 / Get conversation configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复会话时读取该会话最近使用的模型配置。  ### Use case Read the most recently used model configuration when resuming a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，不修改会话。  ### Behavior and side effects Read-only; the conversation is unchanged.  ### 后续调用 继续提交消息或展示当前模型。  ### Next step Submit another message or display the current model.  ### 接口摘要 读取会话配置 / Get conversation configuration  ### Operation summary 读取会话配置 / Get conversation configuration
      * 读取会话配置 / Get conversation configuration
      */
     getConversationConfigRaw(requestParameters: GetConversationConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationConfig>>;
     /**
-     * 读取会话配置 / Get conversation configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复会话时读取该会话最近使用的模型配置。  ### Use case Read the most recently used model configuration when resuming a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，不修改会话。  ### Behavior and side effects Read-only; the conversation is unchanged.  ### 后续调用 继续提交消息或展示当前模型。  ### Next step Submit another message or display the current model.  ### 接口摘要 读取会话配置 / Get conversation configuration  ### Operation summary 读取会话配置 / Get conversation configuration
      * 读取会话配置 / Get conversation configuration
      */
     getConversationConfig(requestParameters: GetConversationConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationConfig>;

package/dist/esm/apis/ConfigurationApi.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Lingya Agents OpenAPI
- * Public, tenant-scoped Agent channel API authenticated with OPENAPI-HMAC-SHA256-V1. Studio administration endpoints are not part of this contract.
+ * 本契约描述灵涯 Agents 面向可信服务端的公开渠道 API，使用 OPENAPI-HMAC-SHA256-V1 验证请求，不包含 Studio 管理接口。在线文档只展示请求，不会在浏览器中收集或保存 secret。  This contract describes the public Lingya Agents channel API for trusted servers. Requests use OPENAPI-HMAC-SHA256-V1, and Studio administration endpoints are excluded. The online reference only displays requests and never collects or stores a secret in the browser.  ## 快速开始 / Quick start  1. 读取 Configuration，确认模型和附件限制。 / Read Configuration to discover model and attachment limits.  2. 在本地固定最终 method、raw path、raw query、Content-Type 和 body 字节，再生成签名。 / Finalize method, raw path, raw query, Content-Type, and body bytes locally before signing.  3. 按业务分组调用接口；SSE 断开后使用 Events 补取。 / Call the appropriate business group and use Events for recovery after an SSE disconnect.  ## 公共错误 / Common errors  `401` 签名、时间戳或 nonce 无效；`403` 资源不属于当前渠道用户；`413` 请求体过大；`422` 参数校验失败；`429` 请求过于频繁；`500` 服务内部错误；`503` 依赖或执行服务暂不可用。  `401` invalid signature, timestamp, or nonce; `403` resource not owned by the current channel user; `413` request body too large; `422` validation failed; `429` rate limited; `500` internal error; `503` dependency or execution service unavailable.
  *
- * The version of the OpenAPI document: 0.1.2
+ * The version of the OpenAPI document: 0.1.5
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -21,6 +21,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
+import { AgentsConfigFromJSON, } from '../models/AgentsConfig';
+import { ConversationConfigFromJSON, } from '../models/ConversationConfig';
 /**
  *
  */
@@ -61,18 +63,18 @@ export class ConfigurationApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取 Agent 配置 / Get Agent configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在初始化客户端能力或展示模型选择器前读取渠道配置。  ### Use case Read channel configuration before initializing client capabilities or showing model choices.  ### 前置条件 仅需有效渠道凭证。  ### Prerequisites Only valid channel credentials are required.  ### 行为与副作用 只读，不修改配置。  ### Behavior and side effects Read-only; no configuration is changed.  ### 后续调用 按附件限制准备文件，或创建会话。  ### Next step Prepare files according to the limits or create a conversation.  ### 接口摘要 读取 Agent 配置 / Get Agent configuration  ### Operation summary 读取 Agent 配置 / Get Agent configuration
      * 读取 Agent 配置 / Get Agent configuration
      */
     getAgentsConfigRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getAgentsConfigRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => AgentsConfigFromJSON(jsonValue));
         });
     }
     /**
-     * 读取 Agent 配置 / Get Agent configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 在初始化客户端能力或展示模型选择器前读取渠道配置。  ### Use case Read channel configuration before initializing client capabilities or showing model choices.  ### 前置条件 仅需有效渠道凭证。  ### Prerequisites Only valid channel credentials are required.  ### 行为与副作用 只读，不修改配置。  ### Behavior and side effects Read-only; no configuration is changed.  ### 后续调用 按附件限制准备文件，或创建会话。  ### Next step Prepare files according to the limits or create a conversation.  ### 接口摘要 读取 Agent 配置 / Get Agent configuration  ### Operation summary 读取 Agent 配置 / Get Agent configuration
      * 读取 Agent 配置 / Get Agent configuration
      */
     getAgentsConfig(requestParameters, initOverrides) {
@@ -121,18 +123,18 @@ export class ConfigurationApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 读取会话配置 / Get conversation configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复会话时读取该会话最近使用的模型配置。  ### Use case Read the most recently used model configuration when resuming a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，不修改会话。  ### Behavior and side effects Read-only; the conversation is unchanged.  ### 后续调用 继续提交消息或展示当前模型。  ### Next step Submit another message or display the current model.  ### 接口摘要 读取会话配置 / Get conversation configuration  ### Operation summary 读取会话配置 / Get conversation configuration
      * 读取会话配置 / Get conversation configuration
      */
     getConversationConfigRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.getConversationConfigRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => ConversationConfigFromJSON(jsonValue));
         });
     }
     /**
-     * 读取会话配置 / Get conversation configuration 请求会在身份验签和资源归属校验后执行；响应字段以本契约为准。 / The request runs after signature and resource-ownership validation; this contract defines the response fields.
+     * ### 使用场景 恢复会话时读取该会话最近使用的模型配置。  ### Use case Read the most recently used model configuration when resuming a conversation.  ### 前置条件 渠道凭证和外部用户已配置，目标资源属于当前用户。  ### Prerequisites Channel credentials and the external user are configured, and the target resource belongs to that user.  ### 行为与副作用 只读，不修改会话。  ### Behavior and side effects Read-only; the conversation is unchanged.  ### 后续调用 继续提交消息或展示当前模型。  ### Next step Submit another message or display the current model.  ### 接口摘要 读取会话配置 / Get conversation configuration  ### Operation summary 读取会话配置 / Get conversation configuration
      * 读取会话配置 / Get conversation configuration
      */
     getConversationConfig(requestParameters, initOverrides) {