@lingya-ai/agents-sdk 0.1.2 → 0.3.0

package/README.md

@@ -26,15 +26,20 @@ const user = new LingyaAgentsClient('https://lingtong.lingya.tech/', channelId,
 }).forUser('external-user-id');
 
 const submission = await user.chat.createChat({
-  channelId,
-  aiChatInput: { query: '你好' },
+  query: '你好',
 });
 
-for await (const event of user.streamChatEvents(submission.conversationId, submission.messageId)) {
+for await (const event of user.chat.streamChatEvents(
+  submission.conversationId,
+  { messageId: submission.messageId },
+)) {
   if (event.type === 'end') break;
 }
 ```
 
+十个业务分组覆盖全部 46 个接口；`channelId` 只在根客户端构造时提供，`user.lowLevel` 仅作为迁移入口保留到 1.0。
+Ten business groups cover all 46 operations; provide `channelId` only to the root client, while `user.lowLevel` remains a migration-only escape hatch until 1.0.
+
 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.
 

package/dist/bound.d.ts

@@ -0,0 +1,451 @@
+import { ConfigurationApi, ChatApi, ConversationsApi, SQLApi, MessagesApi, EventsApi, InteractionsApi, FilesApi, KnowledgeApi, WorkspaceApi, 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 LingyaAiChatBriefEvent } 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 LingyaAgentsLowLevelApis {
+    readonly configuration: ConfigurationApi;
+    readonly chat: ChatApi;
+    readonly conversations: ConversationsApi;
+    readonly sql: SQLApi;
+    readonly messages: MessagesApi;
+    readonly events: EventsApi;
+    readonly interactions: InteractionsApi;
+    readonly files: FilesApi;
+    readonly knowledge: KnowledgeApi;
+    readonly workspace: WorkspaceApi;
+    constructor(configuration: ConfigurationApi, chat: ChatApi, conversations: ConversationsApi, sql: SQLApi, messages: MessagesApi, events: EventsApi, interactions: InteractionsApi, files: FilesApi, knowledge: KnowledgeApi, workspace: WorkspaceApi);
+}
+/** Channel-bound configuration operations for one external user. */
+export declare class LingyaConfigurationApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: ConfigurationApi);
+    /**
+     * 读取 Agent 配置 / Get Agent configuration
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getAgentsConfig(): ReturnType<ConfigurationApi['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<ConfigurationApi['getConversationConfig']>;
+}
+/** Channel-bound chat operations for one external user. */
+export declare class LingyaChatApi {
+    private readonly channelId;
+    private readonly delegate;
+    private readonly rawRequest;
+    constructor(channelId: string, delegate: ChatApi, 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<ChatApi['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<ChatApi['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<LingyaAiChatBriefEvent>;
+    /**
+     * 探测 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<ChatApi['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<ChatApi['compactConversation']>;
+}
+/** Channel-bound conversations operations for one external user. */
+export declare class LingyaConversationsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: ConversationsApi);
+    /**
+     * 删除会话 / 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<ConversationsApi['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<ConversationsApi['getConversationContextUsage']>;
+    /**
+     * 分页查询会话 / List conversations
+     *
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listConversations(options?: ListConversationsOptions): ReturnType<ConversationsApi['listConversations']>;
+    /**
+     * 查询活动会话 / List active conversations
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listActiveConversations(): ReturnType<ConversationsApi['listActiveConversations']>;
+    /**
+     * 查询未读会话 / List unread conversations
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    listUnreadConversations(): ReturnType<ConversationsApi['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<ConversationsApi['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<ConversationsApi['markConversationRead']>;
+    /**
+     * 读取会话统计 / Get conversation statistics
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationStats(): ReturnType<ConversationsApi['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<ConversationsApi['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<ConversationsApi['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<ConversationsApi['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<ConversationsApi['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<ConversationsApi['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<ConversationsApi['revokeConversationShare']>;
+}
+/** Channel-bound sql operations for one external user. */
+export declare class LingyaSqlApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: SQLApi);
+    /**
+     * 分页读取 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<SQLApi['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<SQLApi['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 LingyaMessagesApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: MessagesApi);
+    /**
+     * 分页查询会话消息 / 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<MessagesApi['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<MessagesApi['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<MessagesApi['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<MessagesApi['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<MessagesApi['cancelQueuedMessage']>;
+}
+/** Channel-bound events operations for one external user. */
+export declare class LingyaEventsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: EventsApi);
+    /**
+     * 读取消息事件 / Get message events
+     *
+     * @param options - 查询参数与可选请求头。 / Query parameters and optional request headers.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getChatEvents(options: GetChatEventsOptions): ReturnType<EventsApi['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<EventsApi['getChatEventsBatch']>;
+}
+/** Channel-bound interactions operations for one external user. */
+export declare class LingyaInteractionsApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: InteractionsApi);
+    /**
+     * 提交计划审批 / 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<InteractionsApi['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<InteractionsApi['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<InteractionsApi['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<InteractionsApi['answerUserInput']>;
+}
+/** Channel-bound files operations for one external user. */
+export declare class LingyaFilesApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: FilesApi);
+    /**
+     * 创建预签名上传地址 / 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<FilesApi['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<FilesApi['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<FilesApi['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<FilesApi['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<FilesApi['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<FilesApi['getPlanIntermediateFilePreview']>;
+}
+/** Channel-bound knowledge operations for one external user. */
+export declare class LingyaKnowledgeApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: KnowledgeApi);
+    /**
+     * 批量读取引用元数据 / 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<KnowledgeApi['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<KnowledgeApi['getCitationMetadata']>;
+}
+/** Channel-bound workspace operations for one external user. */
+export declare class LingyaWorkspaceApi {
+    private readonly channelId;
+    private readonly delegate;
+    constructor(channelId: string, delegate: WorkspaceApi);
+    /**
+     * 分页查询工作区制品 / 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<WorkspaceApi['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<WorkspaceApi['getWorkspaceFilePreview']>;
+}
+export {};