@xpert-ai/contracts 3.9.3 → 3.9.5

package/index.esm.js

@@ -1,6 +1,4 @@
 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;
@@ -1340,6 +1338,48 @@ var QueryStatusEnum;
     QueryStatusEnum["FAILED"] = "failed";
 })(QueryStatusEnum || (QueryStatusEnum = {}));
 
+function _define_property$9(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _object_spread$8(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property$9(target, key, source[key]);
+        });
+    }
+    return target;
+}
+var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
+var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
+var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
+function createConversationTitleSummaryEvent(event) {
+    return _object_spread$8({
+        type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
+    }, event);
+}
+function createFollowUpConsumedEvent(event) {
+    return _object_spread$8({
+        type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
+    }, event);
+}
+
 function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
@@ -1351,7 +1391,7 @@ function _array_with_holes$5(arr) {
 function _array_without_holes$2(arr) {
     if (Array.isArray(arr)) return _array_like_to_array$6(arr);
 }
-function _define_property$9(obj, key, value) {
+function _define_property$8(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1397,7 +1437,7 @@ function _non_iterable_rest$5() {
 function _non_iterable_spread$2() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _object_spread$8(target) {
+function _object_spread$7(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -1407,7 +1447,7 @@ function _object_spread$8(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$9(target, key, source[key]);
+            _define_property$8(target, key, source[key]);
         });
     }
     return target;
@@ -1545,7 +1585,7 @@ function normalizeAssistantBindingToolPreferences(value) {
     if (!Object.keys(toolsets).length && !Object.keys(middlewares).length && !Object.keys(skills).length) {
         return null;
     }
-    return _object_spread$8({
+    return _object_spread$7({
         version: 1
     }, Object.keys(toolsets).length ? {
         toolsets: toolsets
@@ -1623,8 +1663,8 @@ function updateAssistantBindingToolPreferences(preferences, sourceType, nodeKey,
     }) : normalizeAssistantBindingPreferenceIds(_to_consumable_array$2(disabledTools).concat([
         normalizedToolName
     ]));
-    var toolsets = normalizedPreferences.toolsets ? _object_spread$8({}, normalizedPreferences.toolsets) : undefined;
-    var middlewares = normalizedPreferences.middlewares ? _object_spread$8({}, normalizedPreferences.middlewares) : undefined;
+    var toolsets = normalizedPreferences.toolsets ? _object_spread$7({}, normalizedPreferences.toolsets) : undefined;
+    var middlewares = normalizedPreferences.middlewares ? _object_spread$7({}, normalizedPreferences.middlewares) : undefined;
     if (sourceType === "toolset") {
         var toolsetName = "toolsetName" in metadata ? normalizeAssistantBindingPreferenceKey(metadata.toolsetName) : "";
         if (!toolsetName) {
@@ -1640,14 +1680,14 @@ function updateAssistantBindingToolPreferences(preferences, sourceType, nodeKey,
         } else {
             delete nextToolsets[normalizedNodeKey];
         }
-        return normalizeAssistantBindingToolPreferences(_object_spread$8({
+        return normalizeAssistantBindingToolPreferences(_object_spread$7({
             version: 1
         }, Object.keys(nextToolsets).length ? {
             toolsets: nextToolsets
         } : {}, middlewares && Object.keys(middlewares).length ? {
             middlewares: middlewares
         } : {}, normalizedPreferences.skills ? {
-            skills: _object_spread$8({}, normalizedPreferences.skills)
+            skills: _object_spread$7({}, normalizedPreferences.skills)
         } : {}));
     }
     var provider = "provider" in metadata ? normalizeAssistantBindingPreferenceKey(metadata.provider) : "";
@@ -1663,14 +1703,14 @@ function updateAssistantBindingToolPreferences(preferences, sourceType, nodeKey,
     } else {
         delete nextMiddlewares[normalizedNodeKey];
     }
-    return normalizeAssistantBindingToolPreferences(_object_spread$8({
+    return normalizeAssistantBindingToolPreferences(_object_spread$7({
         version: 1
     }, toolsets && Object.keys(toolsets).length ? {
         toolsets: toolsets
     } : {}, Object.keys(nextMiddlewares).length ? {
         middlewares: nextMiddlewares
     } : {}, normalizedPreferences.skills ? {
-        skills: _object_spread$8({}, normalizedPreferences.skills)
+        skills: _object_spread$7({}, normalizedPreferences.skills)
     } : {}));
 }
 function updateAssistantBindingSkillPreferences(preferences, workspaceId, skillId, enabled) {
@@ -1688,7 +1728,7 @@ function updateAssistantBindingSkillPreferences(preferences, workspaceId, skillI
     }) : normalizeAssistantBindingPreferenceIds(_to_consumable_array$2(disabledSkillIds).concat([
         normalizedSkillId
     ]));
-    var skills = normalizedPreferences.skills ? _object_spread$8({}, normalizedPreferences.skills) : {};
+    var skills = normalizedPreferences.skills ? _object_spread$7({}, normalizedPreferences.skills) : {};
     if (nextDisabledSkillIds.length) {
         skills[normalizedWorkspaceId] = {
             workspaceId: normalizedWorkspaceId,
@@ -1697,12 +1737,12 @@ function updateAssistantBindingSkillPreferences(preferences, workspaceId, skillI
     } else {
         delete skills[normalizedWorkspaceId];
     }
-    return normalizeAssistantBindingToolPreferences(_object_spread$8({
+    return normalizeAssistantBindingToolPreferences(_object_spread$7({
         version: 1
     }, normalizedPreferences.toolsets ? {
-        toolsets: _object_spread$8({}, normalizedPreferences.toolsets)
+        toolsets: _object_spread$7({}, normalizedPreferences.toolsets)
     } : {}, normalizedPreferences.middlewares ? {
-        middlewares: _object_spread$8({}, normalizedPreferences.middlewares)
+        middlewares: _object_spread$7({}, normalizedPreferences.middlewares)
     } : {}, Object.keys(skills).length ? {
         skills: skills
     } : {}));
@@ -1720,14 +1760,14 @@ function ensureAssistantBindingSkillWorkspacePreference(preferences, workspaceId
     var currentSkills = (_normalizedPreferences_skills = normalizedPreferences.skills) !== null && _normalizedPreferences_skills !== void 0 ? _normalizedPreferences_skills : {};
     var currentWorkspacePreference = currentSkills[normalizedWorkspaceId];
     var _currentWorkspacePreference_disabledSkillIds;
-    return _object_spread_props$6(_object_spread$8({
+    return _object_spread_props$6(_object_spread$7({
         version: 1
     }, normalizedPreferences.toolsets ? {
-        toolsets: _object_spread$8({}, normalizedPreferences.toolsets)
+        toolsets: _object_spread$7({}, normalizedPreferences.toolsets)
     } : {}, normalizedPreferences.middlewares ? {
-        middlewares: _object_spread$8({}, normalizedPreferences.middlewares)
+        middlewares: _object_spread$7({}, normalizedPreferences.middlewares)
     } : {}), {
-        skills: _object_spread_props$6(_object_spread$8({}, currentSkills), _define_property$9({}, normalizedWorkspaceId, {
+        skills: _object_spread_props$6(_object_spread$7({}, currentSkills), _define_property$8({}, normalizedWorkspaceId, {
             workspaceId: normalizeAssistantBindingPreferenceKey(currentWorkspacePreference === null || currentWorkspacePreference === void 0 ? void 0 : currentWorkspacePreference.workspaceId) || normalizedWorkspaceId,
             disabledSkillIds: (_currentWorkspacePreference_disabledSkillIds = currentWorkspacePreference === null || currentWorkspacePreference === void 0 ? void 0 : currentWorkspacePreference.disabledSkillIds) !== null && _currentWorkspacePreference_disabledSkillIds !== void 0 ? _currentWorkspacePreference_disabledSkillIds : []
         }))
@@ -1890,47 +1930,6 @@ var OllamaEmbeddingsProviders = [
     AiProvider.Ollama
 ];
 
-function _define_property$8(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _object_spread$7(target) {
-    for(var i = 1; i < arguments.length; i++){
-        var source = arguments[i] != null ? arguments[i] : {};
-        var ownKeys = Object.keys(source);
-        if (typeof Object.getOwnPropertySymbols === "function") {
-            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
-                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
-            }));
-        }
-        ownKeys.forEach(function(key) {
-            _define_property$8(target, key, source[key]);
-        });
-    }
-    return target;
-}
-var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
-var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
-function createConversationTitleSummaryEvent(event) {
-    return _object_spread$7({
-        type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
-    }, event);
-}
-function createFollowUpConsumedEvent(event) {
-    return _object_spread$7({
-        type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
-    }, event);
-}
-
 /**
  * @deprecated use ChatMessageEventTypeEnum
  */ var ChatGatewayEvent;
@@ -3221,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;
 }
@@ -3762,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";
@@ -4729,6 +4788,12 @@ var OrganizationProjectBudgetTypeEnum;
     OrganizationProjectBudgetTypeEnum["COST"] = "cost";
 })(OrganizationProjectBudgetTypeEnum || (OrganizationProjectBudgetTypeEnum = {}));
 
+var SecretTokenBindingType;
+(function(SecretTokenBindingType) {
+    SecretTokenBindingType["API_KEY"] = "api_key";
+    SecretTokenBindingType["PUBLIC_XPERT"] = "public_xpert";
+})(SecretTokenBindingType || (SecretTokenBindingType = {}));
+
 var Visibility;
 (function(Visibility) {
     Visibility["Public"] = "public";
@@ -5204,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,
@@ -5412,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_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 };
+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.3",
+  "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.2.3"
+    "@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/chat-event.model.d.ts

@@ -1,4 +1,5 @@
-import { type TFollowUpConsumedEvent, type TChatEventMessage } from '@xpert-ai/chatkit-types';
+import type { TFollowUpConsumedEvent, TChatEventMessage } from '@xpert-ai/chatkit-types';
+export declare const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED: "follow_up_consumed";
 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 type TConversationTitleSummaryEvent = TChatEventMessage & {

package/src/ai/index.d.ts

@@ -34,8 +34,8 @@ 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 { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from './chat-event.model';
 export * from './assistant-binding.model';
 export * from './ai-model.model';
 export * from './ai.model';
@@ -81,7 +81,9 @@ 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';
 export * from './context-compression.model';
 export * from './sandbox';

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>;