@xpert-ai/contracts 3.12.1 → 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.";
 
@@ -3821,6 +3827,7 @@ exports.MCPServerType = void 0;
     MCPServerType["CODE"] = "code";
     MCPServerType["HTTP"] = "http";
 })(exports.MCPServerType || (exports.MCPServerType = {}));
+var MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 
 /**
  * Build a hierarchical tree structure from a flat list of DocumentInterface objects,
@@ -4976,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: {
@@ -5158,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) {
@@ -5697,8 +5688,17 @@ var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
     FAILED: "failed"
 };
 
+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;
 exports.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED;
@@ -5708,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;
@@ -5732,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;
@@ -5740,9 +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;
@@ -5784,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.";
 
@@ -3819,6 +3825,7 @@ var MCPServerType;
     MCPServerType["CODE"] = "code";
     MCPServerType["HTTP"] = "http";
 })(MCPServerType || (MCPServerType = {}));
+var MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 
 /**
  * Build a hierarchical tree structure from a flat list of DocumentInterface objects,
@@ -4974,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: {
@@ -5156,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) {
@@ -5695,4 +5686,10 @@ var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
     FAILED: "failed"
 };
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, 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, 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 };
+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_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.12.1",
+  "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.3.13"
+    "@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,7 +130,30 @@ 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;
+    userId: string;
+    lastReadAt: Date | string;
+    lastReadMessageId?: string | null;
+}
+export interface IChatConversationMarkReadRequest {
+    lastReadMessageId?: string | null;
+}
+export interface IChatConversationUnreadXpertsRequest {
+    xpertIds: string[];
+}
+export interface IChatConversationUnreadXpertSummary {
+    xpertId: string;
+    unreadMessages: number;
+    unreadConversations: number;
+    latestUnreadAt?: Date | string | null;
+    latestUnreadConversationId?: string | null;
+    latestUnreadThreadId?: string | null;
+}
 export type ChatMessage = {
     conversationId: string;
     id: 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/index.d.ts

@@ -1,7 +1,7 @@
 export declare const STATE_VARIABLE_HUMAN = "human";
 export { ChatMessageEventTypeEnum, ChatMessageStepCategory, ChatMessageTypeEnum } from './ai.model';
 export type * from '@xpert-ai/chatkit-types';
-export type { TThreadGoalClearedEvent, TThreadGoalUpdatedEvent, ThreadGoalStatus } from '@xpert-ai/chatkit-types';
+export type { IconDefinition, IconType } from '../types';
 export type { TChatRequest } from './xpert-chat.model';
 export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from './chat-event.model';
 export * from './assistant-binding.model';

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-tool-mcp.model.d.ts

@@ -1,3 +1,6 @@
+import type { TMcpAppCsp, TMcpAppPermissions, TMcpAppToolResult, TMcpAppVisibility } from '@xpert-ai/chatkit-types';
+import type { I18nObject } from '../i18n.model';
+import type { IconDefinition } from '../types';
 export declare enum MCPServerType {
     SSE = "sse",
     STDIO = "stdio",
@@ -8,18 +11,19 @@ export declare enum MCPServerType {
  * Configuration for stdio transport connection
  */
 export interface StdioConnection {
-    transport: "stdio";
+    transport: 'stdio';
     command: string;
     args: string[];
     env?: Record<string, string>;
+    stderr?: 'pipe' | 'inherit' | 'ignore' | string;
     encoding?: string;
-    encodingErrorHandler?: "strict" | "ignore" | "replace";
+    encodingErrorHandler?: 'strict' | 'ignore' | 'replace';
 }
 /**
  * Configuration for SSE transport connection
  */
 export interface SSEConnection {
-    transport: "sse";
+    transport: 'sse';
     url: string;
     headers?: Record<string, string>;
     useNodeEventSource?: boolean;
@@ -28,7 +32,7 @@ export interface SSEConnection {
  * Configuration for Streamable HTTP transport connection
  */
 export interface HttpConnection {
-    transport: "http";
+    transport: 'http';
     url: string;
     headers?: Record<string, string>;
     /**
@@ -43,19 +47,44 @@ export type TMCPServerReconnect = {
      */
     enabled?: boolean;
     /**
-      * Maximum number of restart attempts
-      */
+     * Maximum number of restart attempts
+     */
     maxAttempts?: number;
     /**
-      * Delay in milliseconds between restart attempts
-      */
+     * Delay in milliseconds between restart attempts
+     */
     delayMs?: number;
 };
+export type TMcpStdioRuntimePolicy = {
+    /**
+     * Runtime provider requested by the toolset or plugin. v1 supports
+     * local-process; sandbox and sidecar are reserved extension points.
+     */
+    provider?: 'local-process' | 'sandbox' | 'sidecar' | string;
+    /**
+     * Maximum startup wait time in milliseconds.
+     */
+    startupTimeoutMs?: number;
+    /**
+     * Maximum idle lifetime in milliseconds before the host may close the runtime.
+     */
+    idleTimeoutMs?: number;
+    /**
+     * Maximum total lifetime in milliseconds.
+     */
+    maxLifetimeMs?: number;
+    /**
+     * Optional command allow-list requested by the plugin/toolset. The platform
+     * allow-list remains authoritative.
+     */
+    allowedCommands?: string[];
+};
 export type TMCPServer = {
     type: MCPServerType;
     command?: string;
     args?: string[];
     env?: Record<string, string>;
+    stderr?: 'pipe' | 'inherit' | 'ignore' | string;
     encoding?: string;
     encodingErrorHandler?: string;
     /**
@@ -84,8 +113,74 @@ export type TMCPServer = {
      * Init scripts for sandbox
      */
     initScripts?: string;
+    /**
+     * Requested stdio runtime policy. The platform clamps this policy before use.
+     */
+    runtime?: TMcpStdioRuntimePolicy;
 };
 export type TMCPSchema = {
     servers?: Record<string, TMCPServer>;
     mcpServers?: Record<string, TMCPServer>;
 };
+export declare const MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
+export type TMcpAppUiMeta = {
+    resourceUri: string;
+    title?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    /**
+     * @deprecated MCP Apps resource security metadata belongs on the resource
+     * content item `_meta.ui`. Tool-level values are kept only as a legacy
+     * fallback while older plugins migrate.
+     */
+    csp?: TMcpAppCsp;
+    /**
+     * @deprecated MCP Apps resource security metadata belongs on the resource
+     * content item `_meta.ui`. Tool-level values are kept only as a legacy
+     * fallback while older plugins migrate.
+     */
+    permissions?: TMcpAppPermissions;
+    domain?: string;
+    prefersBorder?: boolean;
+};
+export type TMcpToolAppMeta = {
+    serverName: string;
+    name: string;
+    displayName: string;
+    inputSchema?: Record<string, unknown>;
+    visibility: TMcpAppVisibility[];
+    ui?: TMcpAppUiMeta;
+    annotations?: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
+};
+export type TMcpAppComponentData = {
+    type: 'McpApp';
+    appInstanceId: string;
+    appInstanceToken?: string;
+    resourceUri: string;
+    toolName: string;
+    toolCallId?: string;
+    toolsetId?: string;
+    serverName?: string;
+    executionId?: string;
+    title?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    csp?: TMcpAppCsp;
+    permissions?: TMcpAppPermissions;
+    domain?: string;
+    prefersBorder?: boolean;
+    toolInput?: Record<string, unknown>;
+    /**
+     * Standardized initial CallToolResult used to replay MCP App history without
+     * re-running the originating tool. Raw app HTML is never persisted here.
+     */
+    toolResult?: TMcpAppToolResult;
+    /** Serialized byte size of the initial tool result when known. */
+    toolResultSize?: number;
+    /** True when the initial tool result was too large to inline in chat history. */
+    toolResultTruncated?: boolean;
+    visibility?: TMcpAppVisibility[];
+    status?: 'running' | 'success' | 'fail';
+    error?: string;
+};

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

@@ -6,6 +6,7 @@ import { ITag } from '../tag-entity.model';
 import { TCopilotModel } from './copilot-model.model';
 import { Subscriber } from 'rxjs';
 import { I18nObject } from '../types';
+import { TMcpStdioRuntimePolicy } from './xpert-tool-mcp.model';
 export declare enum XpertToolsetCategoryEnum {
     BUILTIN = "builtin",
     API = "api",
@@ -63,6 +64,11 @@ export type TXpertToolsetOptions = {
     toolPositions?: Record<string, number>;
     disableToolDefault?: boolean;
     needSandbox?: boolean;
+    /**
+     * Runtime policy requested for MCP stdio toolsets. The server clamps this
+     * policy against platform and tenant-level security settings.
+     */
+    mcpRuntime?: TMcpStdioRuntimePolicy;
     [key: string]: any;
 };
 /**
@@ -187,6 +193,8 @@ export type TToolsetParams = {
     xpertId?: string;
     conversationId?: string;
     agentKey?: string;
+    executionId?: string;
+    appInstanceId?: string;
     signal?: AbortSignal;
     env: Record<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

@@ -1,6 +1,7 @@
 import { IBasePerTenantAndOrganizationEntityModel } from './base-entity.model';
 import { JsonSchemaObjectType } from './ai/types';
 import type { IXpert } from './ai/xpert.model';
+import type { TMcpStdioRuntimePolicy } from './ai/xpert-tool-mcp.model';
 import type { JSONValue } from './core.model';
 import { IconDefinition, I18nObject } from './types';
 export type PluginName = string;
@@ -120,6 +121,7 @@ export interface XpertPluginMcpServerPolicy {
     enabled?: boolean;
     defaultToolsApprovalMode?: PluginMcpToolApprovalMode;
     enabledTools?: string[];
+    runtime?: TMcpStdioRuntimePolicy;
     tools?: {
         [toolName: string]: {
             approvalMode?: PluginMcpToolApprovalMode;
@@ -173,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;
@@ -389,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

@@ -227,6 +227,11 @@ export interface XpertViewClientCommandDefinition {
     description?: I18nObject;
     permissions?: string[];
 }
+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;