@lingya-ai/agents-sdk 0.5.0 → 0.7.0

package/dist/bound.d.ts

@@ -1,39 +1,137 @@
-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 SyncConversationAsyncTasksRequest, type GetConversationAsyncTaskRequest, type ListConversationSubagentsRequest, type SyncConversationSubagentsRequest, type GetConversationSubagentRequest, type CancelConversationSubagentRequest, type GetConversationSubagentResultRequest, 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 { 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 GetAgentsConfigRequest, type GetConversationConfigRequest, type CreateChatRequest, type ContinueChatRequest, type DeleteConversationRequest, type GetConversationSummaryRequest, type StreamChatEventsRequest, type ProbeEventStreamRequest, type InterruptConversationRequest, type CompactConversationRequest, type GetConversationContextUsageRequest, type ListConversationsRequest, type ListActiveConversationsRequest, type ListUnreadConversationsRequest, type QueryConversationActivitiesRequest, type MarkConversationReadRequest, type GetConversationStatsRequest, type GetConversationTitleRequest, type UpdateConversationTitleRequest, type UpdateConversationStatusRequest, type GetSqlQueryResultRequest, type GetSqlQueryChartDataRequest, type ExportSqlQueryResultRequest, type ListConversationMessagesRequest, type GetConversationMessageRequest, type ListConversationAsyncTasksRequest, type SyncConversationAsyncTasksRequest, type GetConversationAsyncTaskRequest, type ListConversationSubagentsRequest, type SyncConversationSubagentsRequest, type GetConversationSubagentRequest, type CancelConversationSubagentRequest, type GetConversationSubagentResultRequest, type CancelQueuedMessageRequest, type GetChatEventsRequest, type GetChatEventsBatchRequest, 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, type CreateOpenApiTokenRequest, type ListConversationGroupsRequest, type CreateConversationGroupRequest, type RenameConversationGroupRequest, type DeleteConversationGroupRequest, type MoveConversationToGroupRequest, type SyncConversationMessagesRequest, type GetMessagePlanStatusRequest, type GetGoalRequest, type EditGoalRequest, type GetGoalHistoryRequest, type PauseGoalRequest, type ResumeGoalRequest, type ClearGoalRequest } 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>;
+import { type DownloadResponse, type RequestOptions } from './lifecycle';
+import { type ChatSubscription, type StreamOptions } from './subscription';
+type BoundRawRequest = (method: string, suffix: string, bodyJson: string | undefined, query: URLSearchParams | undefined, accept: string, requestId?: string, signal?: AbortSignal) => Promise<Response>;
 /** Query values and optional request headers that are not bound by the client. */
-export type StreamChatEventsOptions = Omit<StreamChatEventsRequest, 'channelId' | 'conversationId' | 'aiChatStreamInput'>;
+export type GetAgentsConfigOptions = Omit<GetAgentsConfigRequest, 'channelId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ProbeEventStreamOptions = Omit<ProbeEventStreamRequest, 'channelId' | 'chatStreamProbeInput'>;
+export type GetConversationConfigOptions = Omit<GetConversationConfigRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type CompactConversationOptions = Omit<CompactConversationRequest, 'channelId' | 'conversationId'>;
+export type CreateChatOptions = Omit<CreateChatRequest, 'channelId' | 'aiChatInput'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ListConversationsOptions = Omit<ListConversationsRequest, 'channelId'>;
+export type ContinueChatOptions = Omit<ContinueChatRequest, 'channelId' | 'conversationId' | 'aiChatInput'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type GetSqlQueryResultOptions = Omit<GetSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'>;
+export type DeleteConversationOptions = Omit<DeleteConversationRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ExportSqlQueryResultOptions = Omit<ExportSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'>;
+export type GetConversationSummaryOptions = Omit<GetConversationSummaryRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ListConversationMessagesOptions = Omit<ListConversationMessagesRequest, 'channelId' | 'conversationId'>;
+export type StreamChatEventsOptions = Omit<StreamChatEventsRequest, 'channelId' | 'conversationId' | 'aiChatStreamInput'> & StreamOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ListConversationAsyncTasksOptions = Omit<ListConversationAsyncTasksRequest, 'channelId' | 'conversationId'>;
+export type ProbeEventStreamOptions = Omit<ProbeEventStreamRequest, 'channelId' | 'chatStreamProbeInput'> & StreamOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type SyncConversationAsyncTasksOptions = Omit<SyncConversationAsyncTasksRequest, 'channelId' | 'conversationId'>;
+export type InterruptConversationOptions = Omit<InterruptConversationRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ListConversationSubagentsOptions = Omit<ListConversationSubagentsRequest, 'channelId' | 'conversationId'>;
+export type CompactConversationOptions = Omit<CompactConversationRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type SyncConversationSubagentsOptions = Omit<SyncConversationSubagentsRequest, 'channelId' | 'conversationId'>;
+export type GetConversationContextUsageOptions = Omit<GetConversationContextUsageRequest, 'channelId' | 'conversationId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type GetChatEventsOptions = Omit<GetChatEventsRequest, 'channelId'>;
+export type ListConversationsOptions = Omit<ListConversationsRequest, 'channelId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type GetUserInputStatusOptions = Omit<GetUserInputStatusRequest, 'channelId' | 'questionId'>;
+export type ListActiveConversationsOptions = Omit<ListActiveConversationsRequest, 'channelId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type FileExistsByContentMd5Options = Omit<FileExistsByContentMd5Request, 'channelId'>;
+export type ListUnreadConversationsOptions = Omit<ListUnreadConversationsRequest, 'channelId'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type ListWorkspaceArtifactsOptions = Omit<ListWorkspaceArtifactsRequest, 'channelId' | 'conversationId'>;
+export type QueryConversationActivitiesOptions = Omit<QueryConversationActivitiesRequest, 'channelId' | 'conversationActivityBatchInput'> & RequestOptions;
 /** Query values and optional request headers that are not bound by the client. */
-export type GetWorkspaceFilePreviewOptions = Omit<GetWorkspaceFilePreviewRequest, 'channelId' | 'conversationId'>;
+export type MarkConversationReadOptions = Omit<MarkConversationReadRequest, 'channelId' | 'conversationId' | 'conversationReadReceiptInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationStatsOptions = Omit<GetConversationStatsRequest, 'channelId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationTitleOptions = Omit<GetConversationTitleRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type UpdateConversationTitleOptions = Omit<UpdateConversationTitleRequest, 'channelId' | 'conversationId' | 'conversationTitleInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type UpdateConversationStatusOptions = Omit<UpdateConversationStatusRequest, 'channelId' | 'conversationId' | 'conversationStatusInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetSqlQueryResultOptions = Omit<GetSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetSqlQueryChartDataOptions = Omit<GetSqlQueryChartDataRequest, 'channelId' | 'conversationId' | 'resultId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ExportSqlQueryResultOptions = Omit<ExportSqlQueryResultRequest, 'channelId' | 'conversationId' | 'resultId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationMessagesOptions = Omit<ListConversationMessagesRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationMessageOptions = Omit<GetConversationMessageRequest, 'channelId' | 'conversationId' | 'messageId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationAsyncTasksOptions = Omit<ListConversationAsyncTasksRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type SyncConversationAsyncTasksOptions = Omit<SyncConversationAsyncTasksRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationAsyncTaskOptions = Omit<GetConversationAsyncTaskRequest, 'channelId' | 'conversationId' | 'asyncTaskId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationSubagentsOptions = Omit<ListConversationSubagentsRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type SyncConversationSubagentsOptions = Omit<SyncConversationSubagentsRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationSubagentOptions = Omit<GetConversationSubagentRequest, 'channelId' | 'conversationId' | 'subagentTaskId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CancelConversationSubagentOptions = Omit<CancelConversationSubagentRequest, 'channelId' | 'conversationId' | 'subagentTaskId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationSubagentResultOptions = Omit<GetConversationSubagentResultRequest, 'channelId' | 'conversationId' | 'subagentTaskId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CancelQueuedMessageOptions = Omit<CancelQueuedMessageRequest, 'channelId' | 'conversationId' | 'messageId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetChatEventsOptions = Omit<GetChatEventsRequest, 'channelId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetChatEventsBatchOptions = Omit<GetChatEventsBatchRequest, 'channelId' | 'aiChatEventsBatchInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ApprovePlanOptions = Omit<ApprovePlanRequest, 'channelId' | 'planApprovalInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetPlanStatusOptions = Omit<GetPlanStatusRequest, 'channelId' | 'planId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetUserInputStatusOptions = Omit<GetUserInputStatusRequest, 'channelId' | 'questionId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type AnswerUserInputOptions = Omit<AnswerUserInputRequest, 'channelId' | 'userInputAnswerInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CreatePreSignedUploadOptions = Omit<CreatePreSignedUploadRequest, 'channelId' | 'generatePreSignedUrlInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ConfirmPreSignedUploadOptions = Omit<ConfirmPreSignedUploadRequest, 'channelId' | 'confirmUploadInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CreateFileByContentMd5Options = Omit<CreateFileByContentMd5Request, 'channelId' | 'createFileInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type FileExistsByContentMd5Options = Omit<FileExistsByContentMd5Request, 'channelId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetConversationFilePreviewOptions = Omit<GetConversationFilePreviewRequest, 'channelId' | 'conversationId' | 'fileId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetPlanIntermediateFilePreviewOptions = Omit<GetPlanIntermediateFilePreviewRequest, 'channelId' | 'conversationId' | 'messageId' | 'fileId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetCitationMetadataBatchOptions = Omit<GetCitationMetadataBatchRequest, 'channelId' | 'returnedReference'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetCitationMetadataOptions = Omit<GetCitationMetadataRequest, 'channelId' | 'citationType' | 'referenceId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListWorkspaceArtifactsOptions = Omit<ListWorkspaceArtifactsRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetWorkspaceFilePreviewOptions = Omit<GetWorkspaceFilePreviewRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CreateOpenApiTokenOptions = Omit<CreateOpenApiTokenRequest, 'channelId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ListConversationGroupsOptions = Omit<ListConversationGroupsRequest, 'channelId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type CreateConversationGroupOptions = Omit<CreateConversationGroupRequest, 'channelId' | 'conversationGroupNameInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type RenameConversationGroupOptions = Omit<RenameConversationGroupRequest, 'channelId' | 'groupId' | 'conversationGroupNameInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type DeleteConversationGroupOptions = Omit<DeleteConversationGroupRequest, 'channelId' | 'groupId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type MoveConversationToGroupOptions = Omit<MoveConversationToGroupRequest, 'channelId' | 'conversationId' | 'updateConversationGroupInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type SyncConversationMessagesOptions = Omit<SyncConversationMessagesRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetMessagePlanStatusOptions = Omit<GetMessagePlanStatusRequest, 'channelId' | 'conversationId' | 'messageId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetGoalOptions = Omit<GetGoalRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type EditGoalOptions = Omit<EditGoalRequest, 'channelId' | 'conversationId' | 'editAgentGoalInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type GetGoalHistoryOptions = Omit<GetGoalHistoryRequest, 'channelId' | 'conversationId'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type PauseGoalOptions = Omit<PauseGoalRequest, 'channelId' | 'conversationId' | 'agentGoalRefInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ResumeGoalOptions = Omit<ResumeGoalRequest, 'channelId' | 'conversationId' | 'agentGoalRefInput'> & RequestOptions;
+/** Query values and optional request headers that are not bound by the client. */
+export type ClearGoalOptions = Omit<ClearGoalRequest, 'channelId' | 'conversationId' | 'agentGoalRefInput'> & RequestOptions;
 /** Generated APIs retained as an explicit compatibility escape hatch until 1.0. */
 export declare class AgentsLowLevelApis {
     readonly configuration: GeneratedConfigurationApi;
@@ -52,34 +150,42 @@ export declare class AgentsLowLevelApis {
 export declare class ConfigurationApi {
     private readonly channelId;
     private readonly delegate;
-    constructor(channelId: string, delegate: GeneratedConfigurationApi);
+    private readonly tokenAuth;
+    constructor(channelId: string, delegate: GeneratedConfigurationApi, tokenAuth?: boolean);
     /**
      * 读取 Agent 配置 / Get Agent configuration
      *
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getAgentsConfig(): ReturnType<GeneratedConfigurationApi['getAgentsConfig']>;
+    getAgentsConfig(options?: GetAgentsConfigOptions): 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']>;
+    getConversationConfig(conversationId: GetConversationConfigRequest['conversationId'], options?: GetConversationConfigOptions): ReturnType<GeneratedConfigurationApi['getConversationConfig']>;
+    /**
+     * 签发一次性短期渠道令牌 / Create a single-use short-lived channel token
+     *
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    createOpenApiToken(options?: CreateOpenApiTokenOptions): ReturnType<GeneratedConfigurationApi['createOpenApiToken']>;
 }
 /** 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);
+    private readonly subscribe;
+    constructor(channelId: string, delegate: GeneratedChatApi, rawRequest: BoundRawRequest, subscribe: (conversationId: string, input: StreamChatEventsRequest['aiChatStreamInput'], options: StreamChatEventsOptions) => ChatSubscription);
     /**
      * 创建会话并提交消息 / 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']>;
+    createChat(input: CreateChatRequest['aiChatInput'], options?: CreateChatOptions): ReturnType<GeneratedChatApi['createChat']>;
     /**
      * 向已有会话提交消息 / Submit a message to an existing conversation
      *
@@ -87,7 +193,7 @@ export declare class ChatApi {
      * @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']>;
+    continueChat(conversationId: ContinueChatRequest['conversationId'], input: ContinueChatRequest['aiChatInput'], options?: ContinueChatOptions): ReturnType<GeneratedChatApi['continueChat']>;
     /**
      * 订阅消息事件流 / Stream message events
      *
@@ -111,7 +217,7 @@ export declare class ChatApi {
      * @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']>;
+    interruptConversation(conversationId: InterruptConversationRequest['conversationId'], options?: InterruptConversationOptions): ReturnType<GeneratedChatApi['interruptConversation']>;
     /**
      * 压缩会话上下文 / Compact conversation context
      *
@@ -120,6 +226,54 @@ export declare class ChatApi {
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
     compactConversation(conversationId: CompactConversationRequest['conversationId'], options?: CompactConversationOptions): ReturnType<GeneratedChatApi['compactConversation']>;
+    /**
+     * 读取当前目标 / Get current goal
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getGoal(conversationId: GetGoalRequest['conversationId'], options?: GetGoalOptions): ReturnType<GeneratedChatApi['getGoal']>;
+    /**
+     * 编辑目标 / Edit goal
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 编辑目标 / Edit goal 的强类型请求体。 / Typed request body for editGoal.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    editGoal(conversationId: EditGoalRequest['conversationId'], input: EditGoalRequest['editAgentGoalInput'], options?: EditGoalOptions): ReturnType<GeneratedChatApi['editGoal']>;
+    /**
+     * 查询目标历史 / Get goal history
+     *
+     * @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.
+     */
+    getGoalHistory(conversationId: GetGoalHistoryRequest['conversationId'], options?: GetGoalHistoryOptions): ReturnType<GeneratedChatApi['getGoalHistory']>;
+    /**
+     * 暂停目标 / Pause goal
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 暂停目标 / Pause goal 的强类型请求体。 / Typed request body for pauseGoal.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    pauseGoal(conversationId: PauseGoalRequest['conversationId'], input: PauseGoalRequest['agentGoalRefInput'], options?: PauseGoalOptions): ReturnType<GeneratedChatApi['pauseGoal']>;
+    /**
+     * 恢复目标 / Resume goal
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 恢复目标 / Resume goal 的强类型请求体。 / Typed request body for resumeGoal.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    resumeGoal(conversationId: ResumeGoalRequest['conversationId'], input: ResumeGoalRequest['agentGoalRefInput'], options?: ResumeGoalOptions): ReturnType<GeneratedChatApi['resumeGoal']>;
+    /**
+     * 清除目标 / Clear goal
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @param input - 清除目标 / Clear goal 的强类型请求体。 / Typed request body for clearGoal.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    clearGoal(conversationId: ClearGoalRequest['conversationId'], input: ClearGoalRequest['agentGoalRefInput'], options?: ClearGoalOptions): ReturnType<GeneratedChatApi['clearGoal']>;
+    subscribeChatEvents(conversationId: string, input: StreamChatEventsRequest['aiChatStreamInput'], options?: StreamChatEventsOptions): ChatSubscription;
 }
 /** Channel-bound conversations operations for one external user. */
 export declare class ConversationsApi {
@@ -132,14 +286,21 @@ export declare class ConversationsApi {
      * @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']>;
+    deleteConversation(conversationId: DeleteConversationRequest['conversationId'], options?: DeleteConversationOptions): ReturnType<GeneratedConversationsApi['deleteConversation']>;
+    /**
+     * 读取会话摘要 / Get conversation summary
+     *
+     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    getConversationSummary(conversationId: GetConversationSummaryRequest['conversationId'], options?: GetConversationSummaryOptions): ReturnType<GeneratedConversationsApi['getConversationSummary']>;
     /**
      * 读取上下文占用 / 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']>;
+    getConversationContextUsage(conversationId: GetConversationContextUsageRequest['conversationId'], options?: GetConversationContextUsageOptions): ReturnType<GeneratedConversationsApi['getConversationContextUsage']>;
     /**
      * 分页查询会话 / List conversations
      *
@@ -152,20 +313,20 @@ export declare class ConversationsApi {
      *
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    listActiveConversations(): ReturnType<GeneratedConversationsApi['listActiveConversations']>;
+    listActiveConversations(options?: ListActiveConversationsOptions): ReturnType<GeneratedConversationsApi['listActiveConversations']>;
     /**
      * 查询未读会话 / List unread conversations
      *
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    listUnreadConversations(): ReturnType<GeneratedConversationsApi['listUnreadConversations']>;
+    listUnreadConversations(options?: ListUnreadConversationsOptions): 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']>;
+    queryConversationActivities(input: QueryConversationActivitiesRequest['conversationActivityBatchInput'], options?: QueryConversationActivitiesOptions): ReturnType<GeneratedConversationsApi['queryConversationActivities']>;
     /**
      * 推进会话已读游标 / Mark a conversation as read
      *
@@ -173,20 +334,20 @@ export declare class ConversationsApi {
      * @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']>;
+    markConversationRead(conversationId: MarkConversationReadRequest['conversationId'], input: MarkConversationReadRequest['conversationReadReceiptInput'], options?: MarkConversationReadOptions): ReturnType<GeneratedConversationsApi['markConversationRead']>;
     /**
      * 读取会话统计 / Get conversation statistics
      *
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getConversationStats(): ReturnType<GeneratedConversationsApi['getConversationStats']>;
+    getConversationStats(options?: GetConversationStatsOptions): 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']>;
+    getConversationTitle(conversationId: GetConversationTitleRequest['conversationId'], options?: GetConversationTitleOptions): ReturnType<GeneratedConversationsApi['getConversationTitle']>;
     /**
      * 更新会话标题 / Update conversation title
      *
@@ -194,7 +355,7 @@ export declare class ConversationsApi {
      * @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']>;
+    updateConversationTitle(conversationId: UpdateConversationTitleRequest['conversationId'], input: UpdateConversationTitleRequest['conversationTitleInput'], options?: UpdateConversationTitleOptions): ReturnType<GeneratedConversationsApi['updateConversationTitle']>;
     /**
      * 更新会话状态 / Update conversation status
      *
@@ -202,30 +363,43 @@ export declare class ConversationsApi {
      * @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']>;
+    updateConversationStatus(conversationId: UpdateConversationStatusRequest['conversationId'], input: UpdateConversationStatusRequest['conversationStatusInput'], options?: UpdateConversationStatusOptions): ReturnType<GeneratedConversationsApi['updateConversationStatus']>;
     /**
-     * 查询会话分享 / List conversation shares
+     * 查询会话分组 / List conversation groups
      *
-     * @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']>;
+    listConversationGroups(options?: ListConversationGroupsOptions): ReturnType<GeneratedConversationsApi['listConversationGroups']>;
     /**
-     * 创建会话分享 / Create a conversation share
+     * 创建会话分组 / Create conversation group
      *
-     * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
-     * @param input - 创建会话分享 / Create a conversation share 的强类型请求体。 / Typed request body for createConversationShare.
+     * @param input - 创建会话分组 / Create conversation group 的强类型请求体。 / Typed request body for createConversationGroup.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    createConversationShare(conversationId: CreateConversationShareRequest['conversationId'], input: CreateConversationShareRequest['conversationShareInput']): ReturnType<GeneratedConversationsApi['createConversationShare']>;
+    createConversationGroup(input: CreateConversationGroupRequest['conversationGroupNameInput'], options?: CreateConversationGroupOptions): ReturnType<GeneratedConversationsApi['createConversationGroup']>;
     /**
-     * 撤销会话分享 / Revoke a conversation share
+     * 重命名会话分组 / Rename conversation group
+     *
+     * @param groupId - 字段 groupId / group id field。
+     * @param input - 重命名会话分组 / Rename conversation group 的强类型请求体。 / Typed request body for renameConversationGroup.
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    renameConversationGroup(groupId: RenameConversationGroupRequest['groupId'], input: RenameConversationGroupRequest['conversationGroupNameInput'], options?: RenameConversationGroupOptions): ReturnType<GeneratedConversationsApi['renameConversationGroup']>;
+    /**
+     * 删除会话分组 / Delete conversation group
+     *
+     * @param groupId - 字段 groupId / group id field。
+     * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
+     */
+    deleteConversationGroup(groupId: DeleteConversationGroupRequest['groupId'], options?: DeleteConversationGroupOptions): ReturnType<GeneratedConversationsApi['deleteConversationGroup']>;
+    /**
+     * 移动会话分组 / Move conversation to group
      *
      * @param conversationId - 会话 ID；必须属于当前外部用户。 / Conversation ID owned by the current external user.
-     * @param shareId - 会话分享记录 ID。 / Conversation-share record ID.
+     * @param input - 移动会话分组 / Move conversation to group 的强类型请求体。 / Typed request body for moveConversationToGroup.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    revokeConversationShare(conversationId: RevokeConversationShareRequest['conversationId'], shareId: RevokeConversationShareRequest['shareId']): ReturnType<GeneratedConversationsApi['revokeConversationShare']>;
+    moveConversationToGroup(conversationId: MoveConversationToGroupRequest['conversationId'], input: MoveConversationToGroupRequest['updateConversationGroupInput'], options?: MoveConversationToGroupOptions): ReturnType<GeneratedConversationsApi['moveConversationToGroup']>;
 }
 /** Channel-bound sql operations for one external user. */
 export declare class SqlApi {
@@ -248,7 +422,7 @@ export declare class SqlApi {
      * @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']>;
+    getSqlQueryChartData(conversationId: GetSqlQueryChartDataRequest['conversationId'], resultId: GetSqlQueryChartDataRequest['resultId'], options?: GetSqlQueryChartDataOptions): ReturnType<GeneratedSQLApi['getSqlQueryChartData']>;
     /**
      * 导出 SQL 结果 / Export SQL results
      *
@@ -258,6 +432,7 @@ export declare class SqlApi {
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
     exportSqlQueryResult(conversationId: ExportSqlQueryResultRequest['conversationId'], resultId: ExportSqlQueryResultRequest['resultId'], options: ExportSqlQueryResultOptions): Promise<Uint8Array>;
+    exportSqlQueryResultWithMetadata(conversationId: ExportSqlQueryResultRequest['conversationId'], resultId: ExportSqlQueryResultRequest['resultId'], options: ExportSqlQueryResultOptions): Promise<DownloadResponse>;
 }
 /** Channel-bound messages operations for one external user. */
 export declare class MessagesApi {
@@ -279,7 +454,7 @@ export declare class MessagesApi {
      * @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']>;
+    getConversationMessage(conversationId: GetConversationMessageRequest['conversationId'], messageId: GetConversationMessageRequest['messageId'], options?: GetConversationMessageOptions): ReturnType<GeneratedMessagesApi['getConversationMessage']>;
     /**
      * 分页查询异步任务 / List asynchronous tasks
      *
@@ -303,7 +478,7 @@ export declare class MessagesApi {
      * @param asyncTaskId - 异步任务 ID。 / Asynchronous task ID.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getConversationAsyncTask(conversationId: GetConversationAsyncTaskRequest['conversationId'], asyncTaskId: GetConversationAsyncTaskRequest['asyncTaskId']): ReturnType<GeneratedMessagesApi['getConversationAsyncTask']>;
+    getConversationAsyncTask(conversationId: GetConversationAsyncTaskRequest['conversationId'], asyncTaskId: GetConversationAsyncTaskRequest['asyncTaskId'], options?: GetConversationAsyncTaskOptions): ReturnType<GeneratedMessagesApi['getConversationAsyncTask']>;
     /**
      * 分页查询子 Agent 任务 / List subagent tasks
      *
@@ -327,7 +502,7 @@ export declare class MessagesApi {
      * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getConversationSubagent(conversationId: GetConversationSubagentRequest['conversationId'], subagentTaskId: GetConversationSubagentRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['getConversationSubagent']>;
+    getConversationSubagent(conversationId: GetConversationSubagentRequest['conversationId'], subagentTaskId: GetConversationSubagentRequest['subagentTaskId'], options?: GetConversationSubagentOptions): ReturnType<GeneratedMessagesApi['getConversationSubagent']>;
     /**
      * 取消子 Agent 任务 / Cancel a subagent task
      *
@@ -335,7 +510,7 @@ export declare class MessagesApi {
      * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    cancelConversationSubagent(conversationId: CancelConversationSubagentRequest['conversationId'], subagentTaskId: CancelConversationSubagentRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['cancelConversationSubagent']>;
+    cancelConversationSubagent(conversationId: CancelConversationSubagentRequest['conversationId'], subagentTaskId: CancelConversationSubagentRequest['subagentTaskId'], options?: CancelConversationSubagentOptions): ReturnType<GeneratedMessagesApi['cancelConversationSubagent']>;
     /**
      * 读取子 Agent 结果 / Get a subagent result
      *
@@ -343,7 +518,7 @@ export declare class MessagesApi {
      * @param subagentTaskId - 子 Agent 任务 ID。 / Subagent task ID.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getConversationSubagentResult(conversationId: GetConversationSubagentResultRequest['conversationId'], subagentTaskId: GetConversationSubagentResultRequest['subagentTaskId']): ReturnType<GeneratedMessagesApi['getConversationSubagentResult']>;
+    getConversationSubagentResult(conversationId: GetConversationSubagentResultRequest['conversationId'], subagentTaskId: GetConversationSubagentResultRequest['subagentTaskId'], options?: GetConversationSubagentResultOptions): ReturnType<GeneratedMessagesApi['getConversationSubagentResult']>;
     /**
      * 取消排队消息 / Cancel a queued message
      *
@@ -351,7 +526,15 @@ export declare class MessagesApi {
      * @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']>;
+    cancelQueuedMessage(conversationId: CancelQueuedMessageRequest['conversationId'], messageId: CancelQueuedMessageRequest['messageId'], options?: CancelQueuedMessageOptions): ReturnType<GeneratedMessagesApi['cancelQueuedMessage']>;
+    /**
+     * 增量同步消息 / Sync 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.
+     */
+    syncConversationMessages(conversationId: SyncConversationMessagesRequest['conversationId'], options?: SyncConversationMessagesOptions): ReturnType<GeneratedMessagesApi['syncConversationMessages']>;
 }
 /** Channel-bound events operations for one external user. */
 export declare class EventsApi {
@@ -371,7 +554,7 @@ export declare class EventsApi {
      * @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']>;
+    getChatEventsBatch(input: GetChatEventsBatchRequest['aiChatEventsBatchInput'], options?: GetChatEventsBatchOptions): ReturnType<GeneratedEventsApi['getChatEventsBatch']>;
 }
 /** Channel-bound interactions operations for one external user. */
 export declare class InteractionsApi {
@@ -384,14 +567,14 @@ export declare class InteractionsApi {
      * @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']>;
+    approvePlan(input: ApprovePlanRequest['planApprovalInput'], options?: ApprovePlanOptions): 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']>;
+    getPlanStatus(planId: GetPlanStatusRequest['planId'], options?: GetPlanStatusOptions): ReturnType<GeneratedInteractionsApi['getPlanStatus']>;
     /**
      * 查询用户问答状态 / Get user-input status
      *
@@ -406,7 +589,15 @@ export declare class InteractionsApi {
      * @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']>;
+    answerUserInput(input: AnswerUserInputRequest['userInputAnswerInput'], options?: AnswerUserInputOptions): ReturnType<GeneratedInteractionsApi['answerUserInput']>;
+    /**
+     * 查询消息计划审批状态 / Get message plan status
+     *
+     * @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.
+     */
+    getMessagePlanStatus(conversationId: GetMessagePlanStatusRequest['conversationId'], messageId: GetMessagePlanStatusRequest['messageId'], options?: GetMessagePlanStatusOptions): ReturnType<GeneratedInteractionsApi['getMessagePlanStatus']>;
 }
 /** Channel-bound files operations for one external user. */
 export declare class FilesApi {
@@ -419,21 +610,21 @@ export declare class FilesApi {
      * @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']>;
+    createPreSignedUpload(input: CreatePreSignedUploadRequest['generatePreSignedUrlInput'], options?: CreatePreSignedUploadOptions): 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']>;
+    confirmPreSignedUpload(input: ConfirmPreSignedUploadRequest['confirmUploadInput'], options?: ConfirmPreSignedUploadOptions): 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']>;
+    createFileByContentMd5(input: CreateFileByContentMd5Request['createFileInput'], options?: CreateFileByContentMd5Options): ReturnType<GeneratedFilesApi['createFileByContentMd5']>;
     /**
      * 检查 MD5 文件是否存在 / Check file existence by MD5
      *
@@ -448,7 +639,7 @@ export declare class FilesApi {
      * @param fileId - 文件记录 ID。 / File record ID.
      * @returns 契约定义的强类型响应。 / The typed response defined by the contract.
      */
-    getConversationFilePreview(conversationId: GetConversationFilePreviewRequest['conversationId'], fileId: GetConversationFilePreviewRequest['fileId']): ReturnType<GeneratedFilesApi['getConversationFilePreview']>;
+    getConversationFilePreview(conversationId: GetConversationFilePreviewRequest['conversationId'], fileId: GetConversationFilePreviewRequest['fileId'], options?: GetConversationFilePreviewOptions): ReturnType<GeneratedFilesApi['getConversationFilePreview']>;
     /**
      * 创建计划快照预览地址 / Create a plan snapshot preview URL
      *
@@ -457,7 +648,7 @@ export declare class FilesApi {
      * @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']>;
+    getPlanIntermediateFilePreview(conversationId: GetPlanIntermediateFilePreviewRequest['conversationId'], messageId: GetPlanIntermediateFilePreviewRequest['messageId'], fileId: GetPlanIntermediateFilePreviewRequest['fileId'], options?: GetPlanIntermediateFilePreviewOptions): ReturnType<GeneratedFilesApi['getPlanIntermediateFilePreview']>;
 }
 /** Channel-bound knowledge operations for one external user. */
 export declare class KnowledgeApi {
@@ -470,7 +661,7 @@ export declare class KnowledgeApi {
      * @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']>;
+    getCitationMetadataBatch(input: GetCitationMetadataBatchRequest['returnedReference'], options?: GetCitationMetadataBatchOptions): ReturnType<GeneratedKnowledgeApi['getCitationMetadataBatch']>;
     /**
      * 读取引用元数据 / Get citation metadata
      *
@@ -478,7 +669,7 @@ export declare class KnowledgeApi {
      * @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']>;
+    getCitationMetadata(citationType: GetCitationMetadataRequest['citationType'], referenceId: GetCitationMetadataRequest['referenceId'], options?: GetCitationMetadataOptions): ReturnType<GeneratedKnowledgeApi['getCitationMetadata']>;
 }
 /** Channel-bound workspace operations for one external user. */
 export declare class WorkspaceApi {