@xpert-ai/contracts 3.9.1 → 3.9.3

package/index.cjs.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var ShortUniqueId = require('short-unique-id');
+var chatkitTypes = require('@xpert-ai/chatkit-types');
 
 function _array_like_to_array$7(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -1920,7 +1921,6 @@ function _object_spread$7(target) {
 }
 var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
 var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
-var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 function createConversationTitleSummaryEvent(event) {
     return _object_spread$7({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
@@ -1928,7 +1928,7 @@ function createConversationTitleSummaryEvent(event) {
 }
 function createFollowUpConsumedEvent(event) {
     return _object_spread$7({
-        type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
+        type: chatkitTypes.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
     }, event);
 }
 
@@ -2606,6 +2606,13 @@ exports.KnowledgebaseTypeEnum = void 0;
     KnowledgebaseTypeEnum["Standard"] = "standard";
     KnowledgebaseTypeEnum["External"] = "external";
 })(exports.KnowledgebaseTypeEnum || (exports.KnowledgebaseTypeEnum = {}));
+exports.KnowledgebaseStatusEnum = void 0;
+(function(KnowledgebaseStatusEnum) {
+    KnowledgebaseStatusEnum["READY"] = "ready";
+    KnowledgebaseStatusEnum["REBUILD_REQUIRED"] = "rebuild_required";
+    KnowledgebaseStatusEnum["REBUILDING"] = "rebuilding";
+    KnowledgebaseStatusEnum["REBUILD_FAILED"] = "rebuild_failed";
+})(exports.KnowledgebaseStatusEnum || (exports.KnowledgebaseStatusEnum = {}));
 exports.KnowledgeStructureEnum = void 0;
 (function(KnowledgeStructureEnum) {
     KnowledgeStructureEnum["General"] = "general";
@@ -3818,6 +3825,9 @@ function isMiddlewareToolEnabled(config) {
     }
     return (config === null || config === void 0 ? void 0 : config.enabled) !== false;
 }
+function isRequiredMiddleware(entity) {
+    return (entity === null || entity === void 0 ? void 0 : entity.required) === true;
+}
 function genXpertMiddlewareKey() {
     return letterStartSUID("Middleware_");
 }
@@ -5403,11 +5413,14 @@ var PLUGIN_LOAD_STATUS = {
     FAILED: "failed"
 };
 
+Object.defineProperty(exports, "CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED", {
+    enumerable: true,
+    get: function () { return chatkitTypes.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED; }
+});
 exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.API_PRINCIPAL_USER_ID_HEADER = API_PRINCIPAL_USER_ID_HEADER;
 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;
 exports.CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE;
 exports.CONTEXT_COMPRESSION_COMPONENT_TYPE = CONTEXT_COMPRESSION_COMPONENT_TYPE;
 exports.CONTEXT_COMPRESSION_MIDDLEWARE_NAME = CONTEXT_COMPRESSION_MIDDLEWARE_NAME;
@@ -5555,6 +5568,7 @@ exports.isIteratingKey = isIteratingKey;
 exports.isIteratorKey = isIteratorKey;
 exports.isMessageGroup = isMessageGroup;
 exports.isMiddlewareToolEnabled = isMiddlewareToolEnabled;
+exports.isRequiredMiddleware = isRequiredMiddleware;
 exports.isRouterKey = isRouterKey;
 exports.isSystemManagedAssistant = isSystemManagedAssistant;
 exports.isTenantSharedXpertWorkspace = isTenantSharedXpertWorkspace;

package/index.esm.js

@@ -1,4 +1,6 @@
 import ShortUniqueId from 'short-unique-id';
+import { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from '@xpert-ai/chatkit-types';
+export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from '@xpert-ai/chatkit-types';
 
 function _array_like_to_array$7(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -1918,7 +1920,6 @@ function _object_spread$7(target) {
 }
 var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
 var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
-var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 function createConversationTitleSummaryEvent(event) {
     return _object_spread$7({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
@@ -2604,6 +2605,13 @@ var KnowledgebaseTypeEnum;
     KnowledgebaseTypeEnum["Standard"] = "standard";
     KnowledgebaseTypeEnum["External"] = "external";
 })(KnowledgebaseTypeEnum || (KnowledgebaseTypeEnum = {}));
+var KnowledgebaseStatusEnum;
+(function(KnowledgebaseStatusEnum) {
+    KnowledgebaseStatusEnum["READY"] = "ready";
+    KnowledgebaseStatusEnum["REBUILD_REQUIRED"] = "rebuild_required";
+    KnowledgebaseStatusEnum["REBUILDING"] = "rebuilding";
+    KnowledgebaseStatusEnum["REBUILD_FAILED"] = "rebuild_failed";
+})(KnowledgebaseStatusEnum || (KnowledgebaseStatusEnum = {}));
 var KnowledgeStructureEnum;
 (function(KnowledgeStructureEnum) {
     KnowledgeStructureEnum["General"] = "general";
@@ -3816,6 +3824,9 @@ function isMiddlewareToolEnabled(config) {
     }
     return (config === null || config === void 0 ? void 0 : config.enabled) !== false;
 }
+function isRequiredMiddleware(entity) {
+    return (entity === null || entity === void 0 ? void 0 : entity.required) === true;
+}
 function genXpertMiddlewareKey() {
     return letterStartSUID("Middleware_");
 }
@@ -5401,4 +5412,4 @@ var PLUGIN_LOAD_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, 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, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, 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_CONFIGURATION_STATUS, PLUGIN_LEVEL, PLUGIN_LOAD_STATUS, 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_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, 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, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, 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, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, 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, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };
+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_THREAD_CONTEXT_USAGE, 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, 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_CONFIGURATION_STATUS, PLUGIN_LEVEL, PLUGIN_LOAD_STATUS, 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_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, 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, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, 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, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, 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, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.9.1",
+  "version": "3.9.3",
   "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.0.17"
+    "@xpert-ai/chatkit-types": "^0.2.3"
   },
   "types": "./index.d.ts"
 }

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

@@ -1,18 +1,9 @@
-import type { TChatEventMessage } from '@xpert-ai/chatkit-types';
+import { type TFollowUpConsumedEvent, type TChatEventMessage } from '@xpert-ai/chatkit-types';
 export declare const CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE: "thread_context_usage";
 export declare const CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY: "conversation_title_summary";
-export declare const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED: "follow_up_consumed";
 export type TConversationTitleSummaryEvent = TChatEventMessage & {
     id?: string;
     type: typeof CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY;
 };
-export type TFollowUpConsumedEvent = TChatEventMessage & {
-    type: typeof CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED;
-    mode: 'queue' | 'steer';
-    messageIds: string[];
-    clientMessageIds?: string[];
-    executionId?: string | null;
-    visibleAt?: string | null;
-};
 export declare function createConversationTitleSummaryEvent(event: Omit<TConversationTitleSummaryEvent, 'type'>): TConversationTitleSummaryEvent;
 export declare function createFollowUpConsumedEvent(event: Omit<TFollowUpConsumedEvent, 'type'>): TFollowUpConsumedEvent;

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

@@ -1,5 +1,5 @@
 import { MessageType } from '@langchain/core/messages';
-import type { TChatMessageStep, TMessageContent, TMessageContentReasoning } from '@xpert-ai/chatkit-types';
+import type { ChatKitReference, ChatKitReferenceBase, TChatMessageStep, TMessageContent, TMessageContentReasoning } from '@xpert-ai/chatkit-types';
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
 import { IChatConversation } from './chat.model';
 import { LongTermMemoryTypeEnum } from './xpert.model';
@@ -12,50 +12,6 @@ export type TSummaryJob = Record<LongTermMemoryTypeEnum, {
     progress?: number;
     memoryKey?: string;
 }>;
-/**
- * @deprecated Temporary duplicate of `ChatKitReferenceBase` from `@xpert-ai/chatkit-types`.
- * Use the shared chatkit type once that package release is available to contracts.
- */
-export type TChatReferenceBase = {
-    id?: string;
-    label?: string;
-    text: string;
-};
-/**
- * @deprecated Temporary duplicate of `ChatKitCodeReference` from `@xpert-ai/chatkit-types`.
- * Use the shared chatkit type once that package release is available to contracts.
- */
-export type TChatCodeReference = TChatReferenceBase & {
-    type: 'code';
-    path: string;
-    startLine: number;
-    endLine: number;
-    language?: string;
-    taskId?: string;
-};
-/**
- * @deprecated Temporary duplicate of `ChatKitQuoteReference` from `@xpert-ai/chatkit-types`.
- * Use the shared chatkit type once that package release is available to contracts.
- */
-export type TChatQuoteReference = TChatReferenceBase & {
-    type: 'quote';
-    messageId?: string;
-    source?: string;
-};
-/**
- * @deprecated Temporary duplicate of `ChatKitImageReference` from `@xpert-ai/chatkit-types`.
- * Use the shared chatkit type once that package release is available to contracts.
- */
-export type TChatImageReference = TChatReferenceBase & {
-    type: 'image';
-    fileId?: string;
-    url?: string;
-    mimeType?: string;
-    name?: string;
-    size?: number;
-    width?: number;
-    height?: number;
-};
 export type TChatElementAttribute = {
     name: string;
     value: string;
@@ -70,13 +26,32 @@ export type TChatElementReferenceFields = {
     serviceId: string;
     tagName: string;
 };
+export type TChatFileElementReferenceFields = {
+    attributes: TChatElementAttribute[];
+    documentTitle?: string;
+    domPath: string;
+    filePath: string;
+    outerHtml: string;
+    role?: string;
+    selector: string;
+    sourceEndLine?: number;
+    sourceStartLine?: number;
+    tagName: string;
+    text: string;
+};
 export type TChatElementReferenceCandidateFields = {
     [Property in keyof TChatElementReferenceFields]?: unknown;
 };
-export type TChatElementReference = TChatReferenceBase & TChatElementReferenceFields & {
+export type TChatFileElementReferenceCandidateFields = {
+    [Property in keyof TChatFileElementReferenceFields]?: unknown;
+};
+export type TChatElementReference = ChatKitReferenceBase & TChatElementReferenceFields & {
     type: 'element';
 };
-export type TChatReference = TChatCodeReference | TChatQuoteReference | TChatImageReference | TChatElementReference;
+export type TChatFileElementReference = ChatKitReferenceBase & TChatFileElementReferenceFields & {
+    type: 'file_element';
+};
+export type TChatReference = ChatKitReference | TChatElementReference | TChatFileElementReference;
 /**
  * Chat message entity type
  */

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

@@ -10,6 +10,7 @@ import { IXpertTask } from './xpert-task.model';
 import { TToolCall } from '../agent';
 import { TInterrupt } from '../agent/interrupt';
 import { IUser } from '../user.model';
+import type { RuntimeCapabilitiesSelection } from '@xpert-ai/chatkit-types';
 export type TChatConversationOptions = {
     parameters?: {
         input?: string;
@@ -21,6 +22,7 @@ export type TChatConversationOptions = {
     workspacePath?: string;
     workspaceUrl?: string;
     sandboxEnvironmentId?: string;
+    runtimeCapabilities?: RuntimeCapabilitiesSelection;
 };
 export type TChatConversationStatus = 'idle' | 'busy' | 'interrupted' | 'error';
 export type TToolCallType = 'agent' | 'tool';

package/src/ai/index.d.ts

@@ -34,6 +34,7 @@ export declare enum ChatMessageStepCategory {
     Knowledges = "knowledges"
 }
 export type * from '@xpert-ai/chatkit-types';
+export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from '@xpert-ai/chatkit-types';
 export type { TChatRequest } from './xpert-chat.model';
 export * from './assistant-binding.model';
 export * from './ai-model.model';

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

@@ -150,6 +150,7 @@ export type TKnowledgeDocument = {
     processMsg?: string | null;
     processBeginAt?: Date | null;
     processDuation?: number | null;
+    processDuration?: number | null;
     /**
      * is it validate (0: wasted，1: validate)
      */

package/src/ai/knowledge-pipeline.d.ts

@@ -87,15 +87,15 @@ export interface IWFNKnowledgeBase extends IWorkflowNode {
      */
     inputs?: string[];
     /**
-     * Embedding model
+     * @deprecated Configure embedding model on the knowledgebase.
      */
     copilotModel?: ICopilotModel;
     /**
-     * (optional) Rerank model
+     * @deprecated Configure rerank model on the knowledgebase.
      */
     rerankModel?: ICopilotModel;
     /**
-     * (optional) Vision model
+     * @deprecated Configure vision model on the knowledgebase.
      */
     visionModel?: ICopilotModel;
     documents?: string[];

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

@@ -15,6 +15,12 @@ export declare enum KnowledgebaseTypeEnum {
     Standard = "standard",
     External = "external"
 }
+export declare enum KnowledgebaseStatusEnum {
+    READY = "ready",
+    REBUILD_REQUIRED = "rebuild_required",
+    REBUILDING = "rebuilding",
+    REBUILD_FAILED = "rebuild_failed"
+}
 export declare enum KnowledgeStructureEnum {
     General = "general",
     ParentChild = "parent-child",
@@ -61,6 +67,18 @@ export type TKnowledgebase = {
      */
     copilotModel?: ICopilotModel;
     copilotModelId?: string;
+    embeddingCollectionName?: string | null;
+    embeddingModelFingerprint?: string | null;
+    embeddingDimensions?: number | null;
+    embeddingRevision?: number | null;
+    pendingCopilotModel?: ICopilotModel | null;
+    pendingCopilotModelId?: string | null;
+    pendingEmbeddingCollectionName?: string | null;
+    pendingEmbeddingModelFingerprint?: string | null;
+    pendingEmbeddingDimensions?: number | null;
+    pendingEmbeddingRevision?: number | null;
+    rebuildTaskId?: string | null;
+    embeddingRebuildError?: string | null;
     rerankModel?: ICopilotModel;
     rerankModelId?: string;
     visionModel?: ICopilotModel;
@@ -88,7 +106,7 @@ export type TKnowledgebase = {
      * Recall params for kb chunks
      */
     recall?: TKBRecallParams;
-    status?: string;
+    status?: KnowledgebaseStatusEnum;
     /**
      * Metadata custom field definition array
      */

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

@@ -7,6 +7,10 @@ export declare const CONTEXT_COMPRESSION_MIDDLEWARE_NAME = "ContextCompressionMi
 export interface IWFNMiddleware extends IWorkflowNode {
     type: WorkflowNodeTypeEnum.MIDDLEWARE;
     provider: string;
+    /**
+     * Required middlewares are always loaded at runtime and hidden from user-facing runtime selectors.
+     */
+    required?: boolean;
     options?: Record<string, any>;
     tools?: Record<string, TMiddlewareToolConfig | boolean>;
 }
@@ -14,6 +18,7 @@ export type TMiddlewareToolConfig = {
     enabled?: boolean;
 };
 export declare function isMiddlewareToolEnabled(config?: TMiddlewareToolConfig | boolean): boolean;
+export declare function isRequiredMiddleware(entity?: Pick<IWFNMiddleware, 'required'> | null): boolean;
 export declare function genXpertMiddlewareKey(): string;
 export declare function normalizeMiddlewareProvider(provider?: string | null): string;
 export declare function normalizeMiddlewareNode<T extends TXpertTeamNode>(node: T): T;

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

@@ -82,7 +82,7 @@ export interface IXpertProjectVCS extends IBasePerXpertProjectEntityModel {
 /**
  * @deprecated Use `attachments`
  */
-export interface IXpertProjectFile extends IBasePerXpertProjectEntityModel, Omit<TFile, 'createdAt'> {
+export interface IXpertProjectFile extends IBasePerXpertProjectEntityModel, Omit<TFile, 'createdAt' | 'updatedAt'> {
 }
 export type TXpertProjectDSL = IXpertProject & {
     xperts?: TXpertTeamDraft[];

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

@@ -76,6 +76,13 @@ export type TXpertFeatures = {
     title?: TXpertTitleFeature;
 };
 export type TXpertFeatureKey = keyof TXpertFeatures;
+export type TXpertExportedTemplate = {
+    id: string;
+    filePath: string;
+    exportedAt: string;
+    isDraft: boolean;
+    includeMemory: boolean;
+};
 export type TXpert = {
     /**
      * Unique slug identifier, generated from name
@@ -139,6 +146,7 @@ export type TXpert = {
      * Release notes
      */
     releaseNotes?: string;
+    exportedTemplate?: TXpertExportedTemplate | null;
     /**
      * Draft on current version
      */
@@ -458,6 +466,11 @@ export interface TXpertTeamConnection {
      * - others: Vertical Process, agent
      */
     type: 'edge' | TXpertTeamNodeType;
+    /**
+     * Runtime selection behavior for selectable connections.
+     * For sub-agent connections, omitted means required.
+     */
+    required?: boolean;
     readonly?: boolean;
 }
 export type TChatOptions = {

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

@@ -35,6 +35,7 @@ export declare function omitXpertRelations(xpert: Partial<IXpert>): {
     version?: string;
     latest?: boolean;
     releaseNotes?: string;
+    exportedTemplate?: import("./xpert.model").TXpertExportedTemplate | null;
     graph?: import("./xpert.model").TXpertGraph;
     api?: import("./xpert.model").TChatApi;
     app?: import("./xpert.model").TChatApp;

package/src/storage-file.model.d.ts

@@ -7,6 +7,7 @@ export type TFile = _TFile & {
     description?: string;
     size?: number;
     createdAt?: Date;
+    updatedAt?: Date;
     storageFileId?: string;
 };
 export interface IStorageFile extends IBasePerTenantAndOrganizationEntityModel {