@xpert-ai/contracts 3.9.4 → 3.9.5

package/index.cjs.js

@@ -3222,6 +3222,49 @@ function omitXpertRelations(xpert) {
     var _ref;
     return (_ref = isDraft ? (_xpert_draft = xpert.draft) === null || _xpert_draft === void 0 ? void 0 : _xpert_draft.team : xpert) !== null && _ref !== void 0 ? _ref : xpert;
 }
+function resolveRuntimeXpert(xpert, isDraft) {
+    var _draft_team, _draft_team1, _draft_team2, _draft_team3, _draft_team4;
+    if (!isDraft || !xpert.draft) {
+        return xpert;
+    }
+    var draft = xpert.draft;
+    var graph = resolveDraftRuntimeGraph(xpert, draft);
+    var agent = resolveDraftPrimaryAgent(xpert, draft, graph);
+    var _draft_team5, _draft_team_workspaceId, _draft_team_agentConfig, _draft_team_commandProfile, _draft_team_features, _draft_team_options;
+    return _object_spread_props$3(_object_spread$3({}, xpert, (_draft_team5 = draft.team) !== null && _draft_team5 !== void 0 ? _draft_team5 : {}), {
+        id: xpert.id,
+        tenantId: xpert.tenantId,
+        organizationId: xpert.organizationId,
+        workspaceId: (_draft_team_workspaceId = (_draft_team = draft.team) === null || _draft_team === void 0 ? void 0 : _draft_team.workspaceId) !== null && _draft_team_workspaceId !== void 0 ? _draft_team_workspaceId : xpert.workspaceId,
+        draft: xpert.draft,
+        graph: graph,
+        agent: agent,
+        agentConfig: (_draft_team_agentConfig = (_draft_team1 = draft.team) === null || _draft_team1 === void 0 ? void 0 : _draft_team1.agentConfig) !== null && _draft_team_agentConfig !== void 0 ? _draft_team_agentConfig : xpert.agentConfig,
+        commandProfile: (_draft_team_commandProfile = (_draft_team2 = draft.team) === null || _draft_team2 === void 0 ? void 0 : _draft_team2.commandProfile) !== null && _draft_team_commandProfile !== void 0 ? _draft_team_commandProfile : xpert.commandProfile,
+        features: (_draft_team_features = (_draft_team3 = draft.team) === null || _draft_team3 === void 0 ? void 0 : _draft_team3.features) !== null && _draft_team_features !== void 0 ? _draft_team_features : xpert.features,
+        options: (_draft_team_options = (_draft_team4 = draft.team) === null || _draft_team4 === void 0 ? void 0 : _draft_team4.options) !== null && _draft_team_options !== void 0 ? _draft_team_options : xpert.options
+    });
+}
+function resolveDraftRuntimeGraph(xpert, draft) {
+    var _xpert_graph, _xpert_graph1;
+    var _draft_nodes, _ref, _draft_connections, _ref1;
+    return {
+        nodes: (_ref = (_draft_nodes = draft.nodes) !== null && _draft_nodes !== void 0 ? _draft_nodes : (_xpert_graph = xpert.graph) === null || _xpert_graph === void 0 ? void 0 : _xpert_graph.nodes) !== null && _ref !== void 0 ? _ref : [],
+        connections: (_ref1 = (_draft_connections = draft.connections) !== null && _draft_connections !== void 0 ? _draft_connections : (_xpert_graph1 = xpert.graph) === null || _xpert_graph1 === void 0 ? void 0 : _xpert_graph1.connections) !== null && _ref1 !== void 0 ? _ref1 : []
+    };
+}
+function resolveDraftPrimaryAgent(xpert, draft, graph) {
+    var _draft_team, _xpert_agent;
+    var draftAgent = (_draft_team = draft.team) === null || _draft_team === void 0 ? void 0 : _draft_team.agent;
+    var _draftAgent_key;
+    var targetKey = (_draftAgent_key = draftAgent === null || draftAgent === void 0 ? void 0 : draftAgent.key) !== null && _draftAgent_key !== void 0 ? _draftAgent_key : (_xpert_agent = xpert.agent) === null || _xpert_agent === void 0 ? void 0 : _xpert_agent.key;
+    var agentNode = targetKey ? graph.nodes.find(function(node) {
+        var _node_entity;
+        return node.type === "agent" && (node.key === targetKey || ((_node_entity = node.entity) === null || _node_entity === void 0 ? void 0 : _node_entity.key) === targetKey);
+    }) : null;
+    var _agentNode_entity, _ref;
+    return (_ref = (_agentNode_entity = agentNode === null || agentNode === void 0 ? void 0 : agentNode.entity) !== null && _agentNode_entity !== void 0 ? _agentNode_entity : draftAgent) !== null && _ref !== void 0 ? _ref : xpert.agent;
+}
 function xpertLabel(agent) {
     return agent.title || agent.name;
 }
@@ -3763,6 +3806,23 @@ function getChunkNodeId(document) {
     return leaves;
 }
 
+exports.KnowledgeGraphStatus = void 0;
+(function(KnowledgeGraphStatus) {
+    KnowledgeGraphStatus["DISABLED"] = "disabled";
+    KnowledgeGraphStatus["INDEXING"] = "indexing";
+    KnowledgeGraphStatus["READY"] = "ready";
+    KnowledgeGraphStatus["FAILED"] = "failed";
+    KnowledgeGraphStatus["REBUILD_REQUIRED"] = "rebuild_required";
+})(exports.KnowledgeGraphStatus || (exports.KnowledgeGraphStatus = {}));
+exports.KnowledgeGraphIndexJobStatus = void 0;
+(function(KnowledgeGraphIndexJobStatus) {
+    KnowledgeGraphIndexJobStatus["QUEUED"] = "queued";
+    KnowledgeGraphIndexJobStatus["RUNNING"] = "running";
+    KnowledgeGraphIndexJobStatus["SUCCESS"] = "success";
+    KnowledgeGraphIndexJobStatus["FAILED"] = "failed";
+    KnowledgeGraphIndexJobStatus["CANCELLED"] = "cancelled";
+})(exports.KnowledgeGraphIndexJobStatus || (exports.KnowledgeGraphIndexJobStatus = {}));
+
 // Skill types
 var WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER = "workspace-public";
 var WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME = "Workspace Shared Skills";
@@ -5211,14 +5271,32 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * @param variable
  * @returns
  */ function getVariableSchema(variables, variable) {
-    var _variable_split;
-    var _ref = _to_array((_variable_split = variable === null || variable === void 0 ? void 0 : variable.split(".")) !== null && _variable_split !== void 0 ? _variable_split : []), groupName = _ref[0], rest = _ref.slice(1);
-    var group = variables === null || variables === void 0 ? void 0 : variables.find(function(_) {
-        var __group, __group1;
-        return rest.length ? ((__group = _.group) === null || __group === void 0 ? void 0 : __group.name) === groupName : !((__group1 = _.group) === null || __group1 === void 0 ? void 0 : __group1.name);
+    if (!(variables === null || variables === void 0 ? void 0 : variables.length) || !variable) {
+        return {
+            group: undefined,
+            variable: undefined
+        };
+    }
+    var _variable_split = _to_array(variable.split(".")), groupName = _variable_split[0], rest = _variable_split.slice(1);
+    if (rest.length) {
+        var grouped = findVariableInGroup(variables, groupName, rest.join("."));
+        if (grouped.variable) {
+            return grouped;
+        }
+    }
+    var ungrouped = findVariableInGroup(variables, "", variable);
+    if (ungrouped.variable) {
+        return ungrouped;
+    }
+    return rest.length ? findVariableInGroup(variables, groupName, rest.join(".")) : ungrouped;
+}
+function findVariableInGroup(variables, groupName, variableName) {
+    var group = variables.find(function(item) {
+        var _item_group, _item_group1;
+        return groupName ? ((_item_group = item.group) === null || _item_group === void 0 ? void 0 : _item_group.name) === groupName : !((_item_group1 = item.group) === null || _item_group1 === void 0 ? void 0 : _item_group1.name);
     });
-    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
-        return _.name === (rest.join(".") || groupName);
+    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(item) {
+        return item.name === variableName;
     });
     return {
         group: group,
@@ -5591,7 +5669,10 @@ exports.normalizeMiddlewareProvider = normalizeMiddlewareProvider;
 exports.normalizeXpertAgentConfig = normalizeXpertAgentConfig;
 exports.omitXpertRelations = omitXpertRelations;
 exports.replaceAgentInDraft = replaceAgentInDraft;
+exports.resolveDraftPrimaryAgent = resolveDraftPrimaryAgent;
+exports.resolveDraftRuntimeGraph = resolveDraftRuntimeGraph;
 exports.resolveMessageAppendContext = resolveMessageAppendContext;
+exports.resolveRuntimeXpert = resolveRuntimeXpert;
 exports.setStateVariable = setStateVariable;
 exports.shortTitle = shortTitle;
 exports.stringifyMessageContent = stringifyMessageContent;

package/index.esm.js

@@ -3220,6 +3220,49 @@ function omitXpertRelations(xpert) {
     var _ref;
     return (_ref = isDraft ? (_xpert_draft = xpert.draft) === null || _xpert_draft === void 0 ? void 0 : _xpert_draft.team : xpert) !== null && _ref !== void 0 ? _ref : xpert;
 }
+function resolveRuntimeXpert(xpert, isDraft) {
+    var _draft_team, _draft_team1, _draft_team2, _draft_team3, _draft_team4;
+    if (!isDraft || !xpert.draft) {
+        return xpert;
+    }
+    var draft = xpert.draft;
+    var graph = resolveDraftRuntimeGraph(xpert, draft);
+    var agent = resolveDraftPrimaryAgent(xpert, draft, graph);
+    var _draft_team5, _draft_team_workspaceId, _draft_team_agentConfig, _draft_team_commandProfile, _draft_team_features, _draft_team_options;
+    return _object_spread_props$3(_object_spread$3({}, xpert, (_draft_team5 = draft.team) !== null && _draft_team5 !== void 0 ? _draft_team5 : {}), {
+        id: xpert.id,
+        tenantId: xpert.tenantId,
+        organizationId: xpert.organizationId,
+        workspaceId: (_draft_team_workspaceId = (_draft_team = draft.team) === null || _draft_team === void 0 ? void 0 : _draft_team.workspaceId) !== null && _draft_team_workspaceId !== void 0 ? _draft_team_workspaceId : xpert.workspaceId,
+        draft: xpert.draft,
+        graph: graph,
+        agent: agent,
+        agentConfig: (_draft_team_agentConfig = (_draft_team1 = draft.team) === null || _draft_team1 === void 0 ? void 0 : _draft_team1.agentConfig) !== null && _draft_team_agentConfig !== void 0 ? _draft_team_agentConfig : xpert.agentConfig,
+        commandProfile: (_draft_team_commandProfile = (_draft_team2 = draft.team) === null || _draft_team2 === void 0 ? void 0 : _draft_team2.commandProfile) !== null && _draft_team_commandProfile !== void 0 ? _draft_team_commandProfile : xpert.commandProfile,
+        features: (_draft_team_features = (_draft_team3 = draft.team) === null || _draft_team3 === void 0 ? void 0 : _draft_team3.features) !== null && _draft_team_features !== void 0 ? _draft_team_features : xpert.features,
+        options: (_draft_team_options = (_draft_team4 = draft.team) === null || _draft_team4 === void 0 ? void 0 : _draft_team4.options) !== null && _draft_team_options !== void 0 ? _draft_team_options : xpert.options
+    });
+}
+function resolveDraftRuntimeGraph(xpert, draft) {
+    var _xpert_graph, _xpert_graph1;
+    var _draft_nodes, _ref, _draft_connections, _ref1;
+    return {
+        nodes: (_ref = (_draft_nodes = draft.nodes) !== null && _draft_nodes !== void 0 ? _draft_nodes : (_xpert_graph = xpert.graph) === null || _xpert_graph === void 0 ? void 0 : _xpert_graph.nodes) !== null && _ref !== void 0 ? _ref : [],
+        connections: (_ref1 = (_draft_connections = draft.connections) !== null && _draft_connections !== void 0 ? _draft_connections : (_xpert_graph1 = xpert.graph) === null || _xpert_graph1 === void 0 ? void 0 : _xpert_graph1.connections) !== null && _ref1 !== void 0 ? _ref1 : []
+    };
+}
+function resolveDraftPrimaryAgent(xpert, draft, graph) {
+    var _draft_team, _xpert_agent;
+    var draftAgent = (_draft_team = draft.team) === null || _draft_team === void 0 ? void 0 : _draft_team.agent;
+    var _draftAgent_key;
+    var targetKey = (_draftAgent_key = draftAgent === null || draftAgent === void 0 ? void 0 : draftAgent.key) !== null && _draftAgent_key !== void 0 ? _draftAgent_key : (_xpert_agent = xpert.agent) === null || _xpert_agent === void 0 ? void 0 : _xpert_agent.key;
+    var agentNode = targetKey ? graph.nodes.find(function(node) {
+        var _node_entity;
+        return node.type === "agent" && (node.key === targetKey || ((_node_entity = node.entity) === null || _node_entity === void 0 ? void 0 : _node_entity.key) === targetKey);
+    }) : null;
+    var _agentNode_entity, _ref;
+    return (_ref = (_agentNode_entity = agentNode === null || agentNode === void 0 ? void 0 : agentNode.entity) !== null && _agentNode_entity !== void 0 ? _agentNode_entity : draftAgent) !== null && _ref !== void 0 ? _ref : xpert.agent;
+}
 function xpertLabel(agent) {
     return agent.title || agent.name;
 }
@@ -3761,6 +3804,23 @@ function getChunkNodeId(document) {
     return leaves;
 }
 
+var KnowledgeGraphStatus;
+(function(KnowledgeGraphStatus) {
+    KnowledgeGraphStatus["DISABLED"] = "disabled";
+    KnowledgeGraphStatus["INDEXING"] = "indexing";
+    KnowledgeGraphStatus["READY"] = "ready";
+    KnowledgeGraphStatus["FAILED"] = "failed";
+    KnowledgeGraphStatus["REBUILD_REQUIRED"] = "rebuild_required";
+})(KnowledgeGraphStatus || (KnowledgeGraphStatus = {}));
+var KnowledgeGraphIndexJobStatus;
+(function(KnowledgeGraphIndexJobStatus) {
+    KnowledgeGraphIndexJobStatus["QUEUED"] = "queued";
+    KnowledgeGraphIndexJobStatus["RUNNING"] = "running";
+    KnowledgeGraphIndexJobStatus["SUCCESS"] = "success";
+    KnowledgeGraphIndexJobStatus["FAILED"] = "failed";
+    KnowledgeGraphIndexJobStatus["CANCELLED"] = "cancelled";
+})(KnowledgeGraphIndexJobStatus || (KnowledgeGraphIndexJobStatus = {}));
+
 // Skill types
 var WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER = "workspace-public";
 var WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME = "Workspace Shared Skills";
@@ -5209,14 +5269,32 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * @param variable
  * @returns
  */ function getVariableSchema(variables, variable) {
-    var _variable_split;
-    var _ref = _to_array((_variable_split = variable === null || variable === void 0 ? void 0 : variable.split(".")) !== null && _variable_split !== void 0 ? _variable_split : []), groupName = _ref[0], rest = _ref.slice(1);
-    var group = variables === null || variables === void 0 ? void 0 : variables.find(function(_) {
-        var __group, __group1;
-        return rest.length ? ((__group = _.group) === null || __group === void 0 ? void 0 : __group.name) === groupName : !((__group1 = _.group) === null || __group1 === void 0 ? void 0 : __group1.name);
+    if (!(variables === null || variables === void 0 ? void 0 : variables.length) || !variable) {
+        return {
+            group: undefined,
+            variable: undefined
+        };
+    }
+    var _variable_split = _to_array(variable.split(".")), groupName = _variable_split[0], rest = _variable_split.slice(1);
+    if (rest.length) {
+        var grouped = findVariableInGroup(variables, groupName, rest.join("."));
+        if (grouped.variable) {
+            return grouped;
+        }
+    }
+    var ungrouped = findVariableInGroup(variables, "", variable);
+    if (ungrouped.variable) {
+        return ungrouped;
+    }
+    return rest.length ? findVariableInGroup(variables, groupName, rest.join(".")) : ungrouped;
+}
+function findVariableInGroup(variables, groupName, variableName) {
+    var group = variables.find(function(item) {
+        var _item_group, _item_group1;
+        return groupName ? ((_item_group = item.group) === null || _item_group === void 0 ? void 0 : _item_group.name) === groupName : !((_item_group1 = item.group) === null || _item_group1 === void 0 ? void 0 : _item_group1.name);
     });
-    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
-        return _.name === (rest.join(".") || groupName);
+    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(item) {
+        return item.name === variableName;
     });
     return {
         group: group,
@@ -5417,4 +5495,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, 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, SecretTokenBindingType, 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 };
+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, 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_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, SecretTokenBindingType, 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, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveMessageAppendContext, resolveRuntimeXpert, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

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

package/src/agent/variables.d.ts

@@ -1,5 +1,5 @@
-import { TWorkflowVarGroup } from "../ai/xpert-workflow.model";
-import { TXpertParameter } from "../ai/xpert.model";
+import { TWorkflowVarGroup } from '../ai/xpert-workflow.model';
+import { TXpertParameter } from '../ai/xpert.model';
 /**
  *
  * Returns the variable schema for a given variable name.
@@ -9,7 +9,7 @@ import { TXpertParameter } from "../ai/xpert.model";
  * @param variable
  * @returns
  */
-export declare function getVariableSchema(variables: TWorkflowVarGroup[], variable: string): {
+export declare function getVariableSchema(variables: TWorkflowVarGroup[] | null | undefined, variable: string | null | undefined): {
     group: TWorkflowVarGroup;
     variable: import("../ai/xpert.model").TStateVariable;
 };

package/src/ai/index.d.ts

@@ -81,6 +81,7 @@ export * from './knowledgebase-task.model';
 export * from './knowledge-pipeline';
 export * from './knowledge-retrieval-log.model';
 export * from './knowledge-doc-chunk.model';
+export * from './knowledge-graph.model';
 export * from './skill.model';
 export * from './prompt-workflow.model';
 export * from './middleware.model';

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

@@ -0,0 +1,224 @@
+import type { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
+import type { IKnowledgebase } from './knowledgebase.model';
+import type { IKnowledgeDocument } from './knowledge-doc.model';
+import type { IKnowledgeDocumentChunk } from './knowledge-doc-chunk.model';
+export declare enum KnowledgeGraphStatus {
+    DISABLED = "disabled",
+    INDEXING = "indexing",
+    READY = "ready",
+    FAILED = "failed",
+    REBUILD_REQUIRED = "rebuild_required"
+}
+export declare enum KnowledgeGraphIndexJobStatus {
+    QUEUED = "queued",
+    RUNNING = "running",
+    SUCCESS = "success",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+export type KnowledgeGraphIndexJobType = 'document' | 'rebuild';
+export type GraphRagRetrievalMode = 'vector' | 'graph' | 'hybrid';
+export type KnowledgeGraphItemOrigin = 'extracted' | 'manual' | 'curated';
+export type KnowledgeGraphVisibility = 'active' | 'hidden';
+export type GraphRagConfig = {
+    enabled?: boolean;
+    entityTopK?: number;
+    neighborHops?: number;
+    communityTopK?: number;
+    graphWeight?: number;
+    extractionBatchSize?: number;
+    extractionMaxCharacters?: number;
+};
+export type KnowledgeGraphEvidence = {
+    chunkId: string;
+    quote?: string | null;
+    confidence?: number | null;
+};
+export interface IKnowledgeGraphEntity extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    type: string;
+    name: string;
+    normalizedName: string;
+    origin?: KnowledgeGraphItemOrigin;
+    visibility?: KnowledgeGraphVisibility;
+    aliases?: string[] | null;
+    description?: string | null;
+    summary?: string | null;
+    confidence?: number | null;
+    mentionCount?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphRelation extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    sourceEntityId?: string;
+    sourceEntity?: IKnowledgeGraphEntity;
+    targetEntityId?: string;
+    targetEntity?: IKnowledgeGraphEntity;
+    type: string;
+    normalizedType?: string | null;
+    origin?: KnowledgeGraphItemOrigin;
+    visibility?: KnowledgeGraphVisibility;
+    description?: string | null;
+    confidence?: number | null;
+    weight?: number | null;
+    evidenceCount?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphMention extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    entityId?: string;
+    entity?: IKnowledgeGraphEntity;
+    relationId?: string | null;
+    relation?: IKnowledgeGraphRelation | null;
+    documentId?: string;
+    document?: IKnowledgeDocument;
+    chunkId?: string;
+    chunk?: IKnowledgeDocumentChunk;
+    quote?: string | null;
+    confidence?: number | null;
+    startOffset?: number | null;
+    endOffset?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphCommunity extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    key: string;
+    title?: string | null;
+    summary?: string | null;
+    entityIds?: string[] | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphIndexJob extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    documentId?: string | null;
+    document?: IKnowledgeDocument | null;
+    type: KnowledgeGraphIndexJobType;
+    status: KnowledgeGraphIndexJobStatus;
+    revision?: number | null;
+    totalChunks?: number | null;
+    processedChunks?: number | null;
+    error?: string | null;
+    startedAt?: Date | null;
+    completedAt?: Date | null;
+}
+export type KnowledgeGraphStatusResponse = {
+    status: KnowledgeGraphStatus;
+    enabled: boolean;
+    revision?: number | null;
+    error?: string | null;
+    entityCount: number;
+    relationCount: number;
+    mentionCount: number;
+    queuedJobCount: number;
+    runningJobCount: number;
+    failedJobCount: number;
+    jobs?: IKnowledgeGraphIndexJob[];
+};
+export type KnowledgeGraphViewNode = {
+    id: string;
+    name: string;
+    type: string;
+    origin: KnowledgeGraphItemOrigin;
+    visibility: KnowledgeGraphVisibility;
+    mentionCount?: number | null;
+    confidence?: number | null;
+    symbolSize?: number;
+    value?: number;
+};
+export type KnowledgeGraphViewEdge = {
+    id: string;
+    source: string;
+    target: string;
+    type: string;
+    origin: KnowledgeGraphItemOrigin;
+    visibility: KnowledgeGraphVisibility;
+    weight?: number | null;
+    evidenceCount?: number | null;
+};
+export type KnowledgeGraphViewResponse = {
+    nodes: KnowledgeGraphViewNode[];
+    edges: KnowledgeGraphViewEdge[];
+    entityTypes: string[];
+    relationTypes: string[];
+    totalNodes: number;
+    totalEdges: number;
+};
+export type KnowledgeGraphVisualizationQuery = {
+    search?: string | null;
+    entityType?: string | null;
+    relationType?: string | null;
+    origin?: KnowledgeGraphItemOrigin | null;
+    visibility?: KnowledgeGraphVisibility | null;
+    focusEntityId?: string | null;
+    depth?: number | null;
+    take?: number | null;
+};
+export type KnowledgeGraphMentionListQuery = {
+    entityId?: string | null;
+    relationId?: string | null;
+    documentId?: string | null;
+    chunkId?: string | null;
+    take?: number | null;
+};
+export type KnowledgeGraphEntityChunksQuery = {
+    neighborHops?: number | null;
+    take?: number | null;
+    includeMentions?: boolean | null;
+    mentionTake?: number | null;
+    documentId?: string | null;
+};
+export type KnowledgeGraphEntityChunksResponse = {
+    entity: IKnowledgeGraphEntity;
+    chunks: IKnowledgeDocumentChunk[];
+    evidenceByChunkId: Record<string, IKnowledgeGraphMention[]>;
+    totals: {
+        chunks: number;
+        mentions: number;
+        entityIds: number;
+        relations: number;
+    };
+    limits: {
+        take: number;
+        neighborHops: number;
+        mentionTake: number;
+        includeMentions: boolean;
+    };
+    truncated?: {
+        chunks?: boolean;
+        mentions?: boolean;
+    };
+};
+export type KnowledgeGraphEntityCreateInput = {
+    name: string;
+    type: string;
+    aliases?: string[] | null;
+    description?: string | null;
+    visibility?: KnowledgeGraphVisibility;
+};
+export type KnowledgeGraphEntityUpdateInput = Partial<KnowledgeGraphEntityCreateInput>;
+export type KnowledgeGraphRelationCreateInput = {
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: string;
+    description?: string | null;
+    weight?: number | null;
+    visibility?: KnowledgeGraphVisibility;
+};
+export type KnowledgeGraphRelationUpdateInput = Partial<KnowledgeGraphRelationCreateInput>;

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

@@ -94,6 +94,10 @@ export interface IWFNKnowledgeBase extends IWorkflowNode {
      * @deprecated Configure rerank model on the knowledgebase.
      */
     rerankModel?: ICopilotModel;
+    /**
+     * @deprecated Configure chat model on the knowledgebase.
+     */
+    chatModel?: ICopilotModel;
     /**
      * @deprecated Configure vision model on the knowledgebase.
      */

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

@@ -5,6 +5,7 @@ import { IKnowledgeDocument } from './knowledge-doc.model';
 import { IXpert } from './xpert.model';
 import { IIntegration } from '../integration.model';
 import { IDocChunkMetadata } from './knowledge-doc-chunk.model';
+import type { GraphRagConfig, KnowledgeGraphStatus } from './knowledge-graph.model';
 /**
  * Non-internal types should remain the same as IntegrationEnum.
  */
@@ -67,6 +68,11 @@ export type TKnowledgebase = {
      */
     copilotModel?: ICopilotModel;
     copilotModelId?: string;
+    /**
+     * Chat model for knowledgebase LLM tasks.
+     */
+    chatModel?: ICopilotModel | null;
+    chatModelId?: string | null;
     embeddingCollectionName?: string | null;
     embeddingModelFingerprint?: string | null;
     embeddingDimensions?: number | null;
@@ -79,6 +85,10 @@ export type TKnowledgebase = {
     pendingEmbeddingRevision?: number | null;
     rebuildTaskId?: string | null;
     embeddingRebuildError?: string | null;
+    graphRag?: GraphRagConfig | null;
+    graphStatus?: KnowledgeGraphStatus | null;
+    graphRevision?: number | null;
+    graphIndexError?: string | null;
     rerankModel?: ICopilotModel;
     rerankModelId?: string;
     visionModel?: ICopilotModel;

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

@@ -1,7 +1,8 @@
-import { IWorkflowNode, WorkflowNodeTypeEnum } from "./xpert-workflow.model";
-import { I18nObject, IconDefinition } from "../types";
-import { TXpertFeatureKey, TXpertGraph, TXpertTeamNode } from "./xpert.model";
-import { JsonSchemaObjectType } from "./types";
+import { IWorkflowNode, WorkflowNodeTypeEnum } from './xpert-workflow.model';
+import { I18nObject, IconDefinition } from '../types';
+import { TXpertFeatureKey, TXpertGraph, TXpertTeamNode } from './xpert.model';
+import { JsonSchemaObjectType } from './types';
+import type { SkillSlashCommand } from './skill.model';
 export declare const LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME = "SandboxCompressionMiddleware";
 export declare const CONTEXT_COMPRESSION_MIDDLEWARE_NAME = "ContextCompressionMiddleware";
 export interface IWFNMiddleware extends IWorkflowNode {
@@ -30,5 +31,6 @@ export type TAgentMiddlewareMeta = {
     description?: I18nObject;
     configSchema?: JsonSchemaObjectType;
     features?: TXpertFeatureKey[];
+    slashCommands?: SkillSlashCommand[];
 };
 export declare function getAgentMiddlewareNodes(graph: TXpertGraph, agentKey: string): TXpertTeamNode[];

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

@@ -522,16 +522,21 @@ export type TChatOptions = {
  * Knowledgebase retrieval settings
  */
 export type TKBRetrievalSettings = {
-    metadata: {
+    mode?: 'vector' | 'graph' | 'hybrid';
+    neighborHops?: number;
+    entityTopK?: number;
+    communityTopK?: number;
+    graphWeight?: number;
+    metadata?: {
         filtering_mode: 'disabled' | 'automatic' | 'manual';
         /**
          * Conditions (filter) when mode is manual
          */
-        filtering_conditions: TWFCase;
+        filtering_conditions?: TWFCase;
         /**
          * Parameter fields (tool call) when mode is automatic
          */
-        fields: Record<string, object>;
+        fields?: Record<string, object>;
     };
 };
 export declare function isXpertNodeType<T extends TXpertTeamNodeType>(type: T): (node: TXpertTeamNode) => node is NodeOf<T>;

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

@@ -1,6 +1,6 @@
 import { IPoint } from '../types';
 import { IXpertAgent } from './xpert-agent.model';
-import { IXpert, TXpertTeamConnection, TXpertTeamDraft, TXpertTeamNode } from './xpert.model';
+import { IXpert, TXpertGraph, TXpertTeamConnection, TXpertTeamDraft, TXpertTeamNode } from './xpert.model';
 export declare function omitXpertRelations(xpert: Partial<IXpert>): {
     environmentId?: string;
     workspaceId?: string;
@@ -37,7 +37,7 @@ export declare function omitXpertRelations(xpert: Partial<IXpert>): {
     latest?: boolean;
     releaseNotes?: string;
     exportedTemplate?: import("./xpert.model").TXpertExportedTemplate | null;
-    graph?: import("./xpert.model").TXpertGraph;
+    graph?: TXpertGraph;
     api?: import("./xpert.model").TChatApi;
     app?: import("./xpert.model").TChatApp;
     userId?: string;
@@ -54,6 +54,9 @@ export declare function omitXpertRelations(xpert: Partial<IXpert>): {
  * @returns
  */
 export declare function figureOutXpert(xpert: IXpert, isDraft: boolean): Partial<IXpert>;
+export declare function resolveRuntimeXpert(xpert: IXpert, isDraft: boolean): IXpert;
+export declare function resolveDraftRuntimeGraph(xpert: IXpert, draft: TXpertTeamDraft): TXpertGraph;
+export declare function resolveDraftPrimaryAgent(xpert: IXpert, draft: TXpertTeamDraft, graph: TXpertGraph): IXpertAgent | undefined;
 export declare function xpertLabel(agent: Partial<IXpert>): string;
 export declare function createXpertGraph(xpert: IXpert, position: IPoint): {
     nodes: TXpertTeamNode[];