@xpert-ai/contracts 3.9.0-beta.2 → 3.9.0-beta.3

package/index.cjs.js

@@ -1516,7 +1516,7 @@ var OllamaEmbeddingsProviders = [
     exports.AiProvider.Ollama
 ];
 
-function _define_property$6(obj, key, value) {
+function _define_property$7(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1529,7 +1529,7 @@ function _define_property$6(obj, key, value) {
     }
     return obj;
 }
-function _object_spread$5(target) {
+function _object_spread$6(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -1539,18 +1539,24 @@ function _object_spread$5(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$6(target, key, source[key]);
+            _define_property$7(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";
+var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 function createConversationTitleSummaryEvent(event) {
-    return _object_spread$5({
+    return _object_spread$6({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
     }, event);
 }
+function createFollowUpConsumedEvent(event) {
+    return _object_spread$6({
+        type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
+    }, event);
+}
 
 /**
  * @deprecated use ChatMessageEventTypeEnum
@@ -1808,6 +1814,53 @@ function workflowNodeIdentifier(node) {
     return node.title || node.key;
 }
 
+function _define_property$6(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$5(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$6(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys$4(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props$4(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys$4(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 exports.XpertTypeEnum = void 0;
 (function(XpertTypeEnum) {
     /**
@@ -1820,6 +1873,17 @@ exports.XpertTypeEnum = void 0;
      * Knowledge Workflow
      */ XpertTypeEnum["Knowledge"] = "knowledge";
 })(exports.XpertTypeEnum || (exports.XpertTypeEnum = {}));
+/**
+ * Config for Agent execution (Langgraph.js)
+ */ var DEFAULT_XPERT_AGENT_RECURSION_LIMIT = 1000;
+function getXpertAgentRecursionLimit(agentConfig) {
+    return typeof (agentConfig === null || agentConfig === void 0 ? void 0 : agentConfig.recursionLimit) === "number" ? agentConfig.recursionLimit : DEFAULT_XPERT_AGENT_RECURSION_LIMIT;
+}
+function normalizeXpertAgentConfig(agentConfig) {
+    return _object_spread_props$4(_object_spread$5({}, agentConfig !== null && agentConfig !== void 0 ? agentConfig : {}), {
+        recursionLimit: getXpertAgentRecursionLimit(agentConfig)
+    });
+}
 exports.LongTermMemoryTypeEnum = void 0;
 (function(LongTermMemoryTypeEnum) {
     LongTermMemoryTypeEnum["PROFILE"] = "profile";
@@ -2003,6 +2067,9 @@ var STATE_SYS_VOLUME = "volume";
 /**
  * URL for workspace files in sandbox environment
  */ var STATE_SYS_WORKSPACE_URL = "workspace_url";
+/**
+ * Current runtime thread id
+ */ var STATE_SYS_THREAD_ID = "thread_id";
 var STATE_VARIABLE_TITLE_CHANNEL = channelName("title");
 // Helpers
 function channelName(name) {
@@ -2020,9 +2087,9 @@ function messageContentText(content) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
         id: ""
-    } : (configurable === null || configurable === void 0 ? void 0 : configurable.thread_id) ? {
-        type: "conversation",
-        id: configurable.thread_id
+    } : (configurable === null || configurable === void 0 ? void 0 : configurable.userId) || (configurable === null || configurable === void 0 ? void 0 : configurable.thread_id) ? {
+        type: "user",
+        id: ""
     } : {};
 }
 function getToolCallFromConfig(config) {
@@ -4795,6 +4862,7 @@ exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.API_PRINCIPAL_USER_ID_HEADER = API_PRINCIPAL_USER_ID_HEADER;
 exports.Attachment_Type_Options = Attachment_Type_Options;
 exports.CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY;
+exports.CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED;
 exports.CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE;
 exports.CONTEXT_VARIABLE_CURRENTSTATE = CONTEXT_VARIABLE_CURRENTSTATE;
 exports.DEFAULT_CURRENCIES = DEFAULT_CURRENCIES;
@@ -4806,6 +4874,7 @@ exports.DEFAULT_REVENUE_BASED_BONUS = DEFAULT_REVENUE_BASED_BONUS;
 exports.DEFAULT_SYSTEM_ROLES = DEFAULT_SYSTEM_ROLES;
 exports.DEFAULT_TENANT = DEFAULT_TENANT;
 exports.DEFAULT_TIME_FORMATS = DEFAULT_TIME_FORMATS;
+exports.DEFAULT_XPERT_AGENT_RECURSION_LIMIT = DEFAULT_XPERT_AGENT_RECURSION_LIMIT;
 exports.FILE_VARIABLES = FILE_VARIABLES;
 exports.GRAPH_NODE_SUMMARIZE_CONVERSATION = GRAPH_NODE_SUMMARIZE_CONVERSATION;
 exports.GRAPH_NODE_TITLE_CONVERSATION = GRAPH_NODE_TITLE_CONVERSATION;
@@ -4840,6 +4909,7 @@ exports.PermissionApprovalStatus = PermissionApprovalStatus;
 exports.PermissionGroups = PermissionGroups;
 exports.SANDBOX_WORK_FOR_TYPES = SANDBOX_WORK_FOR_TYPES;
 exports.STANDARD_METADATA_FIELDS = STANDARD_METADATA_FIELDS;
+exports.STATE_SYS_THREAD_ID = STATE_SYS_THREAD_ID;
 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;
@@ -4870,6 +4940,7 @@ exports.configurableStoreNamespace = configurableStoreNamespace;
 exports.convertToUrlPath = convertToUrlPath;
 exports.createAgentConnections = createAgentConnections;
 exports.createConversationTitleSummaryEvent = createConversationTitleSummaryEvent;
+exports.createFollowUpConsumedEvent = createFollowUpConsumedEvent;
 exports.createMessageAppendContextTracker = createMessageAppendContextTracker;
 exports.createXpertGraph = createXpertGraph;
 exports.createXpertNodes = createXpertNodes;
@@ -4911,6 +4982,7 @@ exports.getToolLabel = getToolLabel;
 exports.getVariableSchema = getVariableSchema;
 exports.getWorkflowTriggers = getWorkflowTriggers;
 exports.getWorkspaceFromRunnable = getWorkspaceFromRunnable;
+exports.getXpertAgentRecursionLimit = getXpertAgentRecursionLimit;
 exports.inferMessageAppendContext = inferMessageAppendContext;
 exports.isAgentKey = isAgentKey;
 exports.isAudioType = isAudioType;
@@ -4933,6 +5005,7 @@ exports.locateNodes = locateNodes;
 exports.mapTranslationLanguage = mapTranslationLanguage;
 exports.mergeMessageContentForDisplay = mergeMessageContentForDisplay;
 exports.messageContentText = messageContentText;
+exports.normalizeXpertAgentConfig = normalizeXpertAgentConfig;
 exports.omitXpertRelations = omitXpertRelations;
 exports.replaceAgentInDraft = replaceAgentInDraft;
 exports.resolveMessageAppendContext = resolveMessageAppendContext;

package/index.esm.js

@@ -1514,7 +1514,7 @@ var OllamaEmbeddingsProviders = [
     AiProvider.Ollama
 ];
 
-function _define_property$6(obj, key, value) {
+function _define_property$7(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -1527,7 +1527,7 @@ function _define_property$6(obj, key, value) {
     }
     return obj;
 }
-function _object_spread$5(target) {
+function _object_spread$6(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
         var ownKeys = Object.keys(source);
@@ -1537,18 +1537,24 @@ function _object_spread$5(target) {
             }));
         }
         ownKeys.forEach(function(key) {
-            _define_property$6(target, key, source[key]);
+            _define_property$7(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";
+var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 function createConversationTitleSummaryEvent(event) {
-    return _object_spread$5({
+    return _object_spread$6({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
     }, event);
 }
+function createFollowUpConsumedEvent(event) {
+    return _object_spread$6({
+        type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
+    }, event);
+}
 
 /**
  * @deprecated use ChatMessageEventTypeEnum
@@ -1806,6 +1812,53 @@ function workflowNodeIdentifier(node) {
     return node.title || node.key;
 }
 
+function _define_property$6(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$5(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$6(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys$4(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props$4(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys$4(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 var XpertTypeEnum;
 (function(XpertTypeEnum) {
     /**
@@ -1818,6 +1871,17 @@ var XpertTypeEnum;
      * Knowledge Workflow
      */ XpertTypeEnum["Knowledge"] = "knowledge";
 })(XpertTypeEnum || (XpertTypeEnum = {}));
+/**
+ * Config for Agent execution (Langgraph.js)
+ */ var DEFAULT_XPERT_AGENT_RECURSION_LIMIT = 1000;
+function getXpertAgentRecursionLimit(agentConfig) {
+    return typeof (agentConfig === null || agentConfig === void 0 ? void 0 : agentConfig.recursionLimit) === "number" ? agentConfig.recursionLimit : DEFAULT_XPERT_AGENT_RECURSION_LIMIT;
+}
+function normalizeXpertAgentConfig(agentConfig) {
+    return _object_spread_props$4(_object_spread$5({}, agentConfig !== null && agentConfig !== void 0 ? agentConfig : {}), {
+        recursionLimit: getXpertAgentRecursionLimit(agentConfig)
+    });
+}
 var LongTermMemoryTypeEnum;
 (function(LongTermMemoryTypeEnum) {
     LongTermMemoryTypeEnum["PROFILE"] = "profile";
@@ -2001,6 +2065,9 @@ var STATE_SYS_VOLUME = "volume";
 /**
  * URL for workspace files in sandbox environment
  */ var STATE_SYS_WORKSPACE_URL = "workspace_url";
+/**
+ * Current runtime thread id
+ */ var STATE_SYS_THREAD_ID = "thread_id";
 var STATE_VARIABLE_TITLE_CHANNEL = channelName("title");
 // Helpers
 function channelName(name) {
@@ -2018,9 +2085,9 @@ function messageContentText(content) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
         id: ""
-    } : (configurable === null || configurable === void 0 ? void 0 : configurable.thread_id) ? {
-        type: "conversation",
-        id: configurable.thread_id
+    } : (configurable === null || configurable === void 0 ? void 0 : configurable.userId) || (configurable === null || configurable === void 0 ? void 0 : configurable.thread_id) ? {
+        type: "user",
+        id: ""
     } : {};
 }
 function getToolCallFromConfig(config) {
@@ -4789,4 +4856,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_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, 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, 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_WORK_FOR_TYPES, 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, 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, createMessageAppendContextTracker, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, extractSemanticModelDraft, figureOutXpert, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, inferMessageAppendContext, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isSystemManagedAssistant, isToolEnabled, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, omitXpertRelations, replaceAgentInDraft, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, 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_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageEventTypeEnum, ChatMessageFeedbackRatingEnum, ChatMessageStepCategory, ChatMessageTypeEnum, ClientFocusEnum, ConfigurateMethod, ContactOrganizationInviteStatus, ContactType, CredentialFormTypeEnum, CredentialsType, CrudActionEnum, CurrenciesEnum, CurrencyPosition, DEFAULT_CURRENCIES, DEFAULT_DATE_FORMATS, DEFAULT_INTEGRATION_PAID_FILTERS, DEFAULT_INVITE_EXPIRY_PERIOD, DEFAULT_PROFIT_BASED_BONUS, DEFAULT_REVENUE_BASED_BONUS, DEFAULT_SYSTEM_ROLES, DEFAULT_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, DEFAULT_XPERT_AGENT_RECURSION_LIMIT, DataSourceProtocolEnum, DataSourceSyntaxEnum, DataSourceTypeEnum, DefaultValueDateTypeEnum, DocumentSourceProviderCategoryEnum, DocumentTypeEnum, EmailTemplateEnum, EmailTemplateNameEnum, EmbeddingStatusEnum, FILE_VARIABLES, FeatureEnum, FeatureStatusEnum, FeedTypeEnum, FetchFrom, FileStorageProviderEnum, GRAPH_NODE_SUMMARIZE_CONVERSATION, GRAPH_NODE_TITLE_CONVERSATION, HttpStatus, IFeatureToggleTypeEnum, INTEGRATION_PROVIDERS, ImportHistoryStatusEnum, ImportTypeEnum, IndicatorDraftFields, IndicatorOptionFields, IndicatorStatusEnum, IndicatorTagEnum, IndicatorType, IntegrationEnum, IntegrationFeatureEnum, IntegrationFilterEnum, IntegrationGitHubProvider, IntegrationLarkProvider, InterruptMessageType, InvitationExpirationEnum, InvitationTypeEnum, InviteStatusEnum, IteratingIndexParameterName, IteratingItemParameterName, IteratorIndexParameterName, IteratorItemParameterName, KBDocumentCategoryEnum, KBDocumentStatusEnum, KDocumentSourceType, KDocumentWebTypeEnum, KDocumentWebTypeOptions, KNOWLEDGE_DOCUMENTS_NAME, KNOWLEDGE_FOLDER_ID_NAME, KNOWLEDGE_SOURCES_NAME, KNOWLEDGE_STAGE_NAME, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseTypeEnum, 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_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, 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, extractSemanticModelDraft, figureOutXpert, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, getXpertAgentRecursionLimit, inferMessageAppendContext, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isSystemManagedAssistant, isToolEnabled, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.9.0-beta.2",
+  "version": "3.9.0-beta.3",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/agent/graph.d.ts

@@ -24,6 +24,10 @@ export declare const STATE_SYS_WORKSPACE_PATH = "workspace_path";
  * URL for workspace files in sandbox environment
  */
 export declare const STATE_SYS_WORKSPACE_URL = "workspace_url";
+/**
+ * Current runtime thread id
+ */
+export declare const STATE_SYS_THREAD_ID = "thread_id";
 export declare const STATE_VARIABLE_TITLE_CHANNEL: string;
 export type TMessageChannel = {
     system: string;
@@ -93,6 +97,16 @@ export type TAgentRunnableConfigurable = {
      * Execution id of agent workflow node
      */
     executionId: string;
+    /**
+     * Root execution id of the current agent run.
+     * Nested subgraphs keep writing steer follow-ups back into this execution.
+     */
+    rootExecutionId?: string;
+    /**
+     * Root agent key of the current agent run.
+     * Nested subgraphs use this as the primary transcript/log channel.
+     */
+    rootAgentKey?: string;
     /**
      * Sandbox backend context
      */
@@ -117,7 +131,7 @@ export declare function messageContentText(content: string | TMessageContentComp
  * @returns
  */
 export declare function getWorkspaceFromRunnable(configurable: TAgentRunnableConfigurable): {
-    type?: 'project' | 'conversation';
+    type?: 'project' | 'user';
     id?: string;
 };
 export declare function getToolCallFromConfig(config: any): TToolCall;

package/src/ai/assistant-binding.model.d.ts

@@ -31,9 +31,10 @@ export interface IAssistantBindingSkillPreference {
     disabledSkillIds: string[];
 }
 export interface IAssistantBindingConversationPreferences {
-    version: 1;
+    version: 2;
     defaultThreadId?: string | null;
     lastThreadId?: string | null;
+    defaultFollowUpBehavior?: 'queue' | 'steer';
 }
 export interface IAssistantBindingToolPreferences {
     version: 1;

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

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

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

@@ -42,6 +42,10 @@ export interface IChatMessage extends IBasePerTenantAndOrganizationEntityModel,
     conversationId?: string | null;
     executionId?: string;
     execution?: IXpertAgentExecution;
+    followUpMode?: 'queue' | 'steer';
+    followUpStatus?: 'pending' | 'consumed' | 'canceled';
+    targetExecutionId?: string | null;
+    visibleAt?: Date | string | null;
 }
 /**
  * @deprecated

package/src/ai/types.d.ts

@@ -38,6 +38,50 @@ export declare enum EmbeddingStatusEnum {
     REQUIRED = "required"
 }
 export declare const Attachment_Type_Options: TSelectOption<string, TXpertAttachmentType>[];
+export type JsonSchemaUIExtensions = {
+    /**
+     * UI component variant, or custom component name
+     */
+    component?: 'textarea' | 'select' | 'radio' | 'checkbox' | 'switch' | 'password' | string;
+    /**
+     * UI component display span (for grid layouts)
+     */
+    span?: number;
+    /**
+     * UI component column count (for grid layouts)
+     */
+    cols?: number;
+    /**
+     * Additional inputs for the Custom UI component
+     */
+    inputs?: Record<string, unknown>;
+    /**
+     * Whether this component supports selecting LangGraph state variables
+     */
+    variable?: boolean;
+    enumLabels?: Record<string, I18nObject | string>;
+    styles?: Record<string, string>;
+    /**
+     * Help url for this field
+     */
+    help?: I18nObject;
+    /**
+     * Field dependencies
+     */
+    depends?: (string | {
+        name: string;
+        alias?: string;
+    })[];
+    /**
+     * Whether multiple values can be selected (for select component)
+     */
+    multiple?: boolean;
+    /**
+     * Options values url for remote select component
+     */
+    selectUrl?: string;
+    revealable?: boolean;
+};
 type JsonSchema7Meta = {
     title?: I18nObject;
     default?: any;
@@ -46,26 +90,7 @@ type JsonSchema7Meta = {
     /**
      * UI schema extensions
      */
-    'x-ui'?: {
-        /**
-         * UI component variant, or custom component name
-         */
-        component?: 'textarea' | 'select' | 'radio' | 'checkbox' | 'switch' | 'password' | string;
-        /**
-         * UI component display span (for grid layouts)
-         */
-        span?: number;
-        /**
-         * Additional inputs for the Custom UI component
-         */
-        inputs?: Record<string, unknown>;
-        /**
-         * Whether this component supports selecting LangGraph state variables
-         */
-        variable?: boolean;
-        enumLabels?: Record<string, I18nObject | string>;
-        styles?: Record<string, string>;
-    };
+    'x-ui'?: JsonSchemaUIExtensions;
 };
 export type JsonSchemaObjectType = {
     type: "object";

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

@@ -1,5 +1,6 @@
 import type { TChatRequestHuman, TInterruptCommand } from '@xpert-ai/chatkit-types';
 import { STATE_VARIABLE_HUMAN } from '@xpert-ai/chatkit-types';
+export type TXpertFollowUpMode = 'queue' | 'steer';
 export type TXpertChatState = {
     [STATE_VARIABLE_HUMAN]?: TChatRequestHuman;
 } & Record<string, any>;
@@ -43,7 +44,18 @@ export type TXpertChatRetryRequest = {
     environmentId?: string;
     checkpointId?: string;
 };
-export type TChatRequest = TXpertChatSendRequest | TXpertChatResumeRequest | TXpertChatRetryRequest;
+export type TXpertChatFollowUpRequest = {
+    action: 'follow_up';
+    conversationId: string;
+    mode: TXpertFollowUpMode;
+    message: {
+        clientMessageId?: string;
+        input: TChatRequestHuman;
+    };
+    target?: TXpertChatTarget;
+    state?: TXpertChatState;
+};
+export type TChatRequest = TXpertChatSendRequest | TXpertChatResumeRequest | TXpertChatRetryRequest | TXpertChatFollowUpRequest;
 export type TXpertAgentChatRunRequest = {
     action: 'run';
     state: TXpertChatState;
@@ -63,4 +75,19 @@ export type TXpertAgentChatResumeRequest = {
     environmentId?: string;
     state?: TXpertChatState;
 };
-export type TXpertAgentChatRequest = TXpertAgentChatRunRequest | TXpertAgentChatResumeRequest;
+export type TXpertAgentChatFollowUpRequest = {
+    action: 'follow_up';
+    agentKey: string;
+    xpertId: string;
+    mode: TXpertFollowUpMode;
+    message: {
+        clientMessageId?: string;
+        input: TChatRequestHuman;
+    };
+    target?: {
+        executionId?: string;
+    };
+    environmentId?: string;
+    state?: TXpertChatState;
+};
+export type TXpertAgentChatRequest = TXpertAgentChatRunRequest | TXpertAgentChatResumeRequest | TXpertAgentChatFollowUpRequest;

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

@@ -209,9 +209,10 @@ export type TXpertOptions = {
 /**
  * Config for Agent execution (Langgraph.js)
  */
+export declare const DEFAULT_XPERT_AGENT_RECURSION_LIMIT = 1000;
 export type TXpertAgentConfig = {
     /**
-     * Maximum number of times a call can recurse. If not provided, defaults to 25.
+     * Maximum number of times a call can recurse. If not provided, defaults to 1000.
      */
     recursionLimit?: number;
     /** Maximum number of parallel calls to make. */
@@ -277,6 +278,17 @@ export type TXpertAgentConfig = {
         parameters?: Record<string, any>;
     }>;
 };
+export declare function getXpertAgentRecursionLimit(agentConfig?: {
+    recursionLimit?: number | null;
+} | null): number;
+export declare function normalizeXpertAgentConfig(): {
+    recursionLimit: number;
+};
+export declare function normalizeXpertAgentConfig<T extends {
+    recursionLimit?: number | null;
+}>(agentConfig: T): Omit<T, 'recursionLimit'> & {
+    recursionLimit: number;
+};
 export type TStateVariableType = XpertParameterTypeEnum | 'object' | 'array[string]' | 'array[number]' | 'array[object]';
 /**
  */