@xpert-ai/contracts 3.10.1 → 3.12.0

package/index.cjs.js

@@ -777,6 +777,8 @@ exports.FeatureEnum = void 0;
     FeatureEnum["FEATURE_ORGANIZATION_PROJECT"] = "FEATURE_ORGANIZATION_PROJECT";
     FeatureEnum["FEATURE_CONTACT"] = "FEATURE_CONTACT";
     FeatureEnum["FEATURE_USER"] = "FEATURE_USER";
+    FeatureEnum["FEATURE_USERS"] = "FEATURE_USERS";
+    FeatureEnum["FEATURE_USER_GROUPS"] = "FEATURE_USER_GROUPS";
     FeatureEnum["FEATURE_ORGANIZATIONS"] = "FEATURE_ORGANIZATIONS";
     // FEATURE_APP_INTEGRATION = 'FEATURE_APP_INTEGRATION',
     FeatureEnum["FEATURE_SETTING"] = "FEATURE_SETTING";
@@ -1120,6 +1122,7 @@ exports.AnalyticsFeatures = void 0;
     AnalyticsFeatures["FEATURE_STORY_CREATION"] = "FEATURE_STORY_CREATION";
     AnalyticsFeatures["FEATURE_STORY_VIEWER"] = "FEATURE_STORY_VIEWER";
     AnalyticsFeatures["FEATURE_STORY_MARKET"] = "FEATURE_STORY_MARKET";
+    AnalyticsFeatures["FEATURE_DATA_SOURCE"] = "FEATURE_DATA_SOURCE";
     AnalyticsFeatures["FEATURE_MODEL"] = "FEATURE_MODEL";
     AnalyticsFeatures["FEATURE_MODEL_CREATION"] = "FEATURE_MODEL_CREATION";
     AnalyticsFeatures["FEATURE_MODEL_VIEWER"] = "FEATURE_MODEL_VIEWER";
@@ -2163,6 +2166,7 @@ exports.AiFeatureEnum = void 0;
     AiFeatureEnum["FEATURE_COPILOT"] = "FEATURE_COPILOT";
     AiFeatureEnum["FEATURE_COPILOT_KNOWLEDGEBASE"] = "FEATURE_COPILOT_KNOWLEDGEBASE";
     AiFeatureEnum["FEATURE_COPILOT_CHAT"] = "FEATURE_COPILOT_CHAT";
+    AiFeatureEnum["FEATURE_COPILOT_MONITORING"] = "FEATURE_COPILOT_MONITORING";
     AiFeatureEnum["FEATURE_XPERT"] = "FEATURE_XPERT";
     AiFeatureEnum["FEATURE_XPERT_CHATBI"] = "FEATURE_XPERT_CHATBI";
     AiFeatureEnum["FEATURE_XPERT_CLAWXPERT"] = "FEATURE_XPERT_CLAWXPERT";
@@ -2242,7 +2246,10 @@ exports.WorkflowNodeTypeEnum = void 0;
     WorkflowNodeTypeEnum["HTTP"] = "http";
     WorkflowNodeTypeEnum["SUBFLOW"] = "subflow";
     WorkflowNodeTypeEnum["TOOL"] = "tool";
-    WorkflowNodeTypeEnum["AGENT_TOOL"] = "agent-tool";
+    WorkflowNodeTypeEnum["AGENT_WORKFLOW"] = "agent-workflow";
+    /**
+     * @deprecated use AGENT_WORKFLOW instead
+     */ WorkflowNodeTypeEnum["AGENT_TOOL"] = "agent-tool";
     WorkflowNodeTypeEnum["NOTE"] = "note";
     /**
      * Task node, distribute tasks to sub-agents
@@ -2328,6 +2335,12 @@ exports.WorkflowComparisonOperator = void 0;
     WorkflowComparisonOperator["LIKE"] = "like";
     WorkflowComparisonOperator["NOT_LIKE"] = "not-like";
 })(exports.WorkflowComparisonOperator || (exports.WorkflowComparisonOperator = {}));
+function isAgentWorkflowNodeType(type) {
+    return type === exports.WorkflowNodeTypeEnum.AGENT_WORKFLOW || type === exports.WorkflowNodeTypeEnum.AGENT_TOOL;
+}
+function isAgentWorkflowNode(node) {
+    return isAgentWorkflowNodeType(node === null || node === void 0 ? void 0 : node.type);
+}
 function genXpertTriggerKey() {
     return letterStartSUID("Trigger_");
 }
@@ -3795,6 +3808,8 @@ var Attachment_Type_Options = [
     }
 ];
 
+var XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+
 var TASK_DESCRIPTION_PREFIX = "Launch a new agent to handle complex, multi-step tasks autonomously. \n\nAvailable agent types and the tools they have access to:";
 var TASK_DESCRIPTION_SUFFIX = 'When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.\n\nWhen to use the Agent tool:\n- When you are instructed to execute custom slash commands. Use the Agent tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file")\n\nWhen NOT to use the Agent tool:\n- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly\n- If you are searching for a specific term or definition within a known location, use the Glob tool instead, to find the match more quickly\n- If you are searching for content within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly\n- Other tasks that are not related to the agent descriptions above\n\n\nUsage notes:\n1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses\n2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.\n3. Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.\n4. The agent\'s outputs should generally be trusted\n5. Clearly tell the agent whether you expect it to create content, perform analysis, or just do research (search, file reads, web fetches, etc.), since it is not aware of the user\'s intent\n6. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.\n\nExample usage:\n\n<example_agent_descriptions>\n"content-reviewer": use this agent after you are done creating significant content or documents\n"greeting-responder": use this agent when to respond to user greetings with a friendly joke\n"research-analyst": use this agent to conduct thorough research on complex topics\n</example_agent_description>\n\n<example>\nuser: "Please write a function that checks if a number is prime"\nassistant: Sure let me write a function that checks if a number is prime\nassistant: First let me use the Write tool to write a function that checks if a number is prime\nassistant: I\'m going to use the Write tool to write the following code:\n<code>\nfunction isPrime(n) {\n  if (n <= 1) return false\n  for (let i = 2; i * i <= n; i++) {\n    if (n % i === 0) return false\n  }\n  return true\n}\n</code>\n<commentary>\nSince significant content was created and the task was completed, now use the content-reviewer agent to review the work\n</commentary>\nassistant: Now let me use the content-reviewer agent to review the code\nassistant: Uses the Task tool to launch with the content-reviewer agent \n</example>\n\n<example>\nuser: "Can you help me research the environmental impact of different renewable energy sources and create a comprehensive report?"\n<commentary>\nThis is a complex research task that would benefit from using the research-analyst agent to conduct thorough analysis\n</commentary>\nassistant: I\'ll help you research the environmental impact of renewable energy sources. Let me use the research-analyst agent to conduct comprehensive research on this topic.\nassistant: Uses the Task tool to launch with the research-analyst agent, providing detailed instructions about what research to conduct and what format the report should take\n</example>\n\n<example>\nuser: "Hello"\n<commentary>\nSince the user is greeting, use the greeting-responder agent to respond with a friendly joke\n</commentary>\nassistant: "I\'m going to use the Task tool to launch with the greeting-responder agent"\n</example>';
 
@@ -5646,6 +5661,40 @@ var PLUGIN_LOAD_STATUS = {
     LOADED: "loaded",
     FAILED: "failed"
 };
+var PLUGIN_COMPONENT_TYPE = {
+    SKILL: "skill",
+    MCP_SERVER: "mcp_server",
+    APP: "app",
+    HOOK: "hook",
+    ASSET: "asset"
+};
+var PLUGIN_MARKETPLACE_INSTALLATION_POLICY = {
+    AVAILABLE: "AVAILABLE",
+    INSTALLED_BY_DEFAULT: "INSTALLED_BY_DEFAULT",
+    NOT_AVAILABLE: "NOT_AVAILABLE"
+};
+var PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY = {
+    ON_INSTALL: "ON_INSTALL",
+    ON_FIRST_USE: "ON_FIRST_USE",
+    NONE: "NONE"
+};
+var PLUGIN_MCP_TOOL_APPROVAL_MODE = {
+    PROMPT: "prompt",
+    APPROVE: "approve",
+    DENY: "deny"
+};
+var PLUGIN_RESOURCE_RUNTIME_TYPE = {
+    SKILL_PACKAGE: "skill_package",
+    TOOLSET: "toolset",
+    HOOK_PROFILE: "hook_profile",
+    APP_CONNECTOR: "app_connector"
+};
+var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
+    READY: "ready",
+    PENDING_AUTH: "pending_auth",
+    BLOCKED: "blocked",
+    FAILED: "failed"
+};
 
 exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.API_PRINCIPAL_USER_ID_HEADER = API_PRINCIPAL_USER_ID_HEADER;
@@ -5695,9 +5744,15 @@ exports.MEMORY_PROFILE_PROMPT = MEMORY_PROFILE_PROMPT;
 exports.MEMORY_QA_PROMPT = MEMORY_QA_PROMPT;
 exports.OllamaEmbeddingsProviders = OllamaEmbeddingsProviders;
 exports.OpenAIEmbeddingsProviders = OpenAIEmbeddingsProviders;
+exports.PLUGIN_COMPONENT_TYPE = PLUGIN_COMPONENT_TYPE;
 exports.PLUGIN_CONFIGURATION_STATUS = PLUGIN_CONFIGURATION_STATUS;
 exports.PLUGIN_LEVEL = PLUGIN_LEVEL;
 exports.PLUGIN_LOAD_STATUS = PLUGIN_LOAD_STATUS;
+exports.PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY = PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY;
+exports.PLUGIN_MARKETPLACE_INSTALLATION_POLICY = PLUGIN_MARKETPLACE_INSTALLATION_POLICY;
+exports.PLUGIN_MCP_TOOL_APPROVAL_MODE = PLUGIN_MCP_TOOL_APPROVAL_MODE;
+exports.PLUGIN_RESOURCE_INSTALLATION_STATUS = PLUGIN_RESOURCE_INSTALLATION_STATUS;
+exports.PLUGIN_RESOURCE_RUNTIME_TYPE = PLUGIN_RESOURCE_RUNTIME_TYPE;
 exports.PLUGIN_SOURCE = PLUGIN_SOURCE;
 exports.PermissionApprovalStatus = PermissionApprovalStatus;
 exports.PermissionGroups = PermissionGroups;
@@ -5730,6 +5785,7 @@ exports.USAGE_HOUR_FORMAT = USAGE_HOUR_FORMAT;
 exports.VariableOperations = VariableOperations;
 exports.WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME = WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME;
 exports.WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER = WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER;
+exports.XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY;
 exports.agentLabel = agentLabel;
 exports.agentUniqueName = agentUniqueName;
 exports.allChannels = allChannels;
@@ -5796,6 +5852,8 @@ exports.getXpertAgentRecursionLimit = getXpertAgentRecursionLimit;
 exports.getXpertWorkspaceVisibility = getXpertWorkspaceVisibility;
 exports.inferMessageAppendContext = inferMessageAppendContext;
 exports.isAgentKey = isAgentKey;
+exports.isAgentWorkflowNode = isAgentWorkflowNode;
+exports.isAgentWorkflowNodeType = isAgentWorkflowNodeType;
 exports.isAssistantBindingSkillEnabled = isAssistantBindingSkillEnabled;
 exports.isAssistantBindingToolEnabled = isAssistantBindingToolEnabled;
 exports.isAssistantBindingToolPreferencesEmpty = isAssistantBindingToolPreferencesEmpty;

package/index.esm.js

@@ -775,6 +775,8 @@ var FeatureEnum;
     FeatureEnum["FEATURE_ORGANIZATION_PROJECT"] = "FEATURE_ORGANIZATION_PROJECT";
     FeatureEnum["FEATURE_CONTACT"] = "FEATURE_CONTACT";
     FeatureEnum["FEATURE_USER"] = "FEATURE_USER";
+    FeatureEnum["FEATURE_USERS"] = "FEATURE_USERS";
+    FeatureEnum["FEATURE_USER_GROUPS"] = "FEATURE_USER_GROUPS";
     FeatureEnum["FEATURE_ORGANIZATIONS"] = "FEATURE_ORGANIZATIONS";
     // FEATURE_APP_INTEGRATION = 'FEATURE_APP_INTEGRATION',
     FeatureEnum["FEATURE_SETTING"] = "FEATURE_SETTING";
@@ -1118,6 +1120,7 @@ var AnalyticsFeatures;
     AnalyticsFeatures["FEATURE_STORY_CREATION"] = "FEATURE_STORY_CREATION";
     AnalyticsFeatures["FEATURE_STORY_VIEWER"] = "FEATURE_STORY_VIEWER";
     AnalyticsFeatures["FEATURE_STORY_MARKET"] = "FEATURE_STORY_MARKET";
+    AnalyticsFeatures["FEATURE_DATA_SOURCE"] = "FEATURE_DATA_SOURCE";
     AnalyticsFeatures["FEATURE_MODEL"] = "FEATURE_MODEL";
     AnalyticsFeatures["FEATURE_MODEL_CREATION"] = "FEATURE_MODEL_CREATION";
     AnalyticsFeatures["FEATURE_MODEL_VIEWER"] = "FEATURE_MODEL_VIEWER";
@@ -2161,6 +2164,7 @@ var AiFeatureEnum;
     AiFeatureEnum["FEATURE_COPILOT"] = "FEATURE_COPILOT";
     AiFeatureEnum["FEATURE_COPILOT_KNOWLEDGEBASE"] = "FEATURE_COPILOT_KNOWLEDGEBASE";
     AiFeatureEnum["FEATURE_COPILOT_CHAT"] = "FEATURE_COPILOT_CHAT";
+    AiFeatureEnum["FEATURE_COPILOT_MONITORING"] = "FEATURE_COPILOT_MONITORING";
     AiFeatureEnum["FEATURE_XPERT"] = "FEATURE_XPERT";
     AiFeatureEnum["FEATURE_XPERT_CHATBI"] = "FEATURE_XPERT_CHATBI";
     AiFeatureEnum["FEATURE_XPERT_CLAWXPERT"] = "FEATURE_XPERT_CLAWXPERT";
@@ -2240,7 +2244,10 @@ var WorkflowNodeTypeEnum;
     WorkflowNodeTypeEnum["HTTP"] = "http";
     WorkflowNodeTypeEnum["SUBFLOW"] = "subflow";
     WorkflowNodeTypeEnum["TOOL"] = "tool";
-    WorkflowNodeTypeEnum["AGENT_TOOL"] = "agent-tool";
+    WorkflowNodeTypeEnum["AGENT_WORKFLOW"] = "agent-workflow";
+    /**
+     * @deprecated use AGENT_WORKFLOW instead
+     */ WorkflowNodeTypeEnum["AGENT_TOOL"] = "agent-tool";
     WorkflowNodeTypeEnum["NOTE"] = "note";
     /**
      * Task node, distribute tasks to sub-agents
@@ -2326,6 +2333,12 @@ var WorkflowComparisonOperator;
     WorkflowComparisonOperator["LIKE"] = "like";
     WorkflowComparisonOperator["NOT_LIKE"] = "not-like";
 })(WorkflowComparisonOperator || (WorkflowComparisonOperator = {}));
+function isAgentWorkflowNodeType(type) {
+    return type === WorkflowNodeTypeEnum.AGENT_WORKFLOW || type === WorkflowNodeTypeEnum.AGENT_TOOL;
+}
+function isAgentWorkflowNode(node) {
+    return isAgentWorkflowNodeType(node === null || node === void 0 ? void 0 : node.type);
+}
 function genXpertTriggerKey() {
     return letterStartSUID("Trigger_");
 }
@@ -3793,6 +3806,8 @@ var Attachment_Type_Options = [
     }
 ];
 
+var XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+
 var TASK_DESCRIPTION_PREFIX = "Launch a new agent to handle complex, multi-step tasks autonomously. \n\nAvailable agent types and the tools they have access to:";
 var TASK_DESCRIPTION_SUFFIX = 'When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.\n\nWhen to use the Agent tool:\n- When you are instructed to execute custom slash commands. Use the Agent tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file")\n\nWhen NOT to use the Agent tool:\n- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly\n- If you are searching for a specific term or definition within a known location, use the Glob tool instead, to find the match more quickly\n- If you are searching for content within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly\n- Other tasks that are not related to the agent descriptions above\n\n\nUsage notes:\n1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses\n2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.\n3. Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.\n4. The agent\'s outputs should generally be trusted\n5. Clearly tell the agent whether you expect it to create content, perform analysis, or just do research (search, file reads, web fetches, etc.), since it is not aware of the user\'s intent\n6. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.\n\nExample usage:\n\n<example_agent_descriptions>\n"content-reviewer": use this agent after you are done creating significant content or documents\n"greeting-responder": use this agent when to respond to user greetings with a friendly joke\n"research-analyst": use this agent to conduct thorough research on complex topics\n</example_agent_description>\n\n<example>\nuser: "Please write a function that checks if a number is prime"\nassistant: Sure let me write a function that checks if a number is prime\nassistant: First let me use the Write tool to write a function that checks if a number is prime\nassistant: I\'m going to use the Write tool to write the following code:\n<code>\nfunction isPrime(n) {\n  if (n <= 1) return false\n  for (let i = 2; i * i <= n; i++) {\n    if (n % i === 0) return false\n  }\n  return true\n}\n</code>\n<commentary>\nSince significant content was created and the task was completed, now use the content-reviewer agent to review the work\n</commentary>\nassistant: Now let me use the content-reviewer agent to review the code\nassistant: Uses the Task tool to launch with the content-reviewer agent \n</example>\n\n<example>\nuser: "Can you help me research the environmental impact of different renewable energy sources and create a comprehensive report?"\n<commentary>\nThis is a complex research task that would benefit from using the research-analyst agent to conduct thorough analysis\n</commentary>\nassistant: I\'ll help you research the environmental impact of renewable energy sources. Let me use the research-analyst agent to conduct comprehensive research on this topic.\nassistant: Uses the Task tool to launch with the research-analyst agent, providing detailed instructions about what research to conduct and what format the report should take\n</example>\n\n<example>\nuser: "Hello"\n<commentary>\nSince the user is greeting, use the greeting-responder agent to respond with a friendly joke\n</commentary>\nassistant: "I\'m going to use the Task tool to launch with the greeting-responder agent"\n</example>';
 
@@ -5644,5 +5659,39 @@ var PLUGIN_LOAD_STATUS = {
     LOADED: "loaded",
     FAILED: "failed"
 };
+var PLUGIN_COMPONENT_TYPE = {
+    SKILL: "skill",
+    MCP_SERVER: "mcp_server",
+    APP: "app",
+    HOOK: "hook",
+    ASSET: "asset"
+};
+var PLUGIN_MARKETPLACE_INSTALLATION_POLICY = {
+    AVAILABLE: "AVAILABLE",
+    INSTALLED_BY_DEFAULT: "INSTALLED_BY_DEFAULT",
+    NOT_AVAILABLE: "NOT_AVAILABLE"
+};
+var PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY = {
+    ON_INSTALL: "ON_INSTALL",
+    ON_FIRST_USE: "ON_FIRST_USE",
+    NONE: "NONE"
+};
+var PLUGIN_MCP_TOOL_APPROVAL_MODE = {
+    PROMPT: "prompt",
+    APPROVE: "approve",
+    DENY: "deny"
+};
+var PLUGIN_RESOURCE_RUNTIME_TYPE = {
+    SKILL_PACKAGE: "skill_package",
+    TOOLSET: "toolset",
+    HOOK_PROFILE: "hook_profile",
+    APP_CONNECTOR: "app_connector"
+};
+var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
+    READY: "ready",
+    PENDING_AUTH: "pending_auth",
+    BLOCKED: "blocked",
+    FAILED: "failed"
+};
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiKeyBindingType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, AssistantBindingScope, AssistantBindingSourceScope, AssistantCode, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY, CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED, CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE, CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED, CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED, 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_AGENT_WORKSPACE_PATH, STATE_SYS_MEMORY_WORKSPACE_PATH, STATE_SYS_SESSION_WORKSPACE_PATH, STATE_SYS_SHARED_WORKSPACE_PATH, STATE_SYS_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_ROOT, 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, THREAD_GOAL_STATUS_VALUES, 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, createThreadGoalClearedEvent, createThreadGoalUpdatedEvent, 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, isRunnableThreadGoalStatus, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserAddableAgentMiddleware, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveI18nText, resolveMessageAppendContext, resolveRuntimeXpert, 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, CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED, CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED, 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_COMPONENT_TYPE, PLUGIN_CONFIGURATION_STATUS, PLUGIN_LEVEL, PLUGIN_LOAD_STATUS, PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY, PLUGIN_MARKETPLACE_INSTALLATION_POLICY, PLUGIN_MCP_TOOL_APPROVAL_MODE, PLUGIN_RESOURCE_INSTALLATION_STATUS, PLUGIN_RESOURCE_RUNTIME_TYPE, 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_AGENT_WORKSPACE_PATH, STATE_SYS_MEMORY_WORKSPACE_PATH, STATE_SYS_SESSION_WORKSPACE_PATH, STATE_SYS_SHARED_WORKSPACE_PATH, STATE_SYS_THREAD_ID, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_ROOT, 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, THREAD_GOAL_STATUS_VALUES, 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, XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, createThreadGoalClearedEvent, createThreadGoalUpdatedEvent, 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, isAgentWorkflowNode, isAgentWorkflowNodeType, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isRunnableThreadGoalStatus, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserAddableAgentMiddleware, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveI18nText, resolveMessageAppendContext, resolveRuntimeXpert, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.10.1",
+  "version": "3.12.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "dependencies": {
-    "@xpert-ai/chatkit-types": "~0.3.12"
+    "@xpert-ai/chatkit-types": "~0.3.13"
   },
   "types": "./index.d.ts"
 }

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

@@ -2,6 +2,7 @@ export declare enum AiFeatureEnum {
     FEATURE_COPILOT = "FEATURE_COPILOT",
     FEATURE_COPILOT_KNOWLEDGEBASE = "FEATURE_COPILOT_KNOWLEDGEBASE",
     FEATURE_COPILOT_CHAT = "FEATURE_COPILOT_CHAT",
+    FEATURE_COPILOT_MONITORING = "FEATURE_COPILOT_MONITORING",
     FEATURE_XPERT = "FEATURE_XPERT",
     FEATURE_XPERT_CHATBI = "FEATURE_XPERT_CHATBI",
     FEATURE_XPERT_CLAWXPERT = "FEATURE_XPERT_CLAWXPERT",

package/src/ai/thread-goal.model.d.ts

@@ -1,6 +1,6 @@
-import type { ThreadGoalStatus } from '@xpert-ai/chatkit-types';
+import type { ThreadGoalSpec, ThreadGoalStatus } from '@xpert-ai/chatkit-types';
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
-export type { ThreadGoalStatus } from '@xpert-ai/chatkit-types';
+export type { ThreadGoalSpec, ThreadGoalStatus } from '@xpert-ai/chatkit-types';
 export declare const THREAD_GOAL_STATUS_VALUES: readonly ["active", "paused", "blocked", "usage_limited", "budget_limited", "complete"];
 export type ThreadGoalUserStatus = Extract<ThreadGoalStatus, 'active' | 'paused'>;
 export type ThreadGoalModelStatus = Extract<ThreadGoalStatus, 'complete' | 'blocked'>;
@@ -8,6 +8,7 @@ export interface IThreadGoal extends IBasePerTenantAndOrganizationEntityModel {
     conversationId: string;
     threadId: string;
     objective: string;
+    goalSpec?: ThreadGoalSpec | null;
     status: ThreadGoalStatus;
     tokensUsed: number;
     elapsedSeconds: number;

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

@@ -1,7 +1,23 @@
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
 import { ScheduleTaskStatus, TScheduleOptions } from '../schedule';
+import type { TXpertChatState } from '@xpert-ai/chatkit-types';
 import { IChatConversation } from './chat.model';
+import { JsonSchemaObjectType } from './types';
 import { IXpert } from './xpert.model';
+export declare const XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+export type TXpertTaskScheduleCapabilities = {
+    xpertId: string;
+    agentKey?: string;
+    stateVariables: {
+        name: string;
+        type?: string;
+        description?: unknown;
+    }[];
+    stateSchema?: JsonSchemaObjectType;
+};
+export type TXpertTaskScheduleRuntimeState = {
+    idempotencyKey?: string;
+};
 /**
  * Tools for Xpert
  */
@@ -14,6 +30,7 @@ export type XpertTaskType = {
     timeZone?: string;
     prompt?: string;
     status?: ScheduleTaskStatus;
+    runtimeState?: TXpertChatState | null;
     xpert?: IXpert;
     xpertId?: string;
     agentKey?: string;

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

@@ -3,7 +3,7 @@ import { IconDefinition, TAvatar } from '../types';
 import { TCopilotModel } from './copilot-model.model';
 import { MCPServerType, TMCPServer } from './xpert-tool-mcp.model';
 import { XpertTypeEnum } from './xpert.model';
-import { PluginTargetApp, PluginTargetAppMeta } from '../plugin';
+import { PluginTargetApp, PluginTargetAppMeta, XpertTemplatePluginDependencies } from '../plugin';
 export interface IXpertTemplate extends IBasePerTenantEntityModel {
     key: string;
     name?: string;
@@ -93,6 +93,7 @@ export type TTemplate = {
     startPrompts?: string[];
     releaseNotes?: string;
     xpertName?: string;
+    dependencies?: XpertTemplatePluginDependencies;
 };
 export type TXpertTemplate = TTemplate & {
     avatar: TAvatar;

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

@@ -1,12 +1,13 @@
-import { I18nObject, IconDefinition } from "../types";
-import { ICopilotModel } from "./copilot-model.model";
-import { TKBRecallParams } from "./knowledgebase.model";
-import { ApiAuthType, JsonSchemaObjectType, TErrorHandling, TXpertRefParameter } from "./types";
-import { TKBRetrievalSettings, TStateVariable, TXpertParameter } from "./xpert.model";
+import { I18nObject, IconDefinition } from '../types';
+import { ICopilotModel } from './copilot-model.model';
+import { TKBRecallParams } from './knowledgebase.model';
+import { ApiAuthType, JsonSchemaObjectType, TErrorHandling, TXpertRefParameter } from './types';
+import { TKBRetrievalSettings, TStateVariable, TXpertParameter } from './xpert.model';
 export type TWorkflowNodeMeta = {
     name: string;
     label: I18nObject;
     icon: IconDefinition;
+    deprecated?: boolean;
     configSchema: JsonSchemaObjectType;
 };
 export type TWorkflowTriggerMeta = TWorkflowNodeMeta;
@@ -35,6 +36,10 @@ export declare enum WorkflowNodeTypeEnum {
     HTTP = "http",
     SUBFLOW = "subflow",
     TOOL = "tool",
+    AGENT_WORKFLOW = "agent-workflow",
+    /**
+     * @deprecated use AGENT_WORKFLOW instead
+     */
     AGENT_TOOL = "agent-tool",
     NOTE = "note",
     /**
@@ -393,11 +398,27 @@ export interface IWFNTool extends IWorkflowNode {
 export interface IWFNNote extends IWorkflowNode {
     content: string;
 }
-export interface IWFNAgentTool extends IWorkflowNode {
-    type: WorkflowNodeTypeEnum.AGENT_TOOL;
+export type TAgentToolReturnSource = {
+    type: 'last_message';
+} | {
+    type: 'variable';
+    variableSelector: string;
+} | {
+    type: 'template';
+    template: string;
+};
+export type TAgentWorkflowNodeType = WorkflowNodeTypeEnum.AGENT_WORKFLOW | WorkflowNodeTypeEnum.AGENT_TOOL;
+export declare function isAgentWorkflowNodeType(type: WorkflowNodeTypeEnum | string | null | undefined): type is TAgentWorkflowNodeType;
+export interface IWFNAgentWorkflow extends IWorkflowNode {
+    type: TAgentWorkflowNodeType;
     toolName: string;
     toolDescription?: string;
     toolParameters?: TXpertParameter[];
+    /**
+     * Source used to build the ToolMessage returned to the caller agent.
+     * Empty means the last message in the workflow state, for backward compatibility.
+     */
+    returnSource?: TAgentToolReturnSource;
     /**
      * End point tool
      */
@@ -408,6 +429,10 @@ export interface IWFNAgentTool extends IWorkflowNode {
      */
     errorHandling?: TErrorHandling;
 }
+export declare function isAgentWorkflowNode(node: IWorkflowNode | null | undefined): node is IWFNAgentWorkflow;
+export interface IWFNAgentTool extends IWFNAgentWorkflow {
+    type: WorkflowNodeTypeEnum.AGENT_TOOL;
+}
 export interface IWFNTrigger extends IWorkflowNode {
     type: WorkflowNodeTypeEnum.TRIGGER;
     from: 'chat' | 'integration' | 'scheduler';

package/src/analytics/features.d.ts

@@ -11,6 +11,7 @@ export declare enum AnalyticsFeatures {
     FEATURE_STORY_CREATION = "FEATURE_STORY_CREATION",
     FEATURE_STORY_VIEWER = "FEATURE_STORY_VIEWER",
     FEATURE_STORY_MARKET = "FEATURE_STORY_MARKET",
+    FEATURE_DATA_SOURCE = "FEATURE_DATA_SOURCE",
     FEATURE_MODEL = "FEATURE_MODEL",
     FEATURE_MODEL_CREATION = "FEATURE_MODEL_CREATION",
     FEATURE_MODEL_VIEWER = "FEATURE_MODEL_VIEWER",

package/src/feature.model.d.ts

@@ -81,6 +81,8 @@ export declare enum FeatureEnum {
     FEATURE_ORGANIZATION_PROJECT = "FEATURE_ORGANIZATION_PROJECT",
     FEATURE_CONTACT = "FEATURE_CONTACT",
     FEATURE_USER = "FEATURE_USER",
+    FEATURE_USERS = "FEATURE_USERS",
+    FEATURE_USER_GROUPS = "FEATURE_USER_GROUPS",
     FEATURE_ORGANIZATIONS = "FEATURE_ORGANIZATIONS",
     FEATURE_SETTING = "FEATURE_SETTING",
     FEATURE_EMAIL_HISTORY = "FEATURE_EMAIL_HISTORY",

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

@@ -1,7 +1,7 @@
 import { IStorageFile } from './storage-file.model';
 export type FileAssetStatus = 'success' | 'partial_success' | 'failed';
 export type FileAssetDestinationKind = 'storage' | 'volume' | 'sandbox';
-export type FileAssetSourceKind = 'multipart' | 'storage_file' | 'local_file';
+export type FileAssetSourceKind = 'multipart' | 'storage_file' | 'local_file' | 'buffer';
 export type FileUploadVolumeCatalog = 'projects' | 'users' | 'knowledges' | 'skills' | 'xperts';
 export type FileUploadSandboxMode = 'mounted_workspace' | 'backend_upload';
 export interface IFileAssetSource {

package/src/integration.model.d.ts

@@ -88,5 +88,27 @@ export type TIntegrationProvider = {
     schema?: TParameterSchema;
     features?: IntegrationFeatureEnum[];
     helpUrl?: string;
+    /**
+     * Declarative setup hints consumed by the host integration configuration UI.
+     *
+     * Plugins can use this to ask the host to run `validateConfig` automatically
+     * and display returned setup artifacts, such as webhook/callback URLs or
+     * authorization links, without the host hard-coding provider names.
+     */
+    setup?: {
+        /**
+         * When true, the host runs the provider's `validateConfig` after an
+         * existing integration is loaded and after save/upsert succeeds. Use this
+         * for providers whose setup information is computed by validation.
+         */
+        autoValidateOnLoad?: boolean;
+        authorization?: {
+            /**
+             * When true, the host can show a generic hint that authorization is
+             * available only after the integration has been saved and has an id.
+             */
+            requiresSavedIntegration?: boolean;
+        };
+    };
     pro?: boolean;
 };

package/src/plugin.d.ts

@@ -1,5 +1,7 @@
 import { IBasePerTenantAndOrganizationEntityModel } from './base-entity.model';
 import { JsonSchemaObjectType } from './ai/types';
+import type { IXpert } from './ai/xpert.model';
+import type { JSONValue } from './core.model';
 import { IconDefinition, I18nObject } from './types';
 export type PluginName = string;
 export declare const PLUGIN_LEVEL: {
@@ -23,6 +25,40 @@ export declare const PLUGIN_LOAD_STATUS: {
     readonly LOADED: "loaded";
     readonly FAILED: "failed";
 };
+export declare const PLUGIN_COMPONENT_TYPE: {
+    readonly SKILL: "skill";
+    readonly MCP_SERVER: "mcp_server";
+    readonly APP: "app";
+    readonly HOOK: "hook";
+    readonly ASSET: "asset";
+};
+export declare const PLUGIN_MARKETPLACE_INSTALLATION_POLICY: {
+    readonly AVAILABLE: "AVAILABLE";
+    readonly INSTALLED_BY_DEFAULT: "INSTALLED_BY_DEFAULT";
+    readonly NOT_AVAILABLE: "NOT_AVAILABLE";
+};
+export declare const PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY: {
+    readonly ON_INSTALL: "ON_INSTALL";
+    readonly ON_FIRST_USE: "ON_FIRST_USE";
+    readonly NONE: "NONE";
+};
+export declare const PLUGIN_MCP_TOOL_APPROVAL_MODE: {
+    readonly PROMPT: "prompt";
+    readonly APPROVE: "approve";
+    readonly DENY: "deny";
+};
+export declare const PLUGIN_RESOURCE_RUNTIME_TYPE: {
+    readonly SKILL_PACKAGE: "skill_package";
+    readonly TOOLSET: "toolset";
+    readonly HOOK_PROFILE: "hook_profile";
+    readonly APP_CONNECTOR: "app_connector";
+};
+export declare const PLUGIN_RESOURCE_INSTALLATION_STATUS: {
+    readonly READY: "ready";
+    readonly PENDING_AUTH: "pending_auth";
+    readonly BLOCKED: "blocked";
+    readonly FAILED: "failed";
+};
 /**
  * Classifies plugin scope and governance.
  * - `system`: built-in/platform-managed plugin that users cannot install/uninstall from org APIs.
@@ -32,6 +68,12 @@ export type PluginLevel = (typeof PLUGIN_LEVEL)[keyof typeof PLUGIN_LEVEL];
 export type PluginSource = (typeof PLUGIN_SOURCE)[keyof typeof PLUGIN_SOURCE];
 export type PluginConfigurationStatus = (typeof PLUGIN_CONFIGURATION_STATUS)[keyof typeof PLUGIN_CONFIGURATION_STATUS];
 export type PluginLoadStatus = (typeof PLUGIN_LOAD_STATUS)[keyof typeof PLUGIN_LOAD_STATUS];
+export type PluginComponentType = (typeof PLUGIN_COMPONENT_TYPE)[keyof typeof PLUGIN_COMPONENT_TYPE];
+export type PluginMarketplaceInstallationPolicy = (typeof PLUGIN_MARKETPLACE_INSTALLATION_POLICY)[keyof typeof PLUGIN_MARKETPLACE_INSTALLATION_POLICY];
+export type PluginMarketplaceAuthenticationPolicy = (typeof PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY)[keyof typeof PLUGIN_MARKETPLACE_AUTHENTICATION_POLICY];
+export type PluginMcpToolApprovalMode = (typeof PLUGIN_MCP_TOOL_APPROVAL_MODE)[keyof typeof PLUGIN_MCP_TOOL_APPROVAL_MODE];
+export type PluginResourceRuntimeType = (typeof PLUGIN_RESOURCE_RUNTIME_TYPE)[keyof typeof PLUGIN_RESOURCE_RUNTIME_TYPE];
+export type PluginResourceInstallationStatus = (typeof PLUGIN_RESOURCE_INSTALLATION_STATUS)[keyof typeof PLUGIN_RESOURCE_INSTALLATION_STATUS];
 export type PluginScopeRelation = 'none' | 'overrides-global' | 'shadowed-by-organization';
 export type PluginTargetApp = 'xpert' | 'data-xpert' | (string & {});
 export type PluginSdkCompatibilityWarningCode = 'plugin-sdk-peer-dependency-missing' | 'plugin-sdk-peer-range-invalid' | 'plugin-sdk-peer-range-incompatible' | 'plugin-sdk-peer-range-spans-major';
@@ -44,6 +86,100 @@ export interface PluginMarketplaceOperation {
     access?: PluginMarketplaceOperationAccess;
     tags?: string[];
 }
+export interface XpertPluginMarketplacePolicy {
+    installation?: PluginMarketplaceInstallationPolicy;
+    authentication?: PluginMarketplaceAuthenticationPolicy;
+    pluginSharing?: boolean;
+}
+export interface XpertPluginMarketplaceSource {
+    source?: 'local' | 'url' | 'git-subdir' | 'github' | 'git' | 'npm' | 'marketplace' | (string & {});
+    path?: string;
+    url?: string;
+    ref?: string;
+    sha?: string;
+    sparsePath?: string;
+    packageName?: string;
+}
+export interface XpertPluginInstallInterface {
+    displayName?: string;
+    shortDescription?: string;
+    longDescription?: string;
+    developerName?: string;
+    category?: string;
+    capabilities?: string[];
+    websiteURL?: string;
+    privacyPolicyURL?: string;
+    termsOfServiceURL?: string;
+    defaultPrompt?: string[];
+    brandColor?: string;
+    composerIcon?: string;
+    logo?: string;
+    screenshots?: string[];
+}
+export interface XpertPluginMcpServerPolicy {
+    enabled?: boolean;
+    defaultToolsApprovalMode?: PluginMcpToolApprovalMode;
+    enabledTools?: string[];
+    tools?: {
+        [toolName: string]: {
+            approvalMode?: PluginMcpToolApprovalMode;
+        };
+    };
+}
+export interface XpertPluginBundleManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    author?: string;
+    homepage?: string;
+    repository?: JSONValue;
+    license?: string;
+    keywords?: string[];
+    skills?: string | string[];
+    mcpServers?: string | string[] | JSONValue;
+    apps?: string | string[] | JSONValue;
+    connectors?: string | string[] | JSONValue;
+    hooks?: string | string[] | JSONValue | JSONValue[];
+    interface?: XpertPluginInstallInterface;
+    policy?: XpertPluginMarketplacePolicy;
+    source?: XpertPluginMarketplaceSource;
+    assets?: {
+        composerIcon?: string;
+        logo?: string;
+        screenshots?: string[];
+    };
+    targetApps?: PluginTargetApp[];
+    targetAppMeta?: PluginTargetAppMeta;
+}
+export interface XpertTemplatePluginSkillDependency {
+    pluginName?: PluginName;
+    componentKey: string;
+    targetAgentKey?: string;
+}
+export interface XpertTemplatePluginMcpServerDependency {
+    pluginName?: PluginName;
+    componentKey: string;
+    targetAgentKey?: string;
+    policyOverrides?: XpertPluginMcpServerPolicy;
+}
+export interface XpertTemplatePluginHookDependency {
+    pluginName?: PluginName;
+    componentKey: string;
+    targetAgentKey?: string;
+    events?: string[];
+}
+export interface XpertTemplatePluginAppDependency {
+    pluginName?: PluginName;
+    componentKey: string;
+    auth?: 'on_install' | 'on_first_use';
+}
+export interface XpertTemplatePluginDependencies {
+    plugins?: PluginName[];
+    skills?: XpertTemplatePluginSkillDependency[];
+    mcpServers?: XpertTemplatePluginMcpServerDependency[];
+    hooks?: XpertTemplatePluginHookDependency[];
+    apps?: XpertTemplatePluginAppDependency[];
+}
 export interface PluginMarketplaceContribution {
     id?: string;
     type: PluginMarketplaceContributionType;
@@ -55,8 +191,11 @@ export interface PluginMarketplaceContribution {
     tags?: string[];
     metadata?: Record<string, unknown>;
 }
+export type PluginMarketplaceCategory = 'featured' | 'business-operations' | 'communication' | 'creativity' | 'data-analytics' | 'developer-tools' | 'education-research' | 'finance' | 'productivity' | 'research' | 'security' | 'travel' | 'sales' | 'other';
 export interface PluginTargetAppMarketplaceMetadata {
     contents?: PluginMarketplaceContribution[];
+    category?: PluginMarketplaceCategory;
+    subcategory?: string;
     featured?: boolean;
     screenshots?: string[];
     readme?: string;
@@ -129,6 +268,141 @@ export interface PluginMeta {
     author: string;
     homepage?: string;
 }
+export type PluginMarketplaceSourceType = 'url' | 'github' | 'git';
+export type PluginMarketplaceSourceResponseType = PluginMarketplaceSourceType | 'platform';
+export type PluginMarketplaceRegistrySection = 'marketplace' | 'official' | 'partner' | 'community';
+export type PluginMarketplaceRegistryDownloadStatus = 'idle' | 'success' | 'failed';
+export type PluginMarketplaceItemSourceType = 'marketplace' | 'github' | 'git' | 'url' | 'npm' | 'website' | 'other' | (string & {});
+export interface PluginMarketplaceSourceInput {
+    name?: string;
+    type?: PluginMarketplaceSourceType;
+    url?: string;
+    ref?: string | null;
+    sparsePath?: string | null;
+    enabled?: boolean;
+    priority?: number;
+}
+export interface PluginMarketplaceSourceResponse {
+    id: string;
+    name: string;
+    type: PluginMarketplaceSourceResponseType;
+    url: string;
+    ref?: string | null;
+    sparsePath?: string | null;
+    enabled: boolean;
+    priority: number;
+    lastIndexStatus?: string | null;
+    lastIndexedAt?: Date | string | null;
+    lastIndexError?: string | null;
+    builtin?: boolean;
+}
+export interface PluginMarketplaceRegistryItem {
+    id: string;
+    packageName: string;
+    version?: string | null;
+    displayName: string;
+    description: string;
+    category: string;
+    author: string;
+    icon?: IconDefinition | null;
+    keywords: string[];
+    homepage?: string | null;
+    repository?: JSONValue | null;
+    targetApps: PluginTargetApp[];
+    targetAppMeta: PluginTargetAppMeta;
+    enabled: boolean;
+    priority: number;
+    section: PluginMarketplaceRegistrySection;
+    downloads?: PluginMarketplaceDownloads | null;
+    downloadsStatus?: PluginMarketplaceRegistryDownloadStatus | string | null;
+    downloadsUpdatedAt?: Date | string | null;
+    downloadsError?: string | null;
+    createdAt?: Date | string | null;
+    updatedAt?: Date | string | null;
+}
+export type PluginMarketplaceRegistryItemResponse = PluginMarketplaceRegistryItem;
+export interface PluginMarketplaceRegistryItemInput {
+    packageName?: string;
+    version?: string | null;
+    displayName?: string;
+    description?: string;
+    category?: string;
+    author?: string;
+    icon?: IconDefinition | null;
+    keywords?: string[];
+    homepage?: string | null;
+    repository?: JSONValue | null;
+    targetApps?: PluginTargetApp[];
+    targetAppMeta?: PluginTargetAppMeta | null;
+    enabled?: boolean;
+    priority?: number;
+    section?: PluginMarketplaceRegistrySection;
+}
+export interface PluginMarketplaceAuthor {
+    name?: string | null;
+    displayName?: string | null;
+    url?: string | null;
+    homepage?: string | null;
+}
+export interface PluginMarketplaceDownloads {
+    lastWeek?: number;
+    lastMonth?: number;
+    lastYear?: number;
+    [key: string]: JSONValue | undefined;
+}
+export interface PluginMarketplaceOperationSummary {
+    total: number;
+    read: number;
+    write: number;
+    admin: number;
+}
+export interface PluginMarketplaceItemSource {
+    type?: PluginMarketplaceItemSourceType;
+    url?: string | null;
+    path?: string | null;
+    ref?: string | null;
+    packageName?: string | null;
+}
+export interface PluginMarketplaceItem {
+    name: string;
+    packageName?: string | null;
+    displayName?: I18nObject | string;
+    description?: I18nObject | string;
+    version?: string | null;
+    level?: PluginLevel;
+    deprecated?: boolean;
+    deprecationMessage?: I18nObject | string | null;
+    category?: PluginMeta['category'] | string;
+    icon?: IconDefinition | null;
+    author?: PluginMarketplaceAuthor | string | null;
+    source?: PluginMarketplaceItemSource | null;
+    keywords?: string[];
+    downloads?: PluginMarketplaceDownloads | null;
+    sourceId?: string | null;
+    sourceName?: string | null;
+    sourceNameI18nKey?: string | null;
+    installed?: boolean;
+    contributions?: PluginMarketplaceContribution[];
+    operationSummary?: PluginMarketplaceOperationSummary;
+    targetApps?: PluginTargetApp[];
+    targetAppMeta?: PluginTargetAppMeta | null;
+    marketplacePlugin?: JSONValue | null;
+    section?: PluginMarketplaceRegistrySection | string;
+}
+export interface PluginMarketplaceResponse {
+    updatedAt: string | null;
+    total: number;
+    items: PluginMarketplaceItem[];
+    sources: PluginMarketplaceSourceResponse[];
+    official?: string[];
+    partner?: string[];
+    community?: string[];
+    errors?: Array<{
+        sourceId: string;
+        sourceName: string;
+        message: string;
+    }>;
+}
 export interface IPlugin extends IBasePerTenantAndOrganizationEntityModel {
     pluginName: string;
     packageName: string;
@@ -182,6 +456,7 @@ export interface IPluginDescriptor {
     loadError?: string | null;
     effectiveInCurrentScope: boolean;
     scopeRelation?: PluginScopeRelation;
+    componentSummary?: PluginComponentSummary;
 }
 export interface IPluginLatestVersionStatus {
     organizationId?: string;
@@ -197,3 +472,76 @@ export interface IPluginConfiguration<TConfig extends Record<string, any> = Reco
     configurationStatus?: PluginConfigurationStatus | null;
     configurationError?: string | null;
 }
+export interface PluginComponentSummary {
+    total: number;
+    skills: number;
+    mcpServers: number;
+    apps: number;
+    hooks: number;
+}
+export interface IPluginComponentDefinition {
+    componentType: PluginComponentType;
+    componentKey: string;
+    sourcePath?: string | null;
+    config?: JSONValue | null;
+    metadata?: JSONValue | null;
+    definitionHash: string;
+}
+export interface IPluginResourceComponentState {
+    componentType: PluginComponentType;
+    componentKey: string;
+    installed: boolean;
+    staleDefinition: boolean;
+    runtimeType?: PluginResourceRuntimeType | null;
+    runtimeId?: string | null;
+    status?: PluginResourceInstallationStatus | null;
+    installation?: IPluginResourceInstallation | null;
+}
+export interface PluginResourceComponentSelector {
+    componentType?: PluginComponentType;
+    componentKey: string;
+    pluginName?: PluginName;
+    targetAgentKey?: string;
+    policyOverrides?: XpertPluginMcpServerPolicy;
+    events?: string[];
+    auth?: 'on_install' | 'on_first_use';
+}
+export interface IPluginResourceInstallation extends IBasePerTenantAndOrganizationEntityModel {
+    pluginName: PluginName;
+    componentType: PluginComponentType;
+    componentKey: string;
+    workspaceId: string;
+    xpertId?: string | null;
+    agentKey?: string | null;
+    runtimeType: PluginResourceRuntimeType;
+    runtimeId?: string | null;
+    runtimeNodeKey?: string | null;
+    definitionHash: string;
+    status: PluginResourceInstallationStatus;
+    config?: JSONValue | null;
+    enabled: boolean;
+}
+export interface IPluginResourceInstallResult {
+    installations: IPluginResourceInstallation[];
+    pendingAuth: IPluginResourceInstallation[];
+    xpert?: IXpert;
+}
+export interface PluginResourceInstallWorkspaceInput {
+    workspaceId: string;
+    components?: PluginResourceComponentSelector[];
+}
+export interface PluginResourceInstallXpertInput {
+    xpertId: string;
+    components?: PluginResourceComponentSelector[];
+    agentKey?: string;
+}
+export interface XpertTemplateInstallInput {
+    workspaceId: string;
+    basic?: {
+        name?: string;
+        title?: string;
+        description?: string;
+        avatar?: JSONValue | null;
+        copilotModel?: JSONValue | null;
+    };
+}