@metad/contracts 3.7.0 → 3.8.0

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$5(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -1473,32 +1474,6 @@ exports.ChatGatewayEvent = void 0;
     ChatGatewayEvent["Agent"] = "agent";
 })(exports.ChatGatewayEvent || (exports.ChatGatewayEvent = {}));
 
-exports.ChatMessageStepCategory = void 0;
-(function(ChatMessageStepCategory) {
-    /**
-   * List of items: urls, files, etc.
-   */ ChatMessageStepCategory["List"] = "list";
-    /**
-   * Websearch results
-   */ ChatMessageStepCategory["WebSearch"] = "web_search";
-    /**
-   * Files list
-   */ ChatMessageStepCategory["Files"] = "files";
-    /**
-   * View a file
-   */ ChatMessageStepCategory["File"] = "file";
-    /**
-   * Program Execution
-   */ ChatMessageStepCategory["Program"] = "program";
-    /**
-   * Iframe
-   */ ChatMessageStepCategory["Iframe"] = "iframe";
-    ChatMessageStepCategory["Memory"] = "memory";
-    ChatMessageStepCategory["Tasks"] = "tasks";
-    /**
-   * Knowledges (knowledge base retriever results)
-   */ ChatMessageStepCategory["Knowledges"] = "knowledges";
-})(exports.ChatMessageStepCategory || (exports.ChatMessageStepCategory = {}));
 // Type guards
 /**
  * @deprecated use content in message
@@ -1515,6 +1490,8 @@ exports.ChatMessageFeedbackRatingEnum = void 0;
 var MEMORY_QA_PROMPT = "Summarize the experience of the above conversation and output a short question and answer.";
 var MEMORY_PROFILE_PROMPT = "Extract new user profile information from the above conversation in one short sentence. If no new information is available, return nothing.";
 
+var USAGE_HOUR_FORMAT = "yyyy-MM-dd HH";
+
 exports.AiProviderRole = void 0;
 (function(AiProviderRole) {
     AiProviderRole["Primary"] = "primary";
@@ -1582,6 +1559,8 @@ var KDocumentWebTypeOptions = [
 
 exports.WorkflowNodeTypeEnum = void 0;
 (function(WorkflowNodeTypeEnum) {
+    WorkflowNodeTypeEnum["START"] = "start";
+    WorkflowNodeTypeEnum["END"] = "end";
     /**
    * Trigger
    */ WorkflowNodeTypeEnum["TRIGGER"] = "trigger";
@@ -1593,7 +1572,10 @@ exports.WorkflowNodeTypeEnum = void 0;
    */ WorkflowNodeTypeEnum["IF_ELSE"] = "if-else";
     WorkflowNodeTypeEnum["LIST_OPERATOR"] = "list-operator";
     WorkflowNodeTypeEnum["VARIABLE_AGGREGATOR"] = "variable-aggregator";
-    WorkflowNodeTypeEnum["ITERATING"] = "iterating";
+    /**
+   * @deprecated use ITERATOR instead
+   */ WorkflowNodeTypeEnum["ITERATING"] = "iterating";
+    WorkflowNodeTypeEnum["ITERATOR"] = "iterator";
     WorkflowNodeTypeEnum["HTTP"] = "http";
     WorkflowNodeTypeEnum["SUBFLOW"] = "subflow";
     WorkflowNodeTypeEnum["TOOL"] = "tool";
@@ -1650,9 +1632,15 @@ exports.VariableOperationEnum = void 0;
     VariableOperationEnum["CLEAR"] = "clear";
 })(exports.VariableOperationEnum || (exports.VariableOperationEnum = {}));
 /**
- * The parameter name that represents the entire current element in array
+ * @deprecated use `IteratorItemParameterName` instead
  */ var IteratingItemParameterName = "$item";
-var IteratingIndexParameterName = "$index";
+/**
+ * @deprecated use `IteratorIndexParameterName` instead
+ */ var IteratingIndexParameterName = "$index";
+/**
+ * The parameter name that represents the entire current element in array
+ */ var IteratorItemParameterName = "$item";
+var IteratorIndexParameterName = "$index";
 exports.WorkflowLogicalOperator = void 0;
 (function(WorkflowLogicalOperator) {
     WorkflowLogicalOperator["AND"] = "and";
@@ -1692,17 +1680,25 @@ function genJSONStringifyKey() {
 function genJSONParseKey() {
     return letterStartSUID("JSONParse_");
 }
+function genXpertIteratorKey() {
+    return letterStartSUID("Iterator_");
+}
+function genXpertStartKey(key) {
+    return key + "_start";
+}
 function isAgentKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("agent_");
 }
 function isRouterKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("router_");
 }
-function isIteratingKey(key) {
+/**
+ * @deprecated use `isIteratorKey` instead
+ */ function isIteratingKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("iterating_");
 }
-function isWorkflowKey(key) {
-    return isRouterKey(key) || isIteratingKey(key);
+function isIteratorKey(key) {
+    return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("iterator_");
 }
 function workflowNodeIdentifier(node) {
     return node.title || node.key;
@@ -1746,33 +1742,12 @@ exports.XpertParameterTypeEnum = void 0;
     XpertParameterTypeEnum["BOOLEAN"] = "boolean";
     XpertParameterTypeEnum["SECRET"] = "secret";
 })(exports.XpertParameterTypeEnum || (exports.XpertParameterTypeEnum = {}));
-exports.ChatMessageTypeEnum = void 0;
-(function(ChatMessageTypeEnum) {
-    // LOG = 'log',
-    ChatMessageTypeEnum["MESSAGE"] = "message";
-    ChatMessageTypeEnum["EVENT"] = "event";
-})(exports.ChatMessageTypeEnum || (exports.ChatMessageTypeEnum = {}));
-exports.ChatMessageEventTypeEnum = void 0;
-(function(ChatMessageEventTypeEnum) {
-    ChatMessageEventTypeEnum["ON_CONVERSATION_START"] = "on_conversation_start";
-    ChatMessageEventTypeEnum["ON_CONVERSATION_END"] = "on_conversation_end";
-    ChatMessageEventTypeEnum["ON_MESSAGE_START"] = "on_message_start";
-    ChatMessageEventTypeEnum["ON_MESSAGE_END"] = "on_message_end";
-    ChatMessageEventTypeEnum["ON_TOOL_START"] = "on_tool_start";
-    ChatMessageEventTypeEnum["ON_TOOL_END"] = "on_tool_end";
-    ChatMessageEventTypeEnum["ON_TOOL_ERROR"] = "on_tool_error";
-    /**
-   * Step message in tool call
-   */ ChatMessageEventTypeEnum["ON_TOOL_MESSAGE"] = "on_tool_message";
-    ChatMessageEventTypeEnum["ON_AGENT_START"] = "on_agent_start";
-    ChatMessageEventTypeEnum["ON_AGENT_END"] = "on_agent_end";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_START"] = "on_retriever_start";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_END"] = "on_retriever_end";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_ERROR"] = "on_retriever_error";
-    ChatMessageEventTypeEnum["ON_INTERRUPT"] = "on_interrupt";
-    ChatMessageEventTypeEnum["ON_ERROR"] = "on_error";
-    ChatMessageEventTypeEnum["ON_CHAT_EVENT"] = "on_chat_event";
-})(exports.ChatMessageEventTypeEnum || (exports.ChatMessageEventTypeEnum = {}));
+// Helper guards
+function isXpertNodeType(type) {
+    return function(node) {
+        return node.type === type;
+    };
+}
 
 function agentLabel(agent) {
     return agent.title || agent.name || agent.key;
@@ -1913,14 +1888,17 @@ function _unsupported_iterable_to_array$4(o, minLen) {
  * @deprecated can use getCurrentTaskInput instead?
  */ var CONTEXT_VARIABLE_CURRENTSTATE = "currentState";
 var STATE_VARIABLE_SYS = "sys";
-var STATE_VARIABLE_HUMAN = "human";
 var GRAPH_NODE_SUMMARIZE_CONVERSATION = "summarize_conversation";
 var GRAPH_NODE_TITLE_CONVERSATION = "title_conversation";
 var STATE_VARIABLE_FILES = "files";
 var STATE_VARIABLE_INPUT = "input";
 var STATE_SYS_VOLUME = "volume";
-var STATE_SYS_WORKSPACE_PATH = "workspace_path";
-var STATE_SYS_WORKSPACE_URL = "workspace_url";
+/**
+ * Workspace path in sandbox environment
+ */ var STATE_SYS_WORKSPACE_PATH = "workspace_path";
+/**
+ * URL for workspace files in sandbox environment
+ */ var STATE_SYS_WORKSPACE_URL = "workspace_url";
 var STATE_VARIABLE_TITLE_CHANNEL = channelName("title");
 // Helpers
 function channelName(name) {
@@ -1929,7 +1907,12 @@ function channelName(name) {
 function messageContentText(content) {
     return typeof content === "string" ? content : content.type === "text" ? content.text : "";
 }
-function getWorkspaceFromRunnable(configurable) {
+/**
+ * Get workspace folder for sandbox from runnable configurable
+ * 
+ * @param configurable 
+ * @returns 
+ */ function getWorkspaceFromRunnable(configurable) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
         id: ""
@@ -2538,7 +2521,13 @@ function omitXpertRelations(xpert) {
     ]);
     return rest;
 }
-function figureOutXpert(xpert, isDraft) {
+/**
+ * Figure out latest xpert or draft xpert.
+ * 
+ * @param xpert 
+ * @param isDraft Is draft
+ * @returns 
+ */ function figureOutXpert(xpert, isDraft) {
     var _xpert_draft;
     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;
@@ -3032,6 +3021,12 @@ function genXpertSkillKey() {
     return letterStartSUID("Skill_");
 }
 
+function isMiddlewareToolEnabled(config) {
+    if (typeof config === "boolean") {
+        return config;
+    }
+    return (config === null || config === void 0 ? void 0 : config.enabled) !== false;
+}
 function genXpertMiddlewareKey() {
     return letterStartSUID("Middleware_");
 }
@@ -3368,7 +3363,9 @@ var IntegrationGitHubProvider = {
     };
 };
 
-var IntegrationLarkProvider = {
+/**
+ * @deprecated use plugin
+ */ var IntegrationLarkProvider = {
     name: exports.IntegrationEnum.LARK,
     label: {
         en_US: "Lark",
@@ -3750,11 +3747,12 @@ function _unsupported_iterable_to_array$1(o, minLen) {
         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);
     });
+    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
+        return _.name === (rest.join(".") || groupName);
+    });
     return {
         group: group,
-        variable: group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
-            return _.name === (rest.join(".") || groupName);
-        })
+        variable: selectVariable
     };
 }
 var FILE_VARIABLES = [
@@ -3800,6 +3798,10 @@ var FILE_VARIABLES = [
     }
 ];
 
+function isInterruptMessage(obj) {
+    return obj && typeof obj === "object" && "type" in obj && "category" in obj;
+}
+
 function _array_like_to_array(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];
@@ -3929,6 +3931,8 @@ exports.IntegrationGitHubProvider = IntegrationGitHubProvider;
 exports.IntegrationLarkProvider = IntegrationLarkProvider;
 exports.IteratingIndexParameterName = IteratingIndexParameterName;
 exports.IteratingItemParameterName = IteratingItemParameterName;
+exports.IteratorIndexParameterName = IteratorIndexParameterName;
+exports.IteratorItemParameterName = IteratorItemParameterName;
 exports.KDocumentSourceType = KDocumentSourceType;
 exports.KDocumentWebTypeOptions = KDocumentWebTypeOptions;
 exports.KNOWLEDGE_DOCUMENTS_NAME = KNOWLEDGE_DOCUMENTS_NAME;
@@ -3950,7 +3954,6 @@ exports.STATE_SYS_VOLUME = STATE_SYS_VOLUME;
 exports.STATE_SYS_WORKSPACE_PATH = STATE_SYS_WORKSPACE_PATH;
 exports.STATE_SYS_WORKSPACE_URL = STATE_SYS_WORKSPACE_URL;
 exports.STATE_VARIABLE_FILES = STATE_VARIABLE_FILES;
-exports.STATE_VARIABLE_HUMAN = STATE_VARIABLE_HUMAN;
 exports.STATE_VARIABLE_INPUT = STATE_VARIABLE_INPUT;
 exports.STATE_VARIABLE_SYS = STATE_VARIABLE_SYS;
 exports.STATE_VARIABLE_TITLE_CHANNEL = STATE_VARIABLE_TITLE_CHANNEL;
@@ -3959,6 +3962,7 @@ exports.TASK_DESCRIPTION_SUFFIX = TASK_DESCRIPTION_SUFFIX;
 exports.TENANT_AGENT_LOCAL_URL = TENANT_AGENT_LOCAL_URL;
 exports.TOOL_NAME_REGEX = TOOL_NAME_REGEX;
 exports.TranslationLanguageMap = TranslationLanguageMap;
+exports.USAGE_HOUR_FORMAT = USAGE_HOUR_FORMAT;
 exports.VariableOperations = VariableOperations;
 exports.agentLabel = agentLabel;
 exports.agentUniqueName = agentUniqueName;
@@ -3990,8 +3994,10 @@ exports.genXpertDBInsertKey = genXpertDBInsertKey;
 exports.genXpertDBQueryKey = genXpertDBQueryKey;
 exports.genXpertDBSqlKey = genXpertDBSqlKey;
 exports.genXpertDBUpdateKey = genXpertDBUpdateKey;
+exports.genXpertIteratorKey = genXpertIteratorKey;
 exports.genXpertMiddlewareKey = genXpertMiddlewareKey;
 exports.genXpertSkillKey = genXpertSkillKey;
+exports.genXpertStartKey = genXpertStartKey;
 exports.genXpertTriggerKey = genXpertTriggerKey;
 exports.generateCronExpression = generateCronExpression;
 exports.getAgentMiddlewareNodes = getAgentMiddlewareNodes;
@@ -4011,12 +4017,15 @@ exports.isAudioType = isAudioType;
 exports.isDocumentSheet = isDocumentSheet;
 exports.isEnableTool = isEnableTool;
 exports.isImageType = isImageType;
+exports.isInterruptMessage = isInterruptMessage;
 exports.isIteratingKey = isIteratingKey;
+exports.isIteratorKey = isIteratorKey;
 exports.isMessageGroup = isMessageGroup;
+exports.isMiddlewareToolEnabled = isMiddlewareToolEnabled;
 exports.isRouterKey = isRouterKey;
 exports.isToolEnabled = isToolEnabled;
 exports.isVideoType = isVideoType;
-exports.isWorkflowKey = isWorkflowKey;
+exports.isXpertNodeType = isXpertNodeType;
 exports.letterStartSUID = letterStartSUID;
 exports.locateNodes = locateNodes;
 exports.mapTranslationLanguage = mapTranslationLanguage;
@@ -4028,3 +4037,9 @@ exports.transformInstallation = transformInstallation;
 exports.uuid = uuid;
 exports.workflowNodeIdentifier = workflowNodeIdentifier;
 exports.xpertLabel = xpertLabel;
+Object.keys(chatkitTypes).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return chatkitTypes[k]; }
+  });
+});

package/index.esm.js

@@ -1,4 +1,5 @@
 import ShortUniqueId from 'short-unique-id';
+export * from '@xpert-ai/chatkit-types';
 
 function _array_like_to_array$5(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -1471,32 +1472,6 @@ var ChatGatewayEvent;
     ChatGatewayEvent["Agent"] = "agent";
 })(ChatGatewayEvent || (ChatGatewayEvent = {}));
 
-var ChatMessageStepCategory;
-(function(ChatMessageStepCategory) {
-    /**
-   * List of items: urls, files, etc.
-   */ ChatMessageStepCategory["List"] = "list";
-    /**
-   * Websearch results
-   */ ChatMessageStepCategory["WebSearch"] = "web_search";
-    /**
-   * Files list
-   */ ChatMessageStepCategory["Files"] = "files";
-    /**
-   * View a file
-   */ ChatMessageStepCategory["File"] = "file";
-    /**
-   * Program Execution
-   */ ChatMessageStepCategory["Program"] = "program";
-    /**
-   * Iframe
-   */ ChatMessageStepCategory["Iframe"] = "iframe";
-    ChatMessageStepCategory["Memory"] = "memory";
-    ChatMessageStepCategory["Tasks"] = "tasks";
-    /**
-   * Knowledges (knowledge base retriever results)
-   */ ChatMessageStepCategory["Knowledges"] = "knowledges";
-})(ChatMessageStepCategory || (ChatMessageStepCategory = {}));
 // Type guards
 /**
  * @deprecated use content in message
@@ -1513,6 +1488,8 @@ var ChatMessageFeedbackRatingEnum;
 var MEMORY_QA_PROMPT = "Summarize the experience of the above conversation and output a short question and answer.";
 var MEMORY_PROFILE_PROMPT = "Extract new user profile information from the above conversation in one short sentence. If no new information is available, return nothing.";
 
+var USAGE_HOUR_FORMAT = "yyyy-MM-dd HH";
+
 var AiProviderRole;
 (function(AiProviderRole) {
     AiProviderRole["Primary"] = "primary";
@@ -1580,6 +1557,8 @@ var KDocumentWebTypeOptions = [
 
 var WorkflowNodeTypeEnum;
 (function(WorkflowNodeTypeEnum) {
+    WorkflowNodeTypeEnum["START"] = "start";
+    WorkflowNodeTypeEnum["END"] = "end";
     /**
    * Trigger
    */ WorkflowNodeTypeEnum["TRIGGER"] = "trigger";
@@ -1591,7 +1570,10 @@ var WorkflowNodeTypeEnum;
    */ WorkflowNodeTypeEnum["IF_ELSE"] = "if-else";
     WorkflowNodeTypeEnum["LIST_OPERATOR"] = "list-operator";
     WorkflowNodeTypeEnum["VARIABLE_AGGREGATOR"] = "variable-aggregator";
-    WorkflowNodeTypeEnum["ITERATING"] = "iterating";
+    /**
+   * @deprecated use ITERATOR instead
+   */ WorkflowNodeTypeEnum["ITERATING"] = "iterating";
+    WorkflowNodeTypeEnum["ITERATOR"] = "iterator";
     WorkflowNodeTypeEnum["HTTP"] = "http";
     WorkflowNodeTypeEnum["SUBFLOW"] = "subflow";
     WorkflowNodeTypeEnum["TOOL"] = "tool";
@@ -1648,9 +1630,15 @@ var VariableOperationEnum;
     VariableOperationEnum["CLEAR"] = "clear";
 })(VariableOperationEnum || (VariableOperationEnum = {}));
 /**
- * The parameter name that represents the entire current element in array
+ * @deprecated use `IteratorItemParameterName` instead
  */ var IteratingItemParameterName = "$item";
-var IteratingIndexParameterName = "$index";
+/**
+ * @deprecated use `IteratorIndexParameterName` instead
+ */ var IteratingIndexParameterName = "$index";
+/**
+ * The parameter name that represents the entire current element in array
+ */ var IteratorItemParameterName = "$item";
+var IteratorIndexParameterName = "$index";
 var WorkflowLogicalOperator;
 (function(WorkflowLogicalOperator) {
     WorkflowLogicalOperator["AND"] = "and";
@@ -1690,17 +1678,25 @@ function genJSONStringifyKey() {
 function genJSONParseKey() {
     return letterStartSUID("JSONParse_");
 }
+function genXpertIteratorKey() {
+    return letterStartSUID("Iterator_");
+}
+function genXpertStartKey(key) {
+    return key + "_start";
+}
 function isAgentKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("agent_");
 }
 function isRouterKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("router_");
 }
-function isIteratingKey(key) {
+/**
+ * @deprecated use `isIteratorKey` instead
+ */ function isIteratingKey(key) {
     return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("iterating_");
 }
-function isWorkflowKey(key) {
-    return isRouterKey(key) || isIteratingKey(key);
+function isIteratorKey(key) {
+    return key === null || key === void 0 ? void 0 : key.toLowerCase().startsWith("iterator_");
 }
 function workflowNodeIdentifier(node) {
     return node.title || node.key;
@@ -1744,33 +1740,12 @@ var XpertParameterTypeEnum;
     XpertParameterTypeEnum["BOOLEAN"] = "boolean";
     XpertParameterTypeEnum["SECRET"] = "secret";
 })(XpertParameterTypeEnum || (XpertParameterTypeEnum = {}));
-var ChatMessageTypeEnum;
-(function(ChatMessageTypeEnum) {
-    // LOG = 'log',
-    ChatMessageTypeEnum["MESSAGE"] = "message";
-    ChatMessageTypeEnum["EVENT"] = "event";
-})(ChatMessageTypeEnum || (ChatMessageTypeEnum = {}));
-var ChatMessageEventTypeEnum;
-(function(ChatMessageEventTypeEnum) {
-    ChatMessageEventTypeEnum["ON_CONVERSATION_START"] = "on_conversation_start";
-    ChatMessageEventTypeEnum["ON_CONVERSATION_END"] = "on_conversation_end";
-    ChatMessageEventTypeEnum["ON_MESSAGE_START"] = "on_message_start";
-    ChatMessageEventTypeEnum["ON_MESSAGE_END"] = "on_message_end";
-    ChatMessageEventTypeEnum["ON_TOOL_START"] = "on_tool_start";
-    ChatMessageEventTypeEnum["ON_TOOL_END"] = "on_tool_end";
-    ChatMessageEventTypeEnum["ON_TOOL_ERROR"] = "on_tool_error";
-    /**
-   * Step message in tool call
-   */ ChatMessageEventTypeEnum["ON_TOOL_MESSAGE"] = "on_tool_message";
-    ChatMessageEventTypeEnum["ON_AGENT_START"] = "on_agent_start";
-    ChatMessageEventTypeEnum["ON_AGENT_END"] = "on_agent_end";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_START"] = "on_retriever_start";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_END"] = "on_retriever_end";
-    ChatMessageEventTypeEnum["ON_RETRIEVER_ERROR"] = "on_retriever_error";
-    ChatMessageEventTypeEnum["ON_INTERRUPT"] = "on_interrupt";
-    ChatMessageEventTypeEnum["ON_ERROR"] = "on_error";
-    ChatMessageEventTypeEnum["ON_CHAT_EVENT"] = "on_chat_event";
-})(ChatMessageEventTypeEnum || (ChatMessageEventTypeEnum = {}));
+// Helper guards
+function isXpertNodeType(type) {
+    return function(node) {
+        return node.type === type;
+    };
+}
 
 function agentLabel(agent) {
     return agent.title || agent.name || agent.key;
@@ -1911,14 +1886,17 @@ function _unsupported_iterable_to_array$4(o, minLen) {
  * @deprecated can use getCurrentTaskInput instead?
  */ var CONTEXT_VARIABLE_CURRENTSTATE = "currentState";
 var STATE_VARIABLE_SYS = "sys";
-var STATE_VARIABLE_HUMAN = "human";
 var GRAPH_NODE_SUMMARIZE_CONVERSATION = "summarize_conversation";
 var GRAPH_NODE_TITLE_CONVERSATION = "title_conversation";
 var STATE_VARIABLE_FILES = "files";
 var STATE_VARIABLE_INPUT = "input";
 var STATE_SYS_VOLUME = "volume";
-var STATE_SYS_WORKSPACE_PATH = "workspace_path";
-var STATE_SYS_WORKSPACE_URL = "workspace_url";
+/**
+ * Workspace path in sandbox environment
+ */ var STATE_SYS_WORKSPACE_PATH = "workspace_path";
+/**
+ * URL for workspace files in sandbox environment
+ */ var STATE_SYS_WORKSPACE_URL = "workspace_url";
 var STATE_VARIABLE_TITLE_CHANNEL = channelName("title");
 // Helpers
 function channelName(name) {
@@ -1927,7 +1905,12 @@ function channelName(name) {
 function messageContentText(content) {
     return typeof content === "string" ? content : content.type === "text" ? content.text : "";
 }
-function getWorkspaceFromRunnable(configurable) {
+/**
+ * Get workspace folder for sandbox from runnable configurable
+ * 
+ * @param configurable 
+ * @returns 
+ */ function getWorkspaceFromRunnable(configurable) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
         id: ""
@@ -2536,7 +2519,13 @@ function omitXpertRelations(xpert) {
     ]);
     return rest;
 }
-function figureOutXpert(xpert, isDraft) {
+/**
+ * Figure out latest xpert or draft xpert.
+ * 
+ * @param xpert 
+ * @param isDraft Is draft
+ * @returns 
+ */ function figureOutXpert(xpert, isDraft) {
     var _xpert_draft;
     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;
@@ -3030,6 +3019,12 @@ function genXpertSkillKey() {
     return letterStartSUID("Skill_");
 }
 
+function isMiddlewareToolEnabled(config) {
+    if (typeof config === "boolean") {
+        return config;
+    }
+    return (config === null || config === void 0 ? void 0 : config.enabled) !== false;
+}
 function genXpertMiddlewareKey() {
     return letterStartSUID("Middleware_");
 }
@@ -3366,7 +3361,9 @@ var IntegrationGitHubProvider = {
     };
 };
 
-var IntegrationLarkProvider = {
+/**
+ * @deprecated use plugin
+ */ var IntegrationLarkProvider = {
     name: IntegrationEnum.LARK,
     label: {
         en_US: "Lark",
@@ -3748,11 +3745,12 @@ function _unsupported_iterable_to_array$1(o, minLen) {
         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);
     });
+    var selectVariable = group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
+        return _.name === (rest.join(".") || groupName);
+    });
     return {
         group: group,
-        variable: group === null || group === void 0 ? void 0 : group.variables.find(function(_) {
-            return _.name === (rest.join(".") || groupName);
-        })
+        variable: selectVariable
     };
 }
 var FILE_VARIABLES = [
@@ -3798,6 +3796,10 @@ var FILE_VARIABLES = [
     }
 ];
 
+function isInterruptMessage(obj) {
+    return obj && typeof obj === "object" && "type" in obj && "category" in obj;
+}
+
 function _array_like_to_array(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];
@@ -3906,4 +3908,4 @@ var InterruptMessageType;
     InterruptMessageType["Select"] = "select";
 })(InterruptMessageType || (InterruptMessageType = {}));
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, 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_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, 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, KBDocumentCategoryEnum, KBDocumentStatusEnum, KDocumentSourceType, KDocumentWebTypeEnum, KDocumentWebTypeOptions, KNOWLEDGE_DOCUMENTS_NAME, KNOWLEDGE_FOLDER_ID_NAME, KNOWLEDGE_SOURCES_NAME, KNOWLEDGE_STAGE_NAME, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseTypeEnum, 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, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RoleTypeEnum, RolesEnum, SMTPSecureEnum, STANDARD_METADATA_FIELDS, 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, 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, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, extractSemanticModelDraft, figureOutXpert, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isIteratingKey, isMessageGroup, isRouterKey, isToolEnabled, isVideoType, isWorkflowKey, letterStartSUID, locateNodes, mapTranslationLanguage, messageContentText, omitXpertRelations, setStateVariable, shortTitle, transformInstallation, uuid, workflowNodeIdentifier, xpertLabel };
+export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CONTEXT_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageFeedbackRatingEnum, 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_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, 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, 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, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RoleTypeEnum, RolesEnum, SMTPSecureEnum, STANDARD_METADATA_FIELDS, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_URL, STATE_VARIABLE_FILES, STATE_VARIABLE_INPUT, STATE_VARIABLE_SYS, STATE_VARIABLE_TITLE_CHANNEL, 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, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, extractSemanticModelDraft, figureOutXpert, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isToolEnabled, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, messageContentText, omitXpertRelations, setStateVariable, shortTitle, transformInstallation, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metad/contracts",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -13,5 +13,9 @@
     "docs": "yarn typedoc --out ./.docs"
   },
   "module": "./index.esm.js",
-  "main": "./index.cjs.js"
+  "main": "./index.cjs.js",
+  "dependencies": {
+    "@a2ui/lit": "^0.8.1",
+    "@xpert-ai/chatkit-types": "^0.0.12"
+  }
 }