@xpert-ai/contracts 3.13.0 → 3.14.0

package/index.cjs.js

@@ -2146,6 +2146,12 @@ exports.ChatMessageFeedbackRatingEnum = void 0;
     ChatMessageFeedbackRatingEnum["DISLIKE"] = "dislike";
 })(exports.ChatMessageFeedbackRatingEnum || (exports.ChatMessageFeedbackRatingEnum = {}));
 
+var COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING = "copilotCheckpointRetentionDays";
+var COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING = "copilotCheckpointRetentionEnabled";
+var MIN_COPILOT_CHECKPOINT_RETENTION_DAYS = 1;
+var DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS = 60;
+var MAX_COPILOT_CHECKPOINT_RETENTION_DAYS = 3650;
+
 var MEMORY_QA_PROMPT = "Summarize the experience of the above conversation and output a short question and answer.";
 var MEMORY_PROFILE_PROMPT = "Extract new user profile information from the above conversation in one short sentence. If no new information is available, return nothing.";
 
@@ -4977,21 +4983,6 @@ exports.RequestScopeLevel = void 0;
     RequestScopeLevel["ORGANIZATION"] = "organization";
 })(exports.RequestScopeLevel || (exports.RequestScopeLevel = {}));
 
-var IntegrationDingTalkProvider = {
-    name: exports.IntegrationEnum.DINGTALK,
-    label: {
-        en_US: "DingTalk",
-        zh_Hans: "钉钉"
-    },
-    avatar: "dingtalk.svg",
-    webhook: true,
-    schema: {
-        type: "object",
-        properties: {}
-    },
-    pro: true
-};
-
 var IntegrationGitHubProvider = {
     name: exports.IntegrationEnum.GITHUB,
     label: {
@@ -5159,10 +5150,9 @@ function _define_property(obj, key, value) {
     }
     return obj;
 }
-var _obj;
-var INTEGRATION_PROVIDERS = (_obj = {}, // [IntegrationEnum.LARK]: IntegrationLarkProvider,
-_define_property(_obj, exports.IntegrationEnum.DINGTALK, IntegrationDingTalkProvider), // [IntegrationEnum.WECOM]: IntegrationWeComProvider,
-_define_property(_obj, exports.IntegrationEnum.GITHUB, IntegrationGitHubProvider), _obj);
+var INTEGRATION_PROVIDERS = // [IntegrationEnum.LARK]: IntegrationLarkProvider,
+// [IntegrationEnum.WECOM]: IntegrationWeComProvider,
+_define_property({}, exports.IntegrationEnum.GITHUB, IntegrationGitHubProvider);
 
 exports.AiModelTypeEnum = void 0;
 (function(AiModelTypeEnum) {
@@ -5700,10 +5690,14 @@ var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
 
 var ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
 var ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
+var WORKBENCH_NAVIGATION_OPEN_COMMAND = "workbench.navigation.open";
+var ASSISTANT_CITATION_OPEN_EVENT = "assistant.citation.open";
+var KNOWLEDGEBASE_OPEN_CITATION_EFFECT = "knowledgebase.open_citation";
 
 exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.API_PRINCIPAL_USER_ID_HEADER = API_PRINCIPAL_USER_ID_HEADER;
 exports.ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = ASSISTANT_CHAT_SEND_MESSAGE_COMMAND;
+exports.ASSISTANT_CITATION_OPEN_EVENT = ASSISTANT_CITATION_OPEN_EVENT;
 exports.ASSISTANT_CONTEXT_SET_COMMAND = ASSISTANT_CONTEXT_SET_COMMAND;
 exports.Attachment_Type_Options = Attachment_Type_Options;
 exports.CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY;
@@ -5714,6 +5708,9 @@ exports.CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED = CHAT_EVENT_TYPE_THREAD_GOAL_UPDATE
 exports.CONTEXT_COMPRESSION_COMPONENT_TYPE = CONTEXT_COMPRESSION_COMPONENT_TYPE;
 exports.CONTEXT_COMPRESSION_MIDDLEWARE_NAME = CONTEXT_COMPRESSION_MIDDLEWARE_NAME;
 exports.CONTEXT_VARIABLE_CURRENTSTATE = CONTEXT_VARIABLE_CURRENTSTATE;
+exports.COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING = COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING;
+exports.COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING = COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING;
+exports.DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS = DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS;
 exports.DEFAULT_CURRENCIES = DEFAULT_CURRENCIES;
 exports.DEFAULT_DATE_FORMATS = DEFAULT_DATE_FORMATS;
 exports.DEFAULT_INTEGRATION_PAID_FILTERS = DEFAULT_INTEGRATION_PAID_FILTERS;
@@ -5738,6 +5735,7 @@ exports.IteratorIndexParameterName = IteratorIndexParameterName;
 exports.IteratorItemParameterName = IteratorItemParameterName;
 exports.KDocumentSourceType = KDocumentSourceType;
 exports.KDocumentWebTypeOptions = KDocumentWebTypeOptions;
+exports.KNOWLEDGEBASE_OPEN_CITATION_EFFECT = KNOWLEDGEBASE_OPEN_CITATION_EFFECT;
 exports.KNOWLEDGE_DOCUMENTS_NAME = KNOWLEDGE_DOCUMENTS_NAME;
 exports.KNOWLEDGE_FOLDER_ID_NAME = KNOWLEDGE_FOLDER_ID_NAME;
 exports.KNOWLEDGE_SOURCES_NAME = KNOWLEDGE_SOURCES_NAME;
@@ -5746,10 +5744,12 @@ exports.KnowledgeTask = KnowledgeTask;
 exports.KnowledgebaseChannel = KnowledgebaseChannel;
 exports.LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME = LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME;
 exports.LanguagesMap = LanguagesMap;
+exports.MAX_COPILOT_CHECKPOINT_RETENTION_DAYS = MAX_COPILOT_CHECKPOINT_RETENTION_DAYS;
 exports.MCP_APP_RESOURCE_MIME_TYPE = MCP_APP_RESOURCE_MIME_TYPE;
 exports.MDX = schema;
 exports.MEMORY_PROFILE_PROMPT = MEMORY_PROFILE_PROMPT;
 exports.MEMORY_QA_PROMPT = MEMORY_QA_PROMPT;
+exports.MIN_COPILOT_CHECKPOINT_RETENTION_DAYS = MIN_COPILOT_CHECKPOINT_RETENTION_DAYS;
 exports.OllamaEmbeddingsProviders = OllamaEmbeddingsProviders;
 exports.OpenAIEmbeddingsProviders = OpenAIEmbeddingsProviders;
 exports.PLUGIN_COMPONENT_TYPE = PLUGIN_COMPONENT_TYPE;
@@ -5791,6 +5791,7 @@ exports.TOOL_NAME_REGEX = TOOL_NAME_REGEX;
 exports.TranslationLanguageMap = TranslationLanguageMap;
 exports.USAGE_HOUR_FORMAT = USAGE_HOUR_FORMAT;
 exports.VariableOperations = VariableOperations;
+exports.WORKBENCH_NAVIGATION_OPEN_COMMAND = WORKBENCH_NAVIGATION_OPEN_COMMAND;
 exports.WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME = WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME;
 exports.WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER = WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER;
 exports.XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY = XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY;

package/index.esm.js

@@ -2144,6 +2144,12 @@ var ChatMessageFeedbackRatingEnum;
     ChatMessageFeedbackRatingEnum["DISLIKE"] = "dislike";
 })(ChatMessageFeedbackRatingEnum || (ChatMessageFeedbackRatingEnum = {}));
 
+var COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING = "copilotCheckpointRetentionDays";
+var COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING = "copilotCheckpointRetentionEnabled";
+var MIN_COPILOT_CHECKPOINT_RETENTION_DAYS = 1;
+var DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS = 60;
+var MAX_COPILOT_CHECKPOINT_RETENTION_DAYS = 3650;
+
 var MEMORY_QA_PROMPT = "Summarize the experience of the above conversation and output a short question and answer.";
 var MEMORY_PROFILE_PROMPT = "Extract new user profile information from the above conversation in one short sentence. If no new information is available, return nothing.";
 
@@ -4975,21 +4981,6 @@ var RequestScopeLevel;
     RequestScopeLevel["ORGANIZATION"] = "organization";
 })(RequestScopeLevel || (RequestScopeLevel = {}));
 
-var IntegrationDingTalkProvider = {
-    name: IntegrationEnum.DINGTALK,
-    label: {
-        en_US: "DingTalk",
-        zh_Hans: "钉钉"
-    },
-    avatar: "dingtalk.svg",
-    webhook: true,
-    schema: {
-        type: "object",
-        properties: {}
-    },
-    pro: true
-};
-
 var IntegrationGitHubProvider = {
     name: IntegrationEnum.GITHUB,
     label: {
@@ -5157,10 +5148,9 @@ function _define_property(obj, key, value) {
     }
     return obj;
 }
-var _obj;
-var INTEGRATION_PROVIDERS = (_obj = {}, // [IntegrationEnum.LARK]: IntegrationLarkProvider,
-_define_property(_obj, IntegrationEnum.DINGTALK, IntegrationDingTalkProvider), // [IntegrationEnum.WECOM]: IntegrationWeComProvider,
-_define_property(_obj, IntegrationEnum.GITHUB, IntegrationGitHubProvider), _obj);
+var INTEGRATION_PROVIDERS = // [IntegrationEnum.LARK]: IntegrationLarkProvider,
+// [IntegrationEnum.WECOM]: IntegrationWeComProvider,
+_define_property({}, IntegrationEnum.GITHUB, IntegrationGitHubProvider);
 
 var AiModelTypeEnum;
 (function(AiModelTypeEnum) {
@@ -5698,5 +5688,8 @@ var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
 
 var ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
 var ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
+var WORKBENCH_NAVIGATION_OPEN_COMMAND = "workbench.navigation.open";
+var ASSISTANT_CITATION_OPEN_EVENT = "assistant.citation.open";
+var KNOWLEDGEBASE_OPEN_CITATION_EFFECT = "knowledgebase.open_citation";
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, ASSISTANT_CHAT_SEND_MESSAGE_COMMAND, ASSISTANT_CONTEXT_SET_COMMAND, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiKeyBindingType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, AssistantBindingScope, AssistantBindingSourceScope, AssistantCode, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY, CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED, CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE, CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED, CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED, CONTEXT_COMPRESSION_COMPONENT_TYPE, CONTEXT_COMPRESSION_MIDDLEWARE_NAME, CONTEXT_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageEventTypeEnum, ChatMessageFeedbackRatingEnum, ChatMessageStepCategory, ChatMessageTypeEnum, ClientFocusEnum, ConfigurateMethod, ContactOrganizationInviteStatus, ContactType, CredentialFormTypeEnum, CredentialsType, CrudActionEnum, CurrenciesEnum, CurrencyPosition, DEFAULT_CURRENCIES, DEFAULT_DATE_FORMATS, DEFAULT_INTEGRATION_PAID_FILTERS, DEFAULT_INVITE_EXPIRY_PERIOD, DEFAULT_PROFIT_BASED_BONUS, DEFAULT_REVENUE_BASED_BONUS, DEFAULT_SYSTEM_ROLES, DEFAULT_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, DEFAULT_XPERT_AGENT_RECURSION_LIMIT, DataSourceProtocolEnum, DataSourceSyntaxEnum, DataSourceTypeEnum, DefaultValueDateTypeEnum, DocumentSourceProviderCategoryEnum, DocumentTypeEnum, EmailTemplateEnum, EmailTemplateNameEnum, EmbeddingStatusEnum, FILE_VARIABLES, FeatureEnum, FeatureStatusEnum, FeedTypeEnum, FetchFrom, FileStorageProviderEnum, GRAPH_NODE_SUMMARIZE_CONVERSATION, GRAPH_NODE_TITLE_CONVERSATION, HttpStatus, IFeatureToggleTypeEnum, INTEGRATION_PROVIDERS, ImportHistoryStatusEnum, ImportTypeEnum, IndicatorDraftFields, IndicatorOptionFields, IndicatorStatusEnum, IndicatorTagEnum, IndicatorType, IntegrationEnum, IntegrationFeatureEnum, IntegrationFilterEnum, IntegrationGitHubProvider, IntegrationLarkProvider, InterruptMessageType, InvitationExpirationEnum, InvitationTypeEnum, InviteStatusEnum, IteratingIndexParameterName, IteratingItemParameterName, IteratorIndexParameterName, IteratorItemParameterName, KBDocumentCategoryEnum, KBDocumentStatusEnum, KDocumentSourceType, KDocumentWebTypeEnum, KDocumentWebTypeOptions, KNOWLEDGE_DOCUMENTS_NAME, KNOWLEDGE_FOLDER_ID_NAME, KNOWLEDGE_SOURCES_NAME, KNOWLEDGE_STAGE_NAME, KnowledgeGraphIndexJobStatus, KnowledgeGraphStatus, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseStatusEnum, KnowledgebaseTypeEnum, LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME, LanguagesEnum, LanguagesMap, ListsInputTypeEnum, LocalAgentType, LongTermMemoryTypeEnum, MCPServerType, MCP_APP_RESOURCE_MIME_TYPE, schema as MDX, MEMORY_PROFILE_PROMPT, MEMORY_QA_PROMPT, MinimumProjectSizeEnum, ModelEntityType, ModelFeature, ModelPropertyKey, ModelTypeEnum, OllamaEmbeddingsProviders, OpenAIEmbeddingsProviders, OrderTypeEnum, OrganizationContactBudgetTypeEnum, OrganizationDemoNetworkEnum, OrganizationPermissionsEnum, OrganizationProjectBudgetTypeEnum, OrganizationSelectInput, PLUGIN_COMPONENT_TYPE, PLUGIN_CONFIGURATION_STATUS, PLUGIN_LEVEL, PLUGIN_LOAD_STATUS, PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY, PLUGIN_MARKETPLACE_INSTALLATION_POLICY, PLUGIN_MCP_TOOL_APPROVAL_MODE, PLUGIN_RESOURCE_INSTALLATION_STATUS, PLUGIN_RESOURCE_RUNTIME_TYPE, PLUGIN_SOURCE, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RequestScopeLevel, RoleTypeEnum, RolesEnum, SANDBOX_MANAGED_SERVICE_STATUSES, SANDBOX_MANAGED_SERVICE_TRANSPORT_MODES, SANDBOX_TERMINAL_NAMESPACE, SANDBOX_WORK_FOR_TYPES, SMTPSecureEnum, STANDARD_METADATA_FIELDS, STATE_SYS_AGENT_WORKSPACE_PATH, STATE_SYS_MEMORY_WORKSPACE_PATH, STATE_SYS_SESSION_WORKSPACE_PATH, STATE_SYS_SHARED_WORKSPACE_PATH, STATE_SYS_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_ROOT, STATE_SYS_WORKSPACE_URL, STATE_VARIABLE_FILES, STATE_VARIABLE_HUMAN, STATE_VARIABLE_INPUT, STATE_VARIABLE_SYS, STATE_VARIABLE_TITLE_CHANNEL, SandboxManagedServiceErrorCode, SandboxTerminalClientEvent, SandboxTerminalClosedReason, SandboxTerminalErrorCode, SandboxTerminalServerEvent, ScheduleTaskStatus, SecretTokenBindingType, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, THREAD_GOAL_STATUS_VALUES, TOOL_NAME_REGEX, TagCategoryEnum, TaskFrequency, TaskListTypeEnum, TimeGranularity, ToolParameterForm, ToolParameterType, ToolTagEnum, TranslationLanguageMap, USAGE_HOUR_FORMAT, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME, WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY, XPERT_TASK_SCHEDULE_PROPERTY_PREFIX, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, createThreadGoalClearedEvent, createThreadGoalUpdatedEvent, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, ensureAssistantBindingSkillWorkspacePreference, extractSemanticModelDraft, figureOutXpert, filterAssistantBindingDisabledSkillIds, filterAssistantBindingDisabledTools, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantBindingDisabledSkillIds, getAssistantBindingDisabledTools, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, getXpertAgentRecursionLimit, getXpertWorkspaceVisibility, inferMessageAppendContext, isAgentKey, isAgentWorkflowNode, isAgentWorkflowNodeType, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isRunnableThreadGoalStatus, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserAddableAgentMiddleware, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveI18nText, resolveMessageAppendContext, resolveRuntimeXpert, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };
+export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, ASSISTANT_CHAT_SEND_MESSAGE_COMMAND, ASSISTANT_CITATION_OPEN_EVENT, ASSISTANT_CONTEXT_SET_COMMAND, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiKeyBindingType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, AssistantBindingScope, AssistantBindingSourceScope, AssistantCode, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY, CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED, CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE, CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED, CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED, CONTEXT_COMPRESSION_COMPONENT_TYPE, CONTEXT_COMPRESSION_MIDDLEWARE_NAME, CONTEXT_VARIABLE_CURRENTSTATE, COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING, COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageEventTypeEnum, ChatMessageFeedbackRatingEnum, ChatMessageStepCategory, ChatMessageTypeEnum, ClientFocusEnum, ConfigurateMethod, ContactOrganizationInviteStatus, ContactType, CredentialFormTypeEnum, CredentialsType, CrudActionEnum, CurrenciesEnum, CurrencyPosition, DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS, DEFAULT_CURRENCIES, DEFAULT_DATE_FORMATS, DEFAULT_INTEGRATION_PAID_FILTERS, DEFAULT_INVITE_EXPIRY_PERIOD, DEFAULT_PROFIT_BASED_BONUS, DEFAULT_REVENUE_BASED_BONUS, DEFAULT_SYSTEM_ROLES, DEFAULT_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, DEFAULT_XPERT_AGENT_RECURSION_LIMIT, DataSourceProtocolEnum, DataSourceSyntaxEnum, DataSourceTypeEnum, DefaultValueDateTypeEnum, DocumentSourceProviderCategoryEnum, DocumentTypeEnum, EmailTemplateEnum, EmailTemplateNameEnum, EmbeddingStatusEnum, FILE_VARIABLES, FeatureEnum, FeatureStatusEnum, FeedTypeEnum, FetchFrom, FileStorageProviderEnum, GRAPH_NODE_SUMMARIZE_CONVERSATION, GRAPH_NODE_TITLE_CONVERSATION, HttpStatus, IFeatureToggleTypeEnum, INTEGRATION_PROVIDERS, ImportHistoryStatusEnum, ImportTypeEnum, IndicatorDraftFields, IndicatorOptionFields, IndicatorStatusEnum, IndicatorTagEnum, IndicatorType, IntegrationEnum, IntegrationFeatureEnum, IntegrationFilterEnum, IntegrationGitHubProvider, IntegrationLarkProvider, InterruptMessageType, InvitationExpirationEnum, InvitationTypeEnum, InviteStatusEnum, IteratingIndexParameterName, IteratingItemParameterName, IteratorIndexParameterName, IteratorItemParameterName, KBDocumentCategoryEnum, KBDocumentStatusEnum, KDocumentSourceType, KDocumentWebTypeEnum, KDocumentWebTypeOptions, KNOWLEDGEBASE_OPEN_CITATION_EFFECT, KNOWLEDGE_DOCUMENTS_NAME, KNOWLEDGE_FOLDER_ID_NAME, KNOWLEDGE_SOURCES_NAME, KNOWLEDGE_STAGE_NAME, KnowledgeGraphIndexJobStatus, KnowledgeGraphStatus, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseStatusEnum, KnowledgebaseTypeEnum, LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME, LanguagesEnum, LanguagesMap, ListsInputTypeEnum, LocalAgentType, LongTermMemoryTypeEnum, MAX_COPILOT_CHECKPOINT_RETENTION_DAYS, MCPServerType, MCP_APP_RESOURCE_MIME_TYPE, schema as MDX, MEMORY_PROFILE_PROMPT, MEMORY_QA_PROMPT, MIN_COPILOT_CHECKPOINT_RETENTION_DAYS, MinimumProjectSizeEnum, ModelEntityType, ModelFeature, ModelPropertyKey, ModelTypeEnum, OllamaEmbeddingsProviders, OpenAIEmbeddingsProviders, OrderTypeEnum, OrganizationContactBudgetTypeEnum, OrganizationDemoNetworkEnum, OrganizationPermissionsEnum, OrganizationProjectBudgetTypeEnum, OrganizationSelectInput, PLUGIN_COMPONENT_TYPE, PLUGIN_CONFIGURATION_STATUS, PLUGIN_LEVEL, PLUGIN_LOAD_STATUS, PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY, PLUGIN_MARKETPLACE_INSTALLATION_POLICY, PLUGIN_MCP_TOOL_APPROVAL_MODE, PLUGIN_RESOURCE_INSTALLATION_STATUS, PLUGIN_RESOURCE_RUNTIME_TYPE, PLUGIN_SOURCE, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RequestScopeLevel, RoleTypeEnum, RolesEnum, SANDBOX_MANAGED_SERVICE_STATUSES, SANDBOX_MANAGED_SERVICE_TRANSPORT_MODES, SANDBOX_TERMINAL_NAMESPACE, SANDBOX_WORK_FOR_TYPES, SMTPSecureEnum, STANDARD_METADATA_FIELDS, STATE_SYS_AGENT_WORKSPACE_PATH, STATE_SYS_MEMORY_WORKSPACE_PATH, STATE_SYS_SESSION_WORKSPACE_PATH, STATE_SYS_SHARED_WORKSPACE_PATH, STATE_SYS_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_ROOT, STATE_SYS_WORKSPACE_URL, STATE_VARIABLE_FILES, STATE_VARIABLE_HUMAN, STATE_VARIABLE_INPUT, STATE_VARIABLE_SYS, STATE_VARIABLE_TITLE_CHANNEL, SandboxManagedServiceErrorCode, SandboxTerminalClientEvent, SandboxTerminalClosedReason, SandboxTerminalErrorCode, SandboxTerminalServerEvent, ScheduleTaskStatus, SecretTokenBindingType, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, THREAD_GOAL_STATUS_VALUES, TOOL_NAME_REGEX, TagCategoryEnum, TaskFrequency, TaskListTypeEnum, TimeGranularity, ToolParameterForm, ToolParameterType, ToolTagEnum, TranslationLanguageMap, USAGE_HOUR_FORMAT, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WORKBENCH_NAVIGATION_OPEN_COMMAND, WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME, WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY, XPERT_TASK_SCHEDULE_PROPERTY_PREFIX, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, createThreadGoalClearedEvent, createThreadGoalUpdatedEvent, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, ensureAssistantBindingSkillWorkspacePreference, extractSemanticModelDraft, figureOutXpert, filterAssistantBindingDisabledSkillIds, filterAssistantBindingDisabledTools, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantBindingDisabledSkillIds, getAssistantBindingDisabledTools, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, getXpertAgentRecursionLimit, getXpertWorkspaceVisibility, inferMessageAppendContext, isAgentKey, isAgentWorkflowNode, isAgentWorkflowNodeType, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isRunnableThreadGoalStatus, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserAddableAgentMiddleware, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveI18nText, resolveMessageAppendContext, resolveRuntimeXpert, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.13.0",
+  "version": "3.14.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "dependencies": {
-    "@xpert-ai/chatkit-types": "~0.4.1"
+    "@xpert-ai/chatkit-types": "~0.4.2"
   },
   "types": "./index.d.ts"
 }

package/src/ai/chat.model.d.ts

@@ -29,9 +29,14 @@ export type TChatConversationOptions = {
     sandboxEnvironmentId?: string;
     runtimeCapabilities?: RuntimeCapabilitiesSelection;
 };
+export type TChatConversationSourceAudit = {
+    sourceIntegrationId?: string | null;
+    channelType?: string | null;
+    sourceMessageLogIds?: string[];
+};
 export type TChatConversationStatus = 'idle' | 'busy' | 'interrupted' | 'error';
 export type TToolCallType = 'agent' | 'tool';
-export type TChatFrom = 'platform' | 'webapp' | 'debugger' | 'knowledge' | 'job' | 'api' | 'feishu' | 'lark' | 'dingtalk' | 'wecom';
+export type TChatFrom = 'platform' | 'webapp' | 'debugger' | 'knowledge' | 'job' | 'schedule' | 'api' | 'feishu' | 'lark' | 'dingtalk' | 'wechat';
 /**
  * Operation for interrupt
  */
@@ -79,6 +84,10 @@ export interface IChatConversation extends IBasePerTenantAndOrganizationEntityMo
      * Options
      */
     options?: TChatConversationOptions;
+    /**
+     * Stable source audit information for background/channel-triggered conversations.
+     */
+    sourceAudit?: TChatConversationSourceAudit | null;
     /**
      * Error message when status is error
      */
@@ -121,6 +130,9 @@ export interface IChatConversation extends IBasePerTenantAndOrganizationEntityMo
 }
 export type TChatConversationLog = IChatConversation & {
     messageCount: number;
+    sourceIntegrationId?: string | null;
+    channelType?: string | null;
+    sourceMessageLogIds?: string[];
 };
 export interface IChatConversationReadState extends IBasePerTenantAndOrganizationEntityModel {
     conversationId: string;

package/src/ai/copilot-checkpoint.model.d.ts

@@ -1,4 +1,9 @@
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
+export declare const COPILOT_CHECKPOINT_RETENTION_DAYS_SETTING = "copilotCheckpointRetentionDays";
+export declare const COPILOT_CHECKPOINT_RETENTION_ENABLED_SETTING = "copilotCheckpointRetentionEnabled";
+export declare const MIN_COPILOT_CHECKPOINT_RETENTION_DAYS = 1;
+export declare const DEFAULT_COPILOT_CHECKPOINT_RETENTION_DAYS = 60;
+export declare const MAX_COPILOT_CHECKPOINT_RETENTION_DAYS = 3650;
 /**
  * Checkpoints for copilot, for langgraph framework
  */

package/src/ai/knowledge-doc-chunk.model.d.ts

@@ -36,6 +36,8 @@ export interface IDocChunkMetadata {
  * Segmented chunk of a knowledge document
  */
 export interface IKnowledgeDocumentChunk<Metadata extends IDocChunkMetadata = any> extends DocumentInterface<Metadata>, IBasePerTenantAndOrganizationEntityModel {
+    contentHash?: string | null;
+    version?: number;
     documentId?: string;
     document?: IKnowledgeDocument;
     knowledgebaseId?: string;

package/src/ai/knowledge-doc.model.d.ts

@@ -87,6 +87,17 @@ export declare enum KBDocumentStatusEnum {
     FINISH = "finish",
     ERROR = "error"
 }
+export type KnowledgeDocumentIncrementalSyncMode = 'incremental' | 'full' | 'skipped';
+export type KnowledgeDocumentLastIncrementalSync = {
+    mode: KnowledgeDocumentIncrementalSyncMode;
+    total: number;
+    skipped: number;
+    added: number;
+    updated: number;
+    deleted: number;
+    embeddingTokens: number;
+    processedAt: string;
+};
 export type TDocumentWebOptions = TRagWebOptions & {};
 export type TDocSourceConfig = {
     key?: string;
@@ -117,6 +128,26 @@ export type TKnowledgeDocument = {
      */
     sourceType?: DocumentSourceProviderCategoryEnum | DocumentTypeEnum;
     sourceConfig?: TDocSourceConfig;
+    /**
+     * Stable source identity used for ingestion-time incremental sync.
+     */
+    sourceKey?: string | null;
+    /**
+     * Stable hash of the original source bytes or external source content.
+     */
+    sourceHash?: string | null;
+    /**
+     * Stable hash of sourceHash and parser/source processing configuration.
+     */
+    processingHash?: string | null;
+    /**
+     * Stable aggregate hash of the ordered processed chunks.
+     */
+    contentHash?: string | null;
+    /**
+     * Optimistic-lock version for user edits.
+     */
+    version?: number;
     /**
      * document type category
      */
@@ -196,6 +227,7 @@ export interface StandardDocumentMetadata {
     embedTime?: string;
     embedCost?: string | null;
     tokens?: number;
+    lastIncrementalSync?: KnowledgeDocumentLastIncrementalSync;
 }
 export interface KnowledgeDocumentMetadata extends StandardDocumentMetadata {
     [key: string]: any;

package/src/ai/knowledgebase.model.d.ts

@@ -125,6 +125,10 @@ export type TKnowledgebase = {
      * API service enabled
      */
     apiEnabled?: boolean;
+    /**
+     * Enable source matching for newly ingested documents.
+     */
+    incrementalSyncEnabled?: boolean;
     documents?: IKnowledgeDocument[];
     integrationId?: string;
     extKnowledgebaseId?: string;

package/src/ai/types.d.ts

@@ -39,6 +39,14 @@ export declare enum EmbeddingStatusEnum {
 }
 export declare const Attachment_Type_Options: TSelectOption<string, TXpertAttachmentType>[];
 export type JsonSchemaUIExtensions = {
+    /**
+     * Field title used by generic JSON-schema forms.
+     */
+    title?: I18nObject | string;
+    /**
+     * Field description used by generic JSON-schema forms.
+     */
+    description?: I18nObject | string;
     /**
      * UI component variant, or custom component name
      */

package/src/ai/xpert-agent-execution.model.d.ts

@@ -97,9 +97,30 @@ export type TAgentExecutionMetadata = {
     /**
      * AI model provider
      */
-    provider: string;
+    provider?: string;
     /**
      * AI Model
      */
-    model: string;
+    model?: string;
+    triggerSource?: 'integration' | 'channel' | 'api' | 'job' | 'trigger' | string;
+    sourceIntegrationId?: string;
+    integrationId?: string;
+    channelType?: string;
+    channelSource?: string;
+    from?: string;
+    fromEndUserId?: string;
+    channelUserId?: string;
+    uuid?: string;
+    ownerWxid?: string;
+    contactId?: string;
+    chatId?: string;
+    chatType?: string;
+    senderId?: string;
+    sourceMessageLogIds?: string[];
+    handoffMessageId?: string;
+    handoffTraceId?: string;
+    handoffParentMessageId?: string;
+    runtimePrincipalType?: string;
+    runtimePrincipalXpertId?: string;
+    [key: string]: unknown;
 };

package/src/ai/xpert-workflow.model.d.ts

@@ -435,7 +435,7 @@ export interface IWFNAgentTool extends IWFNAgentWorkflow {
 }
 export interface IWFNTrigger extends IWorkflowNode {
     type: WorkflowNodeTypeEnum.TRIGGER;
-    from: 'chat' | 'integration' | 'scheduler';
+    from: string;
     parameters?: TXpertParameter[];
     config?: any;
 }

package/src/ai/xpert.model.d.ts

@@ -544,6 +544,39 @@ export type TChatOptions = {
      */
     context?: Record<string, unknown>;
 };
+export type TChatRuntimePrincipal = {
+    type: 'assistant';
+    xpertId?: string;
+    sourceIntegrationId?: string | null;
+};
+export type TChatSourceAuditOptions = {
+    runtimePrincipal?: TChatRuntimePrincipal;
+    /**
+     * Integration that caused this background run. Kept separate from the
+     * execution principal, which is normally the assistant technical account.
+     */
+    sourceIntegrationId?: string | null;
+    integrationId?: string | null;
+    channelType?: string | null;
+    channelSource?: string | null;
+    channel_source?: string | null;
+    channelUserId?: string | null;
+    uuid?: string | null;
+    ownerWxid?: string | null;
+    contactId?: string | null;
+    contact_id?: string | null;
+    chatId?: string | null;
+    chat_id?: string | null;
+    chatType?: string | null;
+    chat_type?: string | null;
+    senderId?: string | null;
+    sender_id?: string | null;
+    sourceMessageLogIds?: string[];
+    currentInboundLogIds?: string[];
+    handoffMessageId?: string | null;
+    handoffTraceId?: string | null;
+    handoffParentMessageId?: string | null;
+};
 /**
  * Knowledgebase retrieval settings
  */

package/src/integration.model.d.ts

@@ -88,6 +88,7 @@ export type TIntegrationProvider = {
     schema?: TParameterSchema;
     features?: IntegrationFeatureEnum[];
     helpUrl?: string;
+    helpLabel?: I18nObject;
     /**
      * Declarative setup hints consumed by the host integration configuration UI.
      *

package/src/plugin.d.ts

@@ -175,12 +175,20 @@ export interface XpertTemplatePluginAppDependency {
     componentKey: string;
     auth?: 'on_install' | 'on_first_use';
 }
+export interface XpertTemplatePluginToolsetDependency {
+    pluginName?: PluginName;
+    provider: string;
+    templateNodeKey: string;
+    targetAgentKey?: string;
+    instanceName?: string;
+}
 export interface XpertTemplatePluginDependencies {
     plugins?: PluginName[];
     skills?: XpertTemplatePluginSkillDependency[];
     mcpServers?: XpertTemplatePluginMcpServerDependency[];
     hooks?: XpertTemplatePluginHookDependency[];
     apps?: XpertTemplatePluginAppDependency[];
+    toolsets?: XpertTemplatePluginToolsetDependency[];
 }
 export interface PluginMarketplaceContribution {
     id?: string;
@@ -391,6 +399,18 @@ export interface PluginMarketplaceItem {
     marketplacePlugin?: JSONValue | null;
     section?: PluginMarketplaceRegistrySection | string;
 }
+export type PluginMarketplaceReadmeSource = 'installed-package' | 'npm-package' | 'marketplace-metadata' | 'description';
+export interface PluginMarketplaceReadme {
+    locale: string;
+    requestedLocale?: string | null;
+    fileName?: string | null;
+    content: string;
+    source: PluginMarketplaceReadmeSource;
+}
+export interface PluginMarketplaceDetailItem extends PluginMarketplaceItem {
+    readme: PluginMarketplaceReadme;
+    availableReadmeLocales?: string[];
+}
 export interface PluginMarketplaceResponse {
     updatedAt: string | null;
     total: number;

package/src/tenant.model.d.ts

@@ -31,6 +31,8 @@ export interface ISetting {
 }
 export interface ITenantSetting extends S3FileStorageProviderConfig {
     fileStorageProvider?: string;
+    copilotCheckpointRetentionEnabled?: string | null;
+    copilotCheckpointRetentionDays?: string | null;
     tenant_title?: string;
     tenant_title_en?: string;
     tenant_enable_feishu?: boolean;

package/src/view-extension/model.d.ts

@@ -229,6 +229,9 @@ export interface XpertViewClientCommandDefinition {
 }
 export declare const ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
 export declare const ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
+export declare const WORKBENCH_NAVIGATION_OPEN_COMMAND = "workbench.navigation.open";
+export declare const ASSISTANT_CITATION_OPEN_EVENT = "assistant.citation.open";
+export declare const KNOWLEDGEBASE_OPEN_CITATION_EFFECT = "knowledgebase.open_citation";
 /**
  * Action a host should take when a view host event matches a manifest subscription.
  */

package/src/integration/dingtalk.d.ts

@@ -1,2 +0,0 @@
-import { TIntegrationProvider } from '../integration.model';
-export declare const IntegrationDingTalkProvider: TIntegrationProvider;