@lingya-ai/agents-sdk 0.1.2 → 0.4.0

package/README.md

@@ -1,45 +1,70 @@
 # 灵涯 Agents TypeScript SDK
 Lingya Agents SDK for TypeScript
 
-这是面向可信 Node.js 服务端的灵涯 Agents OpenAPI 强类型 SDK；契约包含 46 个公共接口，并生成全部请求、响应、事件与工具扩展类型。
-This strongly typed Lingya Agents OpenAPI SDK is designed for trusted Node.js servers. Its contract covers 46 public operations and generates every request, response, event, and tool-extension type.
+用于在 Node.js 可信服务端调用灵涯 Agents OpenAPI。
+Use this SDK to call Lingya Agents OpenAPI from a trusted Node.js server.
 
 ## 安装
 Installation
 
 ```bash
-npm install @lingya-ai/agents-sdk
+npm install @lingya-ai/agents-sdk@0.4.0
 ```
 
-包同时支持 CommonJS `require`、ES module `import` 与 TypeScript 类型声明，运行时要求 Node.js 20 或更高版本。
-The package supports CommonJS `require`, ES module `import`, and TypeScript declarations, and requires Node.js 20 or later.
+运行环境需要 Node.js 20 或更高版本。
+The runtime requires Node.js 20 or later.
 
-## 调用与 SSE
-Calls and SSE
+## 快速开始
+Quick start
 
-```ts
-import { LingyaAgentsClient } from '@lingya-ai/agents-sdk';
+```typescript
+import { AgentsClient } from '@lingya-ai/agents-sdk';
 
-const user = new LingyaAgentsClient('https://lingtong.lingya.tech/', channelId, {
-  accessKey: process.env.OPENAPI_AK!,
-  secretKey: process.env.OPENAPI_SK!,
-}).forUser('external-user-id');
+const user = new AgentsClient(
+  'https://lingtong.lingya.tech/',
+  process.env.OPENAPI_CHANNEL_ID!,
+  {
+    accessKey: process.env.OPENAPI_AK!,
+    secretKey: process.env.OPENAPI_SK!,
+  },
+).forUser('external-user-id');
 
-const submission = await user.chat.createChat({
-  channelId,
-  aiChatInput: { query: '你好' },
-});
+const submission = await user.chat.createChat({ query: '你好' });
+```
+
+`channelId` 只在创建 `AgentsClient` 时提供，业务方法不再接收它。
+Provide `channelId` only when creating `AgentsClient`; business methods do not accept it.
 
-for await (const event of user.streamChatEvents(submission.conversationId, submission.messageId)) {
-  if (event.type === 'end') break;
+## SSE 事件流
+SSE event stream
+
+```typescript
+for await (const event of user.chat.streamChatEvents(
+  submission.conversationId,
+  { messageId: submission.messageId },
+)) {
+  console.log(event.type);
 }
 ```
 
-SDK 会在最终 URL、查询串、`Content-Type` 与正文（body）字节确定后签名；每次请求独立生成 nonce，secret 不会进入请求、日志或异常。
-The SDK signs only after the final URL, query string, `Content-Type`, and body bytes are fixed. Every request receives a fresh nonce, and the secret is never included in requests, logs, or exceptions.
+## API 分组
+API groups
+
+可用分组为 `chat`、`configuration`、`conversations`、`events`、`files`、`interactions`、`knowledge`、`messages`、`sql` 和 `workspace`。
+Available groups are `chat`, `configuration`, `conversations`, `events`, `files`, `interactions`, `knowledge`, `messages`, `sql`, and `workspace`.
 
-未知事件与工具扩展会分别保留为带 `rawJson` 的明确后备类型，已知结构不会退化为动态对象。
-Unknown events and tool extensions are retained in explicit fallback types with `rawJson`; known structures never degrade into dynamic objects.
+## 错误处理
+Error handling
+
+```typescript
+import { ApiError } from '@lingya-ai/agents-sdk';
+
+try {
+  await user.conversations.getConversationTitle('conversation-id');
+} catch (error) {
+  if (error instanceof ApiError) console.error(error.status, error.responseBody);
+}
+```
 
-本 SDK 仅适用于可信服务端，不得在浏览器、桌面或移动客户端中分发 secret。
-This SDK is for trusted servers only. Never distribute the secret in browser, desktop, or mobile applications.
+请只在可信服务端保存 `secretKey`，不要将其放入浏览器、移动端、桌面端或日志。
+Keep `secretKey` on trusted servers only; never put it in browsers, mobile apps, desktop apps, or logs.

package/dist/bound.d.ts

@@ -0,0 +1,472 @@
+import { ConfigurationApi as GeneratedConfigurationApi, ChatApi as GeneratedChatApi, ConversationsApi as GeneratedConversationsApi, SQLApi as GeneratedSQLApi, MessagesApi as GeneratedMessagesApi, EventsApi as GeneratedEventsApi, InteractionsApi as GeneratedInteractionsApi, FilesApi as GeneratedFilesApi, KnowledgeApi as GeneratedKnowledgeApi, WorkspaceApi as GeneratedWorkspaceApi, type GetConversationConfigRequest, type CreateChatRequest, type ContinueChatRequest, type DeleteConversationRequest, type StreamChatEventsRequest, type ProbeEventStreamRequest, type InterruptConversationRequest, type CompactConversationRequest, type GetConversationContextUsageRequest, type ListConversationsRequest, type QueryConversationActivitiesRequest, type MarkConversationReadRequest, type GetConversationTitleRequest, type UpdateConversationTitleRequest, type UpdateConversationStatusRequest, type GetSqlQueryResultRequest, type GetSqlQueryChartDataRequest, type ExportSqlQueryResultRequest, type ListConversationMessagesRequest, type GetConversationMessageRequest, type ListConversationAsyncTasksRequest, type GetConversationAsyncTaskRequest, type CancelQueuedMessageRequest, type GetChatEventsRequest, type GetChatEventsBatchRequest, type ListConversationSharesRequest, type CreateConversationShareRequest, type RevokeConversationShareRequest, type ApprovePlanRequest, type GetPlanStatusRequest, type GetUserInputStatusRequest, type AnswerUserInputRequest, type CreatePreSignedUploadRequest, type ConfirmPreSignedUploadRequest, type CreateFileByContentMd5Request, type FileExistsByContentMd5Request, type GetConversationFilePreviewRequest, type GetPlanIntermediateFilePreviewRequest, type GetCitationMetadataBatchRequest, type GetCitationMetadataRequest, type ListWorkspaceArtifactsRequest, type GetWorkspaceFilePreviewRequest } from './apis';
+import { type ChatStreamProbeEvent } from './models/ChatStreamProbeEvent';
+import { type AiChatBriefEvent } from './events';
+type BoundRawRequest = (method: string, suffix: string, bodyJson: string | undefined, query: URLSearchParams | undefined, accept: string, requestId?: string) => Promise<Response>;
+/** Query values and optional request headers that are not bound by the client. */
+export type StreamChatEventsOptions = Omit<StreamChatEventsRequest, 'channelId' | 'conversationId' | 'aiChatStreamInput'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ProbeEventStreamOptions = Omit<ProbeEventStreamRequest, 'channelId' | 'chatStreamProbeInput'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type CompactConversationOptions = Omit<CompactConversationRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationsOptions = Omit<ListConversationsRequest, 'channelId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetSqlQueryResultOptions = Omit<GetSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ExportSqlQueryResultOptions = Omit<ExportSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationMessagesOptions = Omit<ListConversationMessagesRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationAsyncTasksOptions = Omit<ListConversationAsyncTasksRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetChatEventsOptions = Omit<GetChatEventsRequest, 'channelId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetUserInputStatusOptions = Omit<GetUserInputStatusRequest, 'channelId' | 'questionId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type FileExistsByContentMd5Options = Omit<FileExistsByContentMd5Request, 'channelId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListWorkspaceArtifactsOptions = Omit<ListWorkspaceArtifactsRequest, 'channelId' | 'conversationId'>;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetWorkspaceFilePreviewOptions = Omit<GetWorkspaceFilePreviewRequest, 'channelId' | 'conversationId'>;
+/** Generated APIs retained as an explicit compatibility escape hatch until 1.0. */
+export declare class AgentsLowLevelApis {
+    readonly configuration: GeneratedConfigurationApi;
+    readonly chat: GeneratedChatApi;
+    readonly conversations: GeneratedConversationsApi;
+    readonly sql: GeneratedSQLApi;
+    readonly messages: GeneratedMessagesApi;
+    readonly events: GeneratedEventsApi;
+    readonly interactions: GeneratedInteractionsApi;
+    readonly files: GeneratedFilesApi;
+    readonly knowledge: GeneratedKnowledgeApi;
+    readonly workspace: GeneratedWorkspaceApi;
+    constructor(configuration: GeneratedConfigurationApi, chat: GeneratedChatApi, conversations: GeneratedConversationsApi, sql: GeneratedSQLApi, messages: GeneratedMessagesApi, events: GeneratedEventsApi, interactions: GeneratedInteractionsApi, files: GeneratedFilesApi, knowledge: GeneratedKnowledgeApi, workspace: GeneratedWorkspaceApi);
+}
+/** Channel-bound configuration operations for one external user. */
+export declare class ConfigurationApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedConfigurationApi);
+    /**
+     * 读取 Agent 配置 / Get Agent configuration
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getAgentsConfig(): ReturnType<GeneratedConfigurationApi['getAgentsConfig']>;
+    /**
+     * 读取会话配置 / Get conversation configuration
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationConfig(conversationId: GetConversationConfigRequest['conversationId']): ReturnType<GeneratedConfigurationApi['getConversationConfig']>;
+}
+/** Channel-bound chat operations for one external user. */
+export declare class ChatApi {
+    private readonly channelId;
+    private readonly delegate;
+    private readonly rawRequest;
+    constructor(channelId: string, delegate: GeneratedChatApi, rawRequest: BoundRawRequest);
+    /**
+     * 创建会话并提交消息 / Create a conversation and submit a message
+     *
+     * @param input - 创建会话并提交消息 / Create a conversation and submit a message 的强类型请求体。 / Typed request body for createChat.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    createChat(input: CreateChatRequest['aiChatInput']): ReturnType<GeneratedChatApi['createChat']>;
+    /**
+     * 向已有会话提交消息 / Submit a message to an existing conversation
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 向已有会话提交消息 / Submit a message to an existing conversation 的强类型请求体。 / Typed request body for continueChat.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    continueChat(conversationId: ContinueChatRequest['conversationId'], input: ContinueChatRequest['aiChatInput']): ReturnType<GeneratedChatApi['continueChat']>;
+    /**
+     * 订阅消息事件流 / Stream message events
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 订阅消息事件流 / Stream message events 的强类型请求体。 / Typed request body for streamChatEvents.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 可取消的强类型事件序列。 / A cancellable typed event sequence.
+     */
+    streamChatEvents(conversationId: StreamChatEventsRequest['conversationId'], input: StreamChatEventsRequest['aiChatStreamInput'], options?: StreamChatEventsOptions): AsyncGenerator<AiChatBriefEvent>;
+    /**
+     * 探测 SSE 连接 / Probe the SSE connection
+     *
+     * @param input - 探测 SSE 连接 / Probe the SSE connection 的强类型请求体。 / Typed request body for probeEventStream.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 可取消的强类型事件序列。 / A cancellable typed event sequence.
+     */
+    probeEventStream(input: ProbeEventStreamRequest['chatStreamProbeInput'], options?: ProbeEventStreamOptions): AsyncGenerator<ChatStreamProbeEvent>;
+    /**
+     * 中断会话执行 / Interrupt conversation execution
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    interruptConversation(conversationId: InterruptConversationRequest['conversationId']): ReturnType<GeneratedChatApi['interruptConversation']>;
+    /**
+     * 压缩会话上下文 / Compact conversation context
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    compactConversation(conversationId: CompactConversationRequest['conversationId'], options?: CompactConversationOptions): ReturnType<GeneratedChatApi['compactConversation']>;
+}
+/** Channel-bound conversations operations for one external user. */
+export declare class ConversationsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedConversationsApi);
+    /**
+     * 删除会话 / Delete a conversation
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    deleteConversation(conversationId: DeleteConversationRequest['conversationId']): ReturnType<GeneratedConversationsApi['deleteConversation']>;
+    /**
+     * 读取上下文占用 / Get context usage
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationContextUsage(conversationId: GetConversationContextUsageRequest['conversationId']): ReturnType<GeneratedConversationsApi['getConversationContextUsage']>;
+    /**
+     * 分页查询会话 / List conversations
+     *
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversations(options?: ListConversationsOptions): ReturnType<GeneratedConversationsApi['listConversations']>;
+    /**
+     * 查询活动会话 / List active conversations
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listActiveConversations(): ReturnType<GeneratedConversationsApi['listActiveConversations']>;
+    /**
+     * 查询未读会话 / List unread conversations
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listUnreadConversations(): ReturnType<GeneratedConversationsApi['listUnreadConversations']>;
+    /**
+     * 批量查询会话活动 / Query conversation activities
+     *
+     * @param input - 批量查询会话活动 / Query conversation activities 的强类型请求体。 / Typed request body for queryConversationActivities.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    queryConversationActivities(input: QueryConversationActivitiesRequest['conversationActivityBatchInput']): ReturnType<GeneratedConversationsApi['queryConversationActivities']>;
+    /**
+     * 推进会话已读游标 / Mark a conversation as read
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 推进会话已读游标 / Mark a conversation as read 的强类型请求体。 / Typed request body for markConversationRead.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    markConversationRead(conversationId: MarkConversationReadRequest['conversationId'], input: MarkConversationReadRequest['conversationReadReceiptInput']): ReturnType<GeneratedConversationsApi['markConversationRead']>;
+    /**
+     * 读取会话统计 / Get conversation statistics
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationStats(): ReturnType<GeneratedConversationsApi['getConversationStats']>;
+    /**
+     * 读取会话标题 / Get conversation title
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationTitle(conversationId: GetConversationTitleRequest['conversationId']): ReturnType<GeneratedConversationsApi['getConversationTitle']>;
+    /**
+     * 更新会话标题 / Update conversation title
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 更新会话标题 / Update conversation title 的强类型请求体。 / Typed request body for updateConversationTitle.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    updateConversationTitle(conversationId: UpdateConversationTitleRequest['conversationId'], input: UpdateConversationTitleRequest['conversationTitleInput']): ReturnType<GeneratedConversationsApi['updateConversationTitle']>;
+    /**
+     * 更新会话状态 / Update conversation status
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 更新会话状态 / Update conversation status 的强类型请求体。 / Typed request body for updateConversationStatus.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    updateConversationStatus(conversationId: UpdateConversationStatusRequest['conversationId'], input: UpdateConversationStatusRequest['conversationStatusInput']): ReturnType<GeneratedConversationsApi['updateConversationStatus']>;
+    /**
+     * 查询会话分享 / List conversation shares
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversationShares(conversationId: ListConversationSharesRequest['conversationId']): ReturnType<GeneratedConversationsApi['listConversationShares']>;
+    /**
+     * 创建会话分享 / Create a conversation share
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 创建会话分享 / Create a conversation share 的强类型请求体。 / Typed request body for createConversationShare.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    createConversationShare(conversationId: CreateConversationShareRequest['conversationId'], input: CreateConversationShareRequest['conversationShareInput']): ReturnType<GeneratedConversationsApi['createConversationShare']>;
+    /**
+     * 撤销会话分享 / Revoke a conversation share
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param shareId - 会话分享记录 ID。 / Conversation-share record ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    revokeConversationShare(conversationId: RevokeConversationShareRequest['conversationId'], shareId: RevokeConversationShareRequest['shareId']): ReturnType<GeneratedConversationsApi['revokeConversationShare']>;
+}
+/** Channel-bound sql operations for one external user. */
+export declare class SqlApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedSQLApi);
+    /**
+     * 分页读取 SQL 结果 / Get paged SQL results
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param resultId - SQL 查询结果 ID。 / SQL query-result ID.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getSqlQueryResult(conversationId: GetSqlQueryResultRequest['conversationId'], resultId: GetSqlQueryResultRequest['resultId'], options?: GetSqlQueryResultOptions): ReturnType<GeneratedSQLApi['getSqlQueryResult']>;
+    /**
+     * 读取 SQL 图表数据 / Get SQL chart data
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param resultId - SQL 查询结果 ID。 / SQL query-result ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getSqlQueryChartData(conversationId: GetSqlQueryChartDataRequest['conversationId'], resultId: GetSqlQueryChartDataRequest['resultId']): ReturnType<GeneratedSQLApi['getSqlQueryChartData']>;
+    /**
+     * 导出 SQL 结果 / Export SQL results
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param resultId - SQL 查询结果 ID。 / SQL query-result ID.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    exportSqlQueryResult(conversationId: ExportSqlQueryResultRequest['conversationId'], resultId: ExportSqlQueryResultRequest['resultId'], options: ExportSqlQueryResultOptions): Promise<Uint8Array>;
+}
+/** Channel-bound messages operations for one external user. */
+export declare class MessagesApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedMessagesApi);
+    /**
+     * 分页查询会话消息 / List conversation messages
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversationMessages(conversationId: ListConversationMessagesRequest['conversationId'], options?: ListConversationMessagesOptions): ReturnType<GeneratedMessagesApi['listConversationMessages']>;
+    /**
+     * 读取单条会话消息 / Get a conversation message
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param messageId - 用户消息 ID；必须属于指定会话。 / User-message ID owned by the specified conversation.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationMessage(conversationId: GetConversationMessageRequest['conversationId'], messageId: GetConversationMessageRequest['messageId']): ReturnType<GeneratedMessagesApi['getConversationMessage']>;
+    /**
+     * 分页查询异步任务 / List asynchronous tasks
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversationAsyncTasks(conversationId: ListConversationAsyncTasksRequest['conversationId'], options?: ListConversationAsyncTasksOptions): ReturnType<GeneratedMessagesApi['listConversationAsyncTasks']>;
+    /**
+     * 读取异步任务 / Get an asynchronous task
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param asyncTaskId - 异步任务 ID。 / Asynchronous task ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationAsyncTask(conversationId: GetConversationAsyncTaskRequest['conversationId'], asyncTaskId: GetConversationAsyncTaskRequest['asyncTaskId']): ReturnType<GeneratedMessagesApi['getConversationAsyncTask']>;
+    /**
+     * 取消排队消息 / Cancel a queued message
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param messageId - 用户消息 ID；必须属于指定会话。 / User-message ID owned by the specified conversation.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    cancelQueuedMessage(conversationId: CancelQueuedMessageRequest['conversationId'], messageId: CancelQueuedMessageRequest['messageId']): ReturnType<GeneratedMessagesApi['cancelQueuedMessage']>;
+}
+/** Channel-bound events operations for one external user. */
+export declare class EventsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedEventsApi);
+    /**
+     * 读取消息事件 / Get message events
+     *
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getChatEvents(options: GetChatEventsOptions): ReturnType<GeneratedEventsApi['getChatEvents']>;
+    /**
+     * 批量读取消息事件 / Get message events in batch
+     *
+     * @param input - 批量读取消息事件 / Get message events in batch 的强类型请求体。 / Typed request body for getChatEventsBatch.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getChatEventsBatch(input: GetChatEventsBatchRequest['aiChatEventsBatchInput']): ReturnType<GeneratedEventsApi['getChatEventsBatch']>;
+}
+/** Channel-bound interactions operations for one external user. */
+export declare class InteractionsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedInteractionsApi);
+    /**
+     * 提交计划审批 / Submit plan approval
+     *
+     * @param input - 提交计划审批 / Submit plan approval 的强类型请求体。 / Typed request body for approvePlan.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    approvePlan(input: ApprovePlanRequest['planApprovalInput']): ReturnType<GeneratedInteractionsApi['approvePlan']>;
+    /**
+     * 查询计划审批状态 / Get plan approval status
+     *
+     * @param planId - 等待审批的计划 ID。 / Pending plan-approval ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getPlanStatus(planId: GetPlanStatusRequest['planId']): ReturnType<GeneratedInteractionsApi['getPlanStatus']>;
+    /**
+     * 查询用户问答状态 / Get user-input status
+     *
+     * @param questionId - 等待回答的问题 ID。 / Pending question ID.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getUserInputStatus(questionId: GetUserInputStatusRequest['questionId'], options: GetUserInputStatusOptions): ReturnType<GeneratedInteractionsApi['getUserInputStatus']>;
+    /**
+     * 提交用户回答 / Submit a user answer
+     *
+     * @param input - 提交用户回答 / Submit a user answer 的强类型请求体。 / Typed request body for answerUserInput.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    answerUserInput(input: AnswerUserInputRequest['userInputAnswerInput']): ReturnType<GeneratedInteractionsApi['answerUserInput']>;
+}
+/** Channel-bound files operations for one external user. */
+export declare class FilesApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedFilesApi);
+    /**
+     * 创建预签名上传地址 / Create a presigned upload URL
+     *
+     * @param input - 创建预签名上传地址 / Create a presigned upload URL 的强类型请求体。 / Typed request body for createPreSignedUpload.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    createPreSignedUpload(input: CreatePreSignedUploadRequest['generatePreSignedUrlInput']): ReturnType<GeneratedFilesApi['createPreSignedUpload']>;
+    /**
+     * 确认预签名上传 / Confirm a presigned upload
+     *
+     * @param input - 确认预签名上传 / Confirm a presigned upload 的强类型请求体。 / Typed request body for confirmPreSignedUpload.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    confirmPreSignedUpload(input: ConfirmPreSignedUploadRequest['confirmUploadInput']): ReturnType<GeneratedFilesApi['confirmPreSignedUpload']>;
+    /**
+     * 按 MD5 复用文件 / Reuse a file by MD5
+     *
+     * @param input - 按 MD5 复用文件 / Reuse a file by MD5 的强类型请求体。 / Typed request body for createFileByContentMd5.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    createFileByContentMd5(input: CreateFileByContentMd5Request['createFileInput']): ReturnType<GeneratedFilesApi['createFileByContentMd5']>;
+    /**
+     * 检查 MD5 文件是否存在 / Check file existence by MD5
+     *
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    fileExistsByContentMd5(options: FileExistsByContentMd5Options): ReturnType<GeneratedFilesApi['fileExistsByContentMd5']>;
+    /**
+     * 创建会话文件预览地址 / Create a conversation file preview URL
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param fileId - 文件记录 ID。 / File record ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationFilePreview(conversationId: GetConversationFilePreviewRequest['conversationId'], fileId: GetConversationFilePreviewRequest['fileId']): ReturnType<GeneratedFilesApi['getConversationFilePreview']>;
+    /**
+     * 创建计划快照预览地址 / Create a plan snapshot preview URL
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param messageId - 用户消息 ID；必须属于指定会话。 / User-message ID owned by the specified conversation.
+     * @param fileId - 文件记录 ID。 / File record ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getPlanIntermediateFilePreview(conversationId: GetPlanIntermediateFilePreviewRequest['conversationId'], messageId: GetPlanIntermediateFilePreviewRequest['messageId'], fileId: GetPlanIntermediateFilePreviewRequest['fileId']): ReturnType<GeneratedFilesApi['getPlanIntermediateFilePreview']>;
+}
+/** Channel-bound knowledge operations for one external user. */
+export declare class KnowledgeApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedKnowledgeApi);
+    /**
+     * 批量读取引用元数据 / Get citation metadata in batch
+     *
+     * @param input - 批量读取引用元数据 / Get citation metadata in batch 的强类型请求体。 / Typed request body for getCitationMetadataBatch.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getCitationMetadataBatch(input: GetCitationMetadataBatchRequest['returnedReference']): ReturnType<GeneratedKnowledgeApi['getCitationMetadataBatch']>;
+    /**
+     * 读取引用元数据 / Get citation metadata
+     *
+     * @param citationType - 知识引用类型。 / Knowledge citation type.
+     * @param referenceId - 知识引用记录 ID。 / Knowledge-reference record ID.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getCitationMetadata(citationType: GetCitationMetadataRequest['citationType'], referenceId: GetCitationMetadataRequest['referenceId']): ReturnType<GeneratedKnowledgeApi['getCitationMetadata']>;
+}
+/** Channel-bound workspace operations for one external user. */
+export declare class WorkspaceApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: GeneratedWorkspaceApi);
+    /**
+     * 分页查询工作区制品 / List workspace artifacts
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listWorkspaceArtifacts(conversationId: ListWorkspaceArtifactsRequest['conversationId'], options?: ListWorkspaceArtifactsOptions): ReturnType<GeneratedWorkspaceApi['listWorkspaceArtifacts']>;
+    /**
+     * 创建工作区文件预览地址 / Create a workspace file preview URL
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getWorkspaceFilePreview(conversationId: GetWorkspaceFilePreviewRequest['conversationId'], options: GetWorkspaceFilePreviewOptions): ReturnType<GeneratedWorkspaceApi['getWorkspaceFilePreview']>;
+}
+/** @deprecated Use AgentsLowLevelApis. */
+export { AgentsLowLevelApis as LingyaAgentsLowLevelApis };
+/** @deprecated Use ConfigurationApi. */
+export { ConfigurationApi as LingyaConfigurationApi };
+/** @deprecated Use ChatApi. */
+export { ChatApi as LingyaChatApi };
+/** @deprecated Use ConversationsApi. */
+export { ConversationsApi as LingyaConversationsApi };
+/** @deprecated Use SqlApi. */
+export { SqlApi as LingyaSqlApi };
+/** @deprecated Use MessagesApi. */
+export { MessagesApi as LingyaMessagesApi };
+/** @deprecated Use EventsApi. */
+export { EventsApi as LingyaEventsApi };
+/** @deprecated Use InteractionsApi. */
+export { InteractionsApi as LingyaInteractionsApi };
+/** @deprecated Use FilesApi. */
+export { FilesApi as LingyaFilesApi };
+/** @deprecated Use KnowledgeApi. */
+export { KnowledgeApi as LingyaKnowledgeApi };
+/** @deprecated Use WorkspaceApi. */
+export { WorkspaceApi as LingyaWorkspaceApi };