@univerjs/protocol 0.1.48 → 0.1.49

package/lib/types/ts/universer/v1/conversation.d.ts

@@ -1,6 +1,7 @@
 import { Metadata } from '@grpc/grpc-js';
 import { Observable } from 'rxjs';
-import { SystemHint } from '../../ai_common/common';
+import { OpenAIMessage, SystemHint } from '../../ai_common/common';
+import { Changeset } from '../../univer/changeset';
 import { Error } from '../../univer/constants/errors';
 import { DataFragmentationType } from './analyse_cmn';
 import { RateDetail } from './entitlement';
@@ -10,6 +11,8 @@ export declare enum CompletionStatus {
     Completion_Completed = 1,
     Completion_UserCancelled = 2,
     Completion_SystemErr = 3,
+    /** Completion_Interrupted - like hunman in the loop, and etc... */
+    Completion_Interrupted = 4,
     UNRECOGNIZED = -1
 }
 export declare enum ConversationRoleType {
@@ -23,6 +26,22 @@ export declare enum ContentBlockType {
     ContentBlockType_Prompt = 1,
     ContentBlockType_Thinking = 2,
     ContentBlockType_Report = 3,
+    /** ContentBlockType_PromptV2 - map to json string of the orig SubmitPromptRequest */
+    ContentBlockType_PromptV2 = 4,
+    /** ContentBlockType_HITL - HITL event */
+    ContentBlockType_HITL = 103,
+    /** ContentBlockType_ToolCallStart - tool call start */
+    ContentBlockType_ToolCallStart = 105,
+    /** ContentBlockType_ToolCallResult - tool call end */
+    ContentBlockType_ToolCallResult = 106,
+    /** ContentBlockType_SubAgentsCallStart - sub-agents calls start */
+    ContentBlockType_SubAgentsCallStart = 107,
+    /** ContentBlockType_SubAgentsCallResult - sub-agents calls end */
+    ContentBlockType_SubAgentsCallResult = 108,
+    /** ContentBlockType_SubAgentRunStarted - sub-agent started event */
+    ContentBlockType_SubAgentRunStarted = 109,
+    /** ContentBlockType_SubAgentRunFinished - sub-agent finished event */
+    ContentBlockType_SubAgentRunFinished = 110,
     UNRECOGNIZED = -1
 }
 export declare enum ContentType {
@@ -36,6 +55,7 @@ export declare enum AttachmentType {
     AttachmentType_Unit = 1,
     AttachmentType_Recommendation = 3,
     AttachmentType_DataSource = 4,
+    AttachmentType_HitlAnswer = 5,
     UNRECOGNIZED = -1
 }
 export declare enum MessageReaction {
@@ -66,6 +86,32 @@ export declare enum ChatSSEBlockType {
     ChatSSEBlockType_ChatThinking = 9,
     /** ChatSSEBlockType_Fragmentation - content data fragmentation */
     ChatSSEBlockType_Fragmentation = 10,
+    /**
+     * ChatSSEBlockType_RawMessage - deprecated, raw message from model, just use tool message body, use ChatSSEBlockType_ToolCall instead
+     *
+     * @deprecated
+     */
+    ChatSSEBlockType_RawMessage = 101,
+    /**
+     * ChatSSEBlockType_EditThinking - deprecated, use ChatSSEBlockType_ChatThinking instead
+     *
+     * @deprecated
+     */
+    ChatSSEBlockType_EditThinking = 102,
+    /** ChatSSEBlockType_HITL - HITL event */
+    ChatSSEBlockType_HITL = 103,
+    /** ChatSSEBlockType_ToolCallStart - tool call start */
+    ChatSSEBlockType_ToolCallStart = 105,
+    /** ChatSSEBlockType_ToolCallResult - tool call end */
+    ChatSSEBlockType_ToolCallResult = 106,
+    /** ChatSSEBlockType_SubAgentsCallStart - sub-agents calls start */
+    ChatSSEBlockType_SubAgentsCallStart = 107,
+    /** ChatSSEBlockType_SubAgentsCallResult - sub-agents calls end */
+    ChatSSEBlockType_SubAgentsCallResult = 108,
+    /** ChatSSEBlockType_SubAgentRunStarted - sub-agent started event */
+    ChatSSEBlockType_SubAgentRunStarted = 109,
+    /** ChatSSEBlockType_SubAgentRunFinished - sub-agent finished event */
+    ChatSSEBlockType_SubAgentRunFinished = 110,
     UNRECOGNIZED = -1
 }
 export declare enum ChatSSEStatus {
@@ -128,8 +174,28 @@ export interface Conversation {
     title: string;
     creatorUid: string;
     expireTime: string;
+    /**
+     * version history:
+     * 2512--不支持unit编辑类会话
+     * 2601--统一分析和编辑会话
+     */
+    agentVersion: number;
+    /** this field is nil for old version conversations */
+    limits: ConversationLimits | undefined;
+    /** this field is nil for old version conversations */
+    settings: ConversationSettings | undefined;
     shared: boolean;
 }
+export interface ConversationLimits {
+    /** cumulative tokens used in this conversation */
+    cumulativeTokens: number;
+    /** max allowed tokens in this conversation */
+    maxAllowedTokens: number;
+}
+export interface ConversationSettings {
+    /** add here if more settings needed in the future. */
+    model: string;
+}
 export interface GetConversationRequest {
     conversationId: string;
 }
@@ -154,6 +220,24 @@ export interface ListConversationsResponse {
     nextBatchId: string;
     error: Error | undefined;
 }
+export interface ListConversationsByUnitRequest {
+    /**
+     * batchId,
+     * set to empty in the 1st scroller request,
+     * then set to nextBatchId(which was returned by the previous request) in the following scroller request.
+     */
+    batchId: string;
+    /** limit, specify how many records needed. */
+    limit: number;
+    /** required */
+    unitId: string;
+}
+export interface ListConversationsByUnitResponse {
+    conversations: Conversation[];
+    hasMore: boolean;
+    nextBatchId: string;
+    error: Error | undefined;
+}
 export interface RenameConversationRequest {
     conversationId: string;
     newTitle: string;
@@ -190,6 +274,7 @@ export interface ConversationMessage {
     completionStatus: CompletionStatus;
     contents: ContentBlock[];
     attachments: Attachment[];
+    respMeta: ChatRespMeta | undefined;
 }
 export interface ContentBlock {
     blockType: ContentBlockType;
@@ -204,8 +289,9 @@ export interface Attachment {
      * id of the Attachment,
      * vary with the AttachmentType,
      * AttachmentType_Unit           -> unitId;
-     * AttachmentType_Recommendation -> no ID;
+     * AttachmentType_Recommendation -> no ID needed;
      * AttachmentType_DataSource     -> dataSourceId;
+     * AttachmentType_HitlAnswer     -> no ID needed;
      */
     id: string;
     /**
@@ -213,7 +299,8 @@ export interface Attachment {
      * vary with the AttachmentType,
      * AttachmentType_Unit           -> empty;
      * AttachmentType_Recommendation -> json string of recommendations(json string array);
-     * AttachmentType_DataSource     -> json string of v1.DataSource
+     * AttachmentType_DataSource     -> json string of v1.DataSource;
+     * AttachmentType_HitlAnswer     -> orig string of the hitl answer;
      */
     content: string;
 }
@@ -257,6 +344,12 @@ export interface SubmitPromptRequest {
     systemHints: SystemHint[];
     /** Locale Code */
     locale?: string | undefined;
+    /** optional, if provided, promptText will be ignored */
+    messages: OpenAIMessage[];
+    /** optional, json string array of SelectedRange, only used when messages is provided */
+    selectedRanges: string[];
+    /** optional, eg. "plan", "ask", "agent", "brainstorm" */
+    mode?: string | undefined;
 }
 /** SSE api: /universer-api/conversation/resume */
 export interface ResumeConversationRequest {
@@ -268,6 +361,8 @@ export interface ResumeConversationRequest {
     /** Locale Code */
     locale?: string | undefined;
     model?: string | undefined;
+    /** the question's owner message id which is answer to. */
+    answerToMessageId: string;
 }
 /** SSE api: /universer-api/conversation/reconnect */
 export interface ReconnectConversationRequest {
@@ -277,18 +372,13 @@ export interface ReconnectConversationRequest {
 export interface ChatSSEBlock {
     blockType: ChatSSEBlockType;
     /**
-     * body,
-     * json string identicated by blockType,
-     * ChatSSEBlockType_EndOfStream     -> empty;
-     * ChatSSEBlockType_StreamErr       -> json string of error reason: univer.constants.Error;
-     * ChatSSEBlockType_Reject          -> json string of reject reason: univer.constants.Error;
-     * ChatSSEBlockType_ModConversation -> json string of Conversation;
-     * ChatSSEBlockType_PromptAck       -> json string of PromptAck;
-     * ChatSSEBlockType_ChatContent     -> json string of ChatContentSSEBlock;
-     * ChatSSEBlockType_Attachment      -> json string of Attachment;
-     * ChatSSEBlockType_RespMeta        -> json string of ChatRespMeta;
-     * ChatSSEBlockType_ChatThinking    -> json string of ChatThinkingSSEBlock;
-     * ChatSSEBlockType_Fragmentation   -> json string of ChatFragmentationSSEBlock;
+     * see ai_common/common.proto
+     * ChatSSEBlockType_ToolCallStart       -> json string of ChatToolCallStartSSEBlock;
+     * ChatSSEBlockType_ToolCallResult      -> json string of ChatToolCallResultSSEBlock;
+     * ChatSSEBlockType_SubAgentsCallStart  -> json string of ChatSubAgentsCallStartSSEBlock;
+     * ChatSSEBlockType_SubAgentsCallResult -> json string of ChatSubAgentsCallResultSSEBlock;
+     * ChatSSEBlockType_SubAgentRunStarted  -> json string of ChatSubAgentRunStartedSSEBlock;
+     * ChatSSEBlockType_SubAgentRunFinished -> json string of ChatSubAgentRunFinishedSSEBlock;
      */
     body: string;
     status: ChatSSEStatus;
@@ -314,6 +404,11 @@ export interface PromptAck {
 }
 export interface ChatRespMeta {
     messageId: string;
+    /** cumulative tokens used in this conversation */
+    cumulativeTokens: number;
+    /** max allowed tokens in this conversation */
+    maxAllowedTokens: number;
+    reportable: boolean;
 }
 export interface ConversationDataFragmentation {
     conversationId: string;
@@ -440,10 +535,21 @@ export interface SaveDashboardRequest {
 export interface SaveDashboardResponse {
     error: Error | undefined;
 }
+export interface GetConversationCsRequest {
+    conversationId: string;
+    messageIds: string[];
+}
+export interface GetConversationCsResponse {
+    changesets: Changeset[];
+    startRevision: number;
+    endRevision: number;
+    error: Error | undefined;
+}
 export interface ConversationService {
     GetConversation(request: GetConversationRequest, metadata?: Metadata): Observable<GetConversationResponse>;
     /** the conversation list is order by lastUpdate desc default. */
     ListConversations(request: ListConversationsRequest, metadata?: Metadata): Observable<ListConversationsResponse>;
+    ListConversationsByUnit(request: ListConversationsByUnitRequest, metadata?: Metadata): Observable<ListConversationsByUnitResponse>;
     RenameConversation(request: RenameConversationRequest, metadata?: Metadata): Observable<RenameConversationResponse>;
     ShareConversation(request: ShareConversationRequest, metadata?: Metadata): Observable<ShareConversationResponse>;
     UnshareConversation(request: UnshareConversationRequest, metadata?: Metadata): Observable<UnshareConversationResponse>;
@@ -468,4 +574,5 @@ export interface ConversationService {
     FinishReport(request: FinishReportRequest, metadata?: Metadata): Observable<FinishReportResponse>;
     GetDashboard(request: GetDashboardRequest, metadata?: Metadata): Observable<GetDashboardResponse>;
     SaveDashboard(request: SaveDashboardRequest, metadata?: Metadata): Observable<SaveDashboardResponse>;
+    GetConversationCs(request: GetConversationCsRequest, metadata?: Metadata): Observable<GetConversationCsResponse>;
 }

package/lib/types/ts/universer/v1/entitlement.d.ts

@@ -61,6 +61,12 @@ export declare enum EntitlementItemId {
     BiaoDaUnitDownload = 31,
     /** BiaoDaDashboardDownload - dashboard下载，type=Ability */
     BiaoDaDashboardDownload = 32,
+    /** BiaoDaSuperScrapeRowsRate - 超级模板允许采集行数频控,type=Rate */
+    BiaoDaSuperScrapeRowsRate = 33,
+    /** BiaoDaSuperScrapeFreeTimesRate - 超级模板不限采集行数设置次数频控,type=Rate */
+    BiaoDaSuperScrapeFreeTimesRate = 34,
+    /** BiaoDaVideoScriptExtractTimesRate - 视频脚本提取处理次数频控,type=Rate */
+    BiaoDaVideoScriptExtractTimesRate = 35,
     /** XlsxAIBasicPoints - xlsx.ai 基础积分 */
     XlsxAIBasicPoints = 101,
     UNRECOGNIZED = -1
@@ -75,6 +81,24 @@ export declare enum QuotaSource {
     ReferralQuota = 6,
     UNRECOGNIZED = -1
 }
+export declare enum QuotaUsageReason {
+    NonSpeciedUsage = 0,
+    ScrapeUsage = 1,
+    ChatUsage = 2,
+    ReportUsage = 3,
+    UnitEditUsage = 4,
+    /** TitleUsage - more later */
+    TitleUsage = 5,
+    RecommendationUsage = 6,
+    PromptOptimizationUsage = 7,
+    /** VideoTaskScriptUsage - video task step usages */
+    VideoTaskScriptUsage = 8,
+    VideoTaskScriptAnalysisUsage = 9,
+    VideoTaskStoryboardUsage = 10,
+    VideoTaskReuseUsage = 11,
+    VideoTaskRecreatePromptUsage = 12,
+    UNRECOGNIZED = -1
+}
 export declare enum ProductType {
     NonProduct = 0,
     Recurring = 1,
@@ -245,10 +269,55 @@ export interface ReportQuotaUsageRequest {
     messageId?: string | undefined;
     /** used to aggregate credits cost */
     conversationId?: string | undefined;
+    reason: QuotaUsageReason;
 }
 export interface ReportQuotaUsageResponse {
     error: Error | undefined;
 }
+export interface ListQuotaDetailsRequest {
+    /**
+     * batchId,
+     * set to empty in the 1st scroller request,
+     * then set to nextBatchId(which was returned by the previous request) in the following scroller request.
+     */
+    batchId: string;
+    /** limit, specify how many records needed. */
+    limit: number;
+    quotaKey: string;
+    /** 是否只返回有可用quota的记录？ */
+    availableOnly: boolean;
+}
+export interface ListQuotaDetailsResponse {
+    details: QuotaDetailRecord[];
+    hasMore: boolean;
+    nextBatchId: string;
+    error: Error | undefined;
+}
+export interface ListQuotaUsageRecordsRequest {
+    /**
+     * batchId,
+     * set to empty in the 1st scroller request,
+     * then set to nextBatchId(which was returned by the previous request) in the following scroller request.
+     */
+    batchId: string;
+    /** limit, specify how many records needed. */
+    limit: number;
+    quotaKey: string;
+}
+export interface ListQuotaUsageRecordsResponse {
+    records: QuotaUsageRecord[];
+    hasMore: boolean;
+    nextBatchId: string;
+    error: Error | undefined;
+}
+export interface QuotaUsageRecord {
+    /** precision: seconds */
+    usageTime: string;
+    usageTotal: number;
+    reason: QuotaUsageReason;
+    conversationId?: string | undefined;
+    messageId?: string | undefined;
+}
 export interface GetQuotaItemRequest {
     quotaKey: string;
 }
@@ -259,7 +328,9 @@ export interface GetQuotaItemResponse {
 }
 export interface QuotaDetailRecord {
     source: QuotaSource;
+    /** precision: seconds */
     grantTime: string;
+    /** precision: seconds */
     expireTime: string;
     quotaTotal: number;
     quotaLeft: number;
@@ -286,7 +357,9 @@ export interface Product {
     quotaConfs: {
         [key: string]: QuotaItemConf;
     };
+    /** subscription interval if product_type is Recurring */
     interval: Interval;
+    /** subscription interval count if product_type is Recurring */
     intervalCnt: number;
     /** the origin price */
     price: string;
@@ -296,6 +369,10 @@ export interface Product {
     promotionPrice: string;
     /** optional, how many interval the promotion last, set if there's any promotion and product_type is Recurring */
     promotionIntervalCnt: number;
+    /** work with quotaGrantIntervalCnt. subscription may be yearly, but quota is grant monthly. */
+    quotaGrantInterval: Interval;
+    /** work with quotaGrantInterval */
+    quotaGrantIntervalCnt: number;
     /** optional, the product table name */
     tabName: string;
 }
@@ -565,6 +642,8 @@ export interface EntitlementService {
     MGetEntitlementItemsByUser(request: MGetEntitlementItemsByUserRequest, metadata?: Metadata): Observable<MGetEntitlementItemsByUserResponse>;
     GetQuotaItem(request: GetQuotaItemRequest, metadata?: Metadata): Observable<GetQuotaItemResponse>;
     ReportQuotaUsage(request: ReportQuotaUsageRequest, metadata?: Metadata): Observable<ReportQuotaUsageResponse>;
+    ListQuotaDetails(request: ListQuotaDetailsRequest, metadata?: Metadata): Observable<ListQuotaDetailsResponse>;
+    ListQuotaUsageRecords(request: ListQuotaUsageRecordsRequest, metadata?: Metadata): Observable<ListQuotaUsageRecordsResponse>;
     /** for back-end only, can deduct and add. */
     TakeNItemRateByUser(request: TakeNItemRateByUserRequest, metadata?: Metadata): Observable<TakeNItemRateByUserResponse>;
     /** for front-end only case, just deduct, can not return quota. */

package/lib/types/ts/universer/v1/exchange.d.ts

@@ -28,6 +28,10 @@ export interface ImportRequest {
     scene: ImportScene;
     minSheetColumnCount: number;
     minSheetRowCount: number;
+    /** used for integration with customer system */
+    idempotencyKey?: string | undefined;
+    /** used for integration with customer system, just store and pass through. This metadata will store with the imported unit. */
+    metaData?: string | undefined;
 }
 export interface ImportResponse {
     error: Error | undefined;

package/lib/types/ts/universer/v1/file.d.ts

@@ -16,6 +16,8 @@ export declare enum FileSource {
     UserProfileImg = 5,
     /** ClipsheetFragments - assign UserID, fragmented file will be deleted after 30 days */
     ClipsheetFragments = 6,
+    /** LLMInputData - assign UserID */
+    LLMInputData = 7,
     UNRECOGNIZED = -1
 }
 export declare enum DownloadUrlMode {
@@ -78,11 +80,29 @@ export interface PutFileByIdResponse {
     error: Error | undefined;
     fileId: string;
 }
+export interface SignPutUrlRequest {
+    fileSize: number;
+    name?: string | undefined;
+    source: FileSource;
+}
+export interface SignPutUrlResponse {
+    error: Error | undefined;
+    fileId: string;
+    putUrl: string;
+}
+export interface DeleteFileByIdRequest {
+    fileId: string;
+}
+export interface DeleteFileByIdResponse {
+    error: Error | undefined;
+}
 export interface FileService {
     SignUrl(request: SignUrlRequest, metadata?: Metadata): Observable<SignUrlResponse>;
+    SignPutUrl(request: SignPutUrlRequest, metadata?: Metadata): Observable<SignPutUrlResponse>;
     Upload(request: Observable<FileUploadRequest>, metadata?: Metadata): Observable<UploadResponse>;
     SetUniverGoJson(request: SetUniverGoJsonRequest, metadata?: Metadata): Observable<SetUniverGoJsonResponse>;
     GetUniverGoJson(request: GetUniverGoJsonRequest, metadata?: Metadata): Observable<GetUniverGoJsonResponse>;
     PutTemplateResouce(request: PutTemplateResouceRequest, metadata?: Metadata): Observable<PutTemplateResouceResponse>;
     PutFileById(request: Observable<PutFileByIdRequest>, metadata?: Metadata): Observable<PutFileByIdResponse>;
+    DeleteFileById(request: DeleteFileByIdRequest, metadata?: Metadata): Observable<DeleteFileByIdResponse>;
 }

package/lib/types/ts/universer/v1/history.d.ts

@@ -1,5 +1,6 @@
 import { Metadata } from '@grpc/grpc-js';
 import { Observable } from 'rxjs';
+import { Changeset } from '../../univer/changeset';
 import { Error } from '../../univer/constants/errors';
 import { UniverType } from '../../univer/constants/univer';
 import { User } from '../../univer/permission';
@@ -21,6 +22,7 @@ export interface CreateHistoryResponse {
     error: Error | undefined;
 }
 export interface History {
+    /** @deprecated */
     userId: string;
     unitId: string;
     command: string[];
@@ -31,6 +33,9 @@ export interface History {
     /** additionalFields is a reserved field for future use */
     additionalFields?: string | undefined;
     origin?: HistoryOrigin | undefined;
+    startRevCreateTime: number;
+    endRevCreateTime: number;
+    userIds: string[];
 }
 export interface HistoryListRequest {
     length: number;
@@ -77,8 +82,25 @@ export interface ListHistoryCreatorsResponse_Creator {
     avatar: string;
     origins: HistoryOrigin[];
 }
+export interface GetHistoryCsRequest {
+    unitId: string;
+    startRevision: number;
+    endRevision: number;
+}
+export interface GetHistoryCsResponse {
+    error: Error | undefined;
+    changesets: Changeset[];
+    users: {
+        [key: string]: User;
+    };
+}
+export interface GetHistoryCsResponse_UsersEntry {
+    key: string;
+    value: User | undefined;
+}
 export interface HistoryService {
     GetHistoryList(request: HistoryListRequest, metadata?: Metadata): Observable<HistoryListResponse>;
     CreateHistory(request: CreateHistoryRequest, metadata?: Metadata): Observable<CreateHistoryResponse>;
     ListHistoryCreators(request: ListHistoryCreatorsRequest, metadata?: Metadata): Observable<ListHistoryCreatorsResponse>;
+    GetHistoryCs(request: GetHistoryCsRequest, metadata?: Metadata): Observable<GetHistoryCsResponse>;
 }

package/lib/types/ts/universer/v1/oidc.d.ts

@@ -101,6 +101,54 @@ export interface OIDCLoginStatus {
     origin: string;
     referralCode: string;
 }
+/** 小程序登录请求 */
+export interface MiniProgramLoginRequest {
+    /** 小程序 wx.login() 获取的 code */
+    code: string;
+    /** 登录状态信息（JSON格式的 OIDCLoginStatus） */
+    state: string;
+}
+/** 小程序登录响应 */
+export interface MiniProgramLoginResponse {
+    /** 临时 token，用于后续设置 cookie */
+    cookieToken: string;
+    /** 是否为新注册用户 */
+    isRegister: boolean;
+    needBindPhone: boolean;
+    error: Error | undefined;
+}
+/** 小程序绑定手机号请求 */
+export interface MiniProgramBindPhoneRequest {
+    cookieToken: string;
+    phoneCode: string;
+}
+/** 小程序绑定手机号响应 */
+export interface MiniProgramBindPhoneResponse {
+    success: boolean;
+    error: Error | undefined;
+}
+/** 小程序回调请求（WebView 中调用） */
+export interface MiniProgramCallbackRequest {
+    /** 从 MiniProgramLoginResponse 获取的 token */
+    cookieToken: string;
+    /** 登录成功后跳转的 URL */
+    redirectUri: string;
+}
+/** 小程序回调响应 */
+export interface MiniProgramCallbackResponse {
+    /** 是否成功设置 cookie */
+    success: boolean;
+    error: Error | undefined;
+}
+export interface WechatJSSDKSignatureRequest {
+    url: string;
+}
+export interface WechatJSSDKSignatureResponse {
+    error: Error | undefined;
+    timestamp: number;
+    nonceStr: string;
+    signature: string;
+}
 export interface OIDCService {
     AuthRedirect(request: AuthRedirectRequest, metadata?: Metadata): Observable<AuthRedirectResponse>;
     AuthCallback(request: AuthCallbackRequest, metadata?: Metadata): Observable<AuthCallbackResponse>;
@@ -112,4 +160,8 @@ export interface OIDCService {
     WechatCallback(request: WechatCallbackRequest, metadata?: Metadata): Observable<WechatCallbackResponse>;
     Authorize(request: AuthorizeRequest, metadata?: Metadata): Observable<AuthorizeResponse>;
     ExchangeToken(request: ExchangeTokenRequest, metadata?: Metadata): Observable<ExchangeTokenResponse>;
+    MiniProgramLogin(request: MiniProgramLoginRequest, metadata?: Metadata): Observable<MiniProgramLoginResponse>;
+    MiniProgramBindPhone(request: MiniProgramBindPhoneRequest, metadata?: Metadata): Observable<MiniProgramBindPhoneResponse>;
+    MiniProgramCallback(request: MiniProgramCallbackRequest, metadata?: Metadata): Observable<MiniProgramCallbackResponse>;
+    WechatJSSDKSignature(request: WechatJSSDKSignatureRequest, metadata?: Metadata): Observable<WechatJSSDKSignatureResponse>;
 }

package/lib/types/ts/universer/v1/snapshot.d.ts

@@ -118,6 +118,10 @@ export interface CreateUnitRequest {
     workbookDataJson: string;
     /** univer ai for exchange */
     table?: SheetTable | undefined;
+    /** used for integration with customer system */
+    idempotencyKey?: string | undefined;
+    /** used for integration with customer system, just store and pass through */
+    metaData?: string | undefined;
 }
 export interface CreateUnitResponse {
     error: Error | undefined;

package/lib/types/ts/universer/v1/toolkit.d.ts

@@ -10,6 +10,14 @@ export interface PreviewLinkResponse {
     title: string;
     error: Error | undefined;
 }
+export interface GetXfyunUrlRequest {
+}
+export interface GetXfyunUrlResponse {
+    error: Error | undefined;
+    /** 讯飞语音听写 WebSocket 鉴权 URL */
+    url: string;
+}
 export interface ToolkitService {
     PreviewLink(request: PreviewLinkRequest, metadata?: Metadata): Observable<PreviewLinkResponse>;
+    GetXfyunUrl(request: GetXfyunUrlRequest, metadata?: Metadata): Observable<GetXfyunUrlResponse>;
 }

package/lib/types/ts/universer/v1/user.d.ts

@@ -192,12 +192,86 @@ export interface GetGoogleAccessTokenResponse {
     authUrl: string;
     appId: string;
 }
+export interface AgentClientInfo {
+    name: string;
+    version: string;
+    runtime: string;
+    platform: string;
+    arch: string;
+    hostname: string;
+}
+export interface AgentPublicKey {
+    alg: string;
+    format: string;
+    value: string;
+}
+export interface AgentSignature {
+    alg: string;
+    format: string;
+    value: string;
+}
+export interface AgentFingerprint {
+    fingerprintId: string;
+    quality: string;
+    runtimeClass: string;
+}
+export interface AgentChallenge {
+    challengeId: string;
+    signingInput: string;
+    expiresAt: string;
+}
+export interface AgentCredential {
+    accessToken: string;
+    tokenType: string;
+    expiresAt: string;
+}
+export interface AgentRegisterStartRequest {
+    client: AgentClientInfo | undefined;
+    publicKey: AgentPublicKey | undefined;
+    fingerprint: AgentFingerprint | undefined;
+}
+export interface AgentRegisterStartResponse {
+    error: Error | undefined;
+    registrationId: string;
+    challenge: AgentChallenge | undefined;
+}
+export interface AgentRegisterFinishRequest {
+    registrationId: string;
+    challengeId: string;
+    signature: AgentSignature | undefined;
+}
+export interface AgentRegisterFinishResponse {
+    error: Error | undefined;
+    agentId: string;
+}
+export interface AgentSigninStartRequest {
+    agentId: string;
+    client: AgentClientInfo | undefined;
+}
+export interface AgentSigninStartResponse {
+    error: Error | undefined;
+    challenge: AgentChallenge | undefined;
+}
+export interface AgentSigninFinishRequest {
+    agentId: string;
+    challengeId: string;
+    signature: AgentSignature | undefined;
+}
+export interface AgentSigninFinishResponse {
+    error: Error | undefined;
+    agentId: string;
+    credential: AgentCredential | undefined;
+}
 export interface UserService {
     GetUser(request: GetUserRequest, metadata?: Metadata): Observable<GetUserResponse>;
     GetRawFullUserProfile(request: GetRawFullUserProfileRequest, metadata?: Metadata): Observable<GetRawFullUserProfileResponse>;
     SetUsersTestTag(request: SetUsersTestTagRequest, metadata?: Metadata): Observable<SetUsersTestTagResponse>;
     ListRawFullUserProfile(request: ListRawFullUserProfileRequest, metadata?: Metadata): Observable<ListRawFullUserProfileResponse>;
     AnonymousSignIn(request: AnonymousSignInRequest, metadata?: Metadata): Observable<AnonymousSignInResponse>;
+    AgentRegisterStart(request: AgentRegisterStartRequest, metadata?: Metadata): Observable<AgentRegisterStartResponse>;
+    AgentRegisterFinish(request: AgentRegisterFinishRequest, metadata?: Metadata): Observable<AgentRegisterFinishResponse>;
+    AgentSigninStart(request: AgentSigninStartRequest, metadata?: Metadata): Observable<AgentSigninStartResponse>;
+    AgentSigninFinish(request: AgentSigninFinishRequest, metadata?: Metadata): Observable<AgentSigninFinishResponse>;
     ListUsers(request: ListUsersRequest, metadata?: Metadata): Observable<ListUsersResponse>;
     Logout(request: LogoutRequest, metadata?: Metadata): Observable<LogoutResponse>;
     TransformUser(request: TransformUserRequest, metadata?: Metadata): Observable<TransformUserResponse>;