@xpert-ai/contracts 3.9.9 → 3.10.1

package/index.cjs.js

@@ -1557,6 +1557,13 @@ function _define_property$9(obj, key, value) {
     }
     return obj;
 }
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 function _object_spread$8(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
@@ -1575,6 +1582,8 @@ function _object_spread$8(target) {
 var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
 var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
+var CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED = "thread_goal_updated";
+var CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED = "thread_goal_cleared";
 function createConversationTitleSummaryEvent(event) {
     return _object_spread$8({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
@@ -1585,6 +1594,36 @@ function createFollowUpConsumedEvent(event) {
         type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
     }, event);
 }
+function createThreadGoalUpdatedEvent(goal) {
+    var updatedAt = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : new Date();
+    return {
+        type: CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED,
+        conversationId: goal.conversationId,
+        threadId: goal.threadId,
+        goal: goal,
+        updatedAt: toIsoString(updatedAt)
+    };
+}
+function createThreadGoalClearedEvent(event) {
+    return {
+        type: CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED,
+        conversationId: event.conversationId,
+        threadId: event.threadId,
+        updatedAt: toIsoString(event.updatedAt)
+    };
+}
+function toIsoString(value) {
+    if (_instanceof(value, Date)) {
+        return value.toISOString();
+    }
+    if (typeof value === "string") {
+        var date = new Date(value);
+        if (!Number.isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+    }
+    return new Date().toISOString();
+}
 
 function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -2058,6 +2097,19 @@ exports.PriceType = void 0;
     PriceType["OUTPUT"] = "output";
 })(exports.PriceType || (exports.PriceType = {}));
 
+var THREAD_GOAL_STATUS_VALUES = [
+    "active",
+    "paused",
+    "blocked",
+    // Reserved for future usage-quota enforcement. No backend path emits this status yet.
+    "usage_limited",
+    "budget_limited",
+    "complete"
+];
+function isRunnableThreadGoalStatus(status) {
+    return status === "active";
+}
+
 /**
  * @deprecated use ChatMessageEventTypeEnum
  */ exports.ChatGatewayEvent = void 0;
@@ -4050,6 +4102,9 @@ function normalizeMiddlewareNodes(nodes) {
         return normalizeMiddlewareNode(node);
     });
 }
+function isUserAddableAgentMiddleware(meta) {
+    return (meta === null || meta === void 0 ? void 0 : meta.builtin) !== true;
+}
 var normalizeNodeKey = function(key) {
     var _key_split;
     return key === null || key === void 0 ? void 0 : (_key_split = key.split("/")) === null || _key_split === void 0 ? void 0 : _key_split[0];
@@ -5598,6 +5653,8 @@ 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.CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED = CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED;
+exports.CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED = CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED;
 exports.CONTEXT_COMPRESSION_COMPONENT_TYPE = CONTEXT_COMPRESSION_COMPONENT_TYPE;
 exports.CONTEXT_COMPRESSION_MIDDLEWARE_NAME = CONTEXT_COMPRESSION_MIDDLEWARE_NAME;
 exports.CONTEXT_VARIABLE_CURRENTSTATE = CONTEXT_VARIABLE_CURRENTSTATE;
@@ -5666,6 +5723,7 @@ exports.STATE_VARIABLE_TITLE_CHANNEL = STATE_VARIABLE_TITLE_CHANNEL;
 exports.TASK_DESCRIPTION_PREFIX = TASK_DESCRIPTION_PREFIX;
 exports.TASK_DESCRIPTION_SUFFIX = TASK_DESCRIPTION_SUFFIX;
 exports.TENANT_AGENT_LOCAL_URL = TENANT_AGENT_LOCAL_URL;
+exports.THREAD_GOAL_STATUS_VALUES = THREAD_GOAL_STATUS_VALUES;
 exports.TOOL_NAME_REGEX = TOOL_NAME_REGEX;
 exports.TranslationLanguageMap = TranslationLanguageMap;
 exports.USAGE_HOUR_FORMAT = USAGE_HOUR_FORMAT;
@@ -5687,6 +5745,8 @@ exports.createAgentConnections = createAgentConnections;
 exports.createConversationTitleSummaryEvent = createConversationTitleSummaryEvent;
 exports.createFollowUpConsumedEvent = createFollowUpConsumedEvent;
 exports.createMessageAppendContextTracker = createMessageAppendContextTracker;
+exports.createThreadGoalClearedEvent = createThreadGoalClearedEvent;
+exports.createThreadGoalUpdatedEvent = createThreadGoalUpdatedEvent;
 exports.createXpertGraph = createXpertGraph;
 exports.createXpertNodes = createXpertNodes;
 exports.embeddingCubeCollectionName = embeddingCubeCollectionName;
@@ -5751,9 +5811,11 @@ exports.isMessageGroup = isMessageGroup;
 exports.isMiddlewareToolEnabled = isMiddlewareToolEnabled;
 exports.isRequiredMiddleware = isRequiredMiddleware;
 exports.isRouterKey = isRouterKey;
+exports.isRunnableThreadGoalStatus = isRunnableThreadGoalStatus;
 exports.isSystemManagedAssistant = isSystemManagedAssistant;
 exports.isTenantSharedXpertWorkspace = isTenantSharedXpertWorkspace;
 exports.isToolEnabled = isToolEnabled;
+exports.isUserAddableAgentMiddleware = isUserAddableAgentMiddleware;
 exports.isUserManagedAssistant = isUserManagedAssistant;
 exports.isVideoType = isVideoType;
 exports.isXpertNodeType = isXpertNodeType;

package/index.esm.js

@@ -1555,6 +1555,13 @@ function _define_property$9(obj, key, value) {
     }
     return obj;
 }
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 function _object_spread$8(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
@@ -1573,6 +1580,8 @@ function _object_spread$8(target) {
 var CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED = "follow_up_consumed";
 var CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE = "thread_context_usage";
 var CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY = "conversation_title_summary";
+var CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED = "thread_goal_updated";
+var CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED = "thread_goal_cleared";
 function createConversationTitleSummaryEvent(event) {
     return _object_spread$8({
         type: CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY
@@ -1583,6 +1592,36 @@ function createFollowUpConsumedEvent(event) {
         type: CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED
     }, event);
 }
+function createThreadGoalUpdatedEvent(goal) {
+    var updatedAt = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : new Date();
+    return {
+        type: CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED,
+        conversationId: goal.conversationId,
+        threadId: goal.threadId,
+        goal: goal,
+        updatedAt: toIsoString(updatedAt)
+    };
+}
+function createThreadGoalClearedEvent(event) {
+    return {
+        type: CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED,
+        conversationId: event.conversationId,
+        threadId: event.threadId,
+        updatedAt: toIsoString(event.updatedAt)
+    };
+}
+function toIsoString(value) {
+    if (_instanceof(value, Date)) {
+        return value.toISOString();
+    }
+    if (typeof value === "string") {
+        var date = new Date(value);
+        if (!Number.isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+    }
+    return new Date().toISOString();
+}
 
 function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
@@ -2056,6 +2095,19 @@ var PriceType;
     PriceType["OUTPUT"] = "output";
 })(PriceType || (PriceType = {}));
 
+var THREAD_GOAL_STATUS_VALUES = [
+    "active",
+    "paused",
+    "blocked",
+    // Reserved for future usage-quota enforcement. No backend path emits this status yet.
+    "usage_limited",
+    "budget_limited",
+    "complete"
+];
+function isRunnableThreadGoalStatus(status) {
+    return status === "active";
+}
+
 /**
  * @deprecated use ChatMessageEventTypeEnum
  */ var ChatGatewayEvent;
@@ -4048,6 +4100,9 @@ function normalizeMiddlewareNodes(nodes) {
         return normalizeMiddlewareNode(node);
     });
 }
+function isUserAddableAgentMiddleware(meta) {
+    return (meta === null || meta === void 0 ? void 0 : meta.builtin) !== true;
+}
 var normalizeNodeKey = function(key) {
     var _key_split;
     return key === null || key === void 0 ? void 0 : (_key_split = key.split("/")) === null || _key_split === void 0 ? void 0 : _key_split[0];
@@ -5590,4 +5645,4 @@ var PLUGIN_LOAD_STATUS = {
     FAILED: "failed"
 };
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiKeyBindingType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, AssistantBindingScope, AssistantBindingSourceScope, AssistantCode, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY, CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED, CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE, CONTEXT_COMPRESSION_COMPONENT_TYPE, CONTEXT_COMPRESSION_MIDDLEWARE_NAME, CONTEXT_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageEventTypeEnum, ChatMessageFeedbackRatingEnum, ChatMessageStepCategory, ChatMessageTypeEnum, ClientFocusEnum, ConfigurateMethod, ContactOrganizationInviteStatus, ContactType, CredentialFormTypeEnum, CredentialsType, CrudActionEnum, CurrenciesEnum, CurrencyPosition, DEFAULT_CURRENCIES, DEFAULT_DATE_FORMATS, DEFAULT_INTEGRATION_PAID_FILTERS, DEFAULT_INVITE_EXPIRY_PERIOD, DEFAULT_PROFIT_BASED_BONUS, DEFAULT_REVENUE_BASED_BONUS, DEFAULT_SYSTEM_ROLES, DEFAULT_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, DEFAULT_XPERT_AGENT_RECURSION_LIMIT, DataSourceProtocolEnum, DataSourceSyntaxEnum, DataSourceTypeEnum, DefaultValueDateTypeEnum, DocumentSourceProviderCategoryEnum, DocumentTypeEnum, EmailTemplateEnum, EmailTemplateNameEnum, EmbeddingStatusEnum, FILE_VARIABLES, FeatureEnum, FeatureStatusEnum, FeedTypeEnum, FetchFrom, FileStorageProviderEnum, GRAPH_NODE_SUMMARIZE_CONVERSATION, GRAPH_NODE_TITLE_CONVERSATION, HttpStatus, IFeatureToggleTypeEnum, INTEGRATION_PROVIDERS, ImportHistoryStatusEnum, ImportTypeEnum, IndicatorDraftFields, IndicatorOptionFields, IndicatorStatusEnum, IndicatorTagEnum, IndicatorType, IntegrationEnum, IntegrationFeatureEnum, IntegrationFilterEnum, IntegrationGitHubProvider, IntegrationLarkProvider, InterruptMessageType, InvitationExpirationEnum, InvitationTypeEnum, InviteStatusEnum, IteratingIndexParameterName, IteratingItemParameterName, IteratorIndexParameterName, IteratorItemParameterName, KBDocumentCategoryEnum, KBDocumentStatusEnum, KDocumentSourceType, KDocumentWebTypeEnum, KDocumentWebTypeOptions, KNOWLEDGE_DOCUMENTS_NAME, KNOWLEDGE_FOLDER_ID_NAME, KNOWLEDGE_SOURCES_NAME, KNOWLEDGE_STAGE_NAME, 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, TOOL_NAME_REGEX, TagCategoryEnum, TaskFrequency, TaskListTypeEnum, TimeGranularity, ToolParameterForm, ToolParameterType, ToolTagEnum, TranslationLanguageMap, USAGE_HOUR_FORMAT, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME, WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, ensureAssistantBindingSkillWorkspacePreference, extractSemanticModelDraft, figureOutXpert, filterAssistantBindingDisabledSkillIds, filterAssistantBindingDisabledTools, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantBindingDisabledSkillIds, getAssistantBindingDisabledTools, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, getXpertAgentRecursionLimit, getXpertWorkspaceVisibility, inferMessageAppendContext, isAgentKey, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, 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_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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.9.9",
+  "version": "3.10.1",
   "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.9"
+    "@xpert-ai/chatkit-types": "~0.3.12"
   },
   "types": "./index.d.ts"
 }

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

@@ -2,6 +2,7 @@ import type { TFollowUpConsumedEvent, TMessageContentComplex, TThreadContextUsag
 import type { IChatConversation } from './chat.model';
 import type { IChatMessage } from './chat-message.model';
 import type { IXpertAgentExecution } from './xpert-agent-execution.model';
+import type { TThreadGoalClearedEvent, TThreadGoalUpdatedEvent } from './chat-event.model';
 /**
  * Business roles for AI copilot (commands or contexts)
  */
@@ -152,7 +153,7 @@ export type TChatStreamErrorPayload = {
         error?: string;
     };
 };
-export type TChatStreamChatEventData = NonNullable<IChatMessage['events']>[number] | TFollowUpConsumedEvent | TThreadContextUsageEvent;
+export type TChatStreamChatEventData = NonNullable<IChatMessage['events']>[number] | TFollowUpConsumedEvent | TThreadContextUsageEvent | TThreadGoalUpdatedEvent | TThreadGoalClearedEvent;
 export type TChatStreamChatEventPayload = {
     type: ChatMessageTypeEnum.EVENT;
     event: ChatMessageEventTypeEnum.ON_CHAT_EVENT;

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

@@ -1,10 +1,18 @@
-import type { TFollowUpConsumedEvent, TChatEventMessage } from '@xpert-ai/chatkit-types';
+import type { TChatEventMessage, TFollowUpConsumedEvent, TThreadGoalClearedEvent, TThreadGoalUpdatedEvent } from '@xpert-ai/chatkit-types';
+import type { IThreadGoal } from './thread-goal.model';
+export type { TThreadGoalClearedEvent, TThreadGoalUpdatedEvent } from '@xpert-ai/chatkit-types';
 export declare const CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED: "follow_up_consumed";
 export declare const CHAT_EVENT_TYPE_THREAD_CONTEXT_USAGE: "thread_context_usage";
 export declare const CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY: "conversation_title_summary";
+export declare const CHAT_EVENT_TYPE_THREAD_GOAL_UPDATED: "thread_goal_updated";
+export declare const CHAT_EVENT_TYPE_THREAD_GOAL_CLEARED: "thread_goal_cleared";
 export type TConversationTitleSummaryEvent = TChatEventMessage & {
     id?: string;
     type: typeof CHAT_EVENT_TYPE_CONVERSATION_TITLE_SUMMARY;
 };
 export declare function createConversationTitleSummaryEvent(event: Omit<TConversationTitleSummaryEvent, 'type'>): TConversationTitleSummaryEvent;
 export declare function createFollowUpConsumedEvent(event: Omit<TFollowUpConsumedEvent, 'type'>): TFollowUpConsumedEvent;
+export declare function createThreadGoalUpdatedEvent(goal: IThreadGoal, updatedAt?: string | Date): TThreadGoalUpdatedEvent;
+export declare function createThreadGoalClearedEvent(event: Omit<TThreadGoalClearedEvent, 'type' | 'updatedAt'> & {
+    updatedAt?: string | Date;
+}): TThreadGoalClearedEvent;

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

@@ -60,9 +60,18 @@ export interface IChatMessage extends IBasePerTenantAndOrganizationEntityModel,
     children?: IChatMessage[];
     parentId?: string | null;
     /**
-     * Files
+     * @deprecated Chat attachments now use `fileAssets`. This field is kept only
+     * for historical messages that stored raw StorageFile handles.
      */
     attachments?: IStorageFile[];
+    /**
+     * Parsed file assets used by the file understanding pipeline and agent tools.
+     */
+    fileAssets?: Array<{
+        id?: string;
+        storageFileId?: string;
+        [key: string]: any;
+    }>;
     /**
      * Structured references associated with the human input
      */

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

@@ -114,7 +114,8 @@ export interface IChatConversation extends IBasePerTenantAndOrganizationEntityMo
     taskId?: string | null;
     executions?: IXpertAgentExecution[];
     /**
-     * Files
+     * @deprecated Conversation-level chat attachments are superseded by
+     * per-message `fileAssets` and `ConversationFileLink`.
      */
     attachments?: IStorageFile[];
 }

package/src/ai/copilot-user.model.d.ts

@@ -25,3 +25,26 @@ export interface ICopilotUser extends IBasePerTenantAndOrganizationEntityModel,
     tokenTotalUsed?: number;
     priceTotalUsed?: number;
 }
+export interface ICopilotUserUsageGroupKey {
+    tenantId?: string;
+    organizationId?: string;
+    orgId?: string | null;
+    userId?: string;
+    provider?: AiProvider | string;
+    model?: string;
+    currency?: string | null;
+}
+export interface ICopilotUserUsageSummary extends IBasePerTenantAndOrganizationEntityModel, TCopilotTokenUsage {
+    orgId?: string | null;
+    org?: IOrganization;
+    userId?: string;
+    user?: IUser;
+    provider?: AiProvider | string;
+    model?: string;
+    currency?: string | null;
+    tokenTotalUsed?: number;
+    priceTotalUsed?: number;
+    groupKey: ICopilotUserUsageGroupKey;
+    details?: ICopilotUser[];
+}
+export type TCopilotUserUsageSummaryRenewInput = ICopilotUserUsageGroupKey & Pick<TCopilotTokenUsage, 'tokenLimit' | 'priceLimit'>;

package/src/ai/index.d.ts

@@ -1,12 +1,14 @@
 export declare const STATE_VARIABLE_HUMAN = "human";
 export { ChatMessageEventTypeEnum, ChatMessageStepCategory, ChatMessageTypeEnum } from './ai.model';
 export type * from '@xpert-ai/chatkit-types';
+export type { TThreadGoalClearedEvent, TThreadGoalUpdatedEvent, ThreadGoalStatus } from '@xpert-ai/chatkit-types';
 export type { TChatRequest } from './xpert-chat.model';
 export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from './chat-event.model';
 export * from './assistant-binding.model';
 export * from './ai-model.model';
 export * from './ai.model';
 export * from './chat-event.model';
+export * from './thread-goal.model';
 export * from './chat.model';
 export * from './chat-message.model';
 export * from './chat-message-feedback.model';

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

@@ -22,6 +22,7 @@ export type KnowledgeGraphItemOrigin = 'extracted' | 'manual' | 'curated';
 export type KnowledgeGraphVisibility = 'active' | 'hidden';
 export type GraphRagConfig = {
     enabled?: boolean;
+    mode?: GraphRagRetrievalMode;
     entityTopK?: number;
     neighborHops?: number;
     communityTopK?: number;

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

@@ -30,7 +30,17 @@ export type TAgentMiddlewareMeta = {
     icon?: IconDefinition;
     description?: I18nObject;
     configSchema?: JsonSchemaObjectType;
-    features?: TXpertFeatureKey[];
+    features?: Array<TXpertFeatureKey | string>;
     slashCommands?: SkillSlashCommand[];
+    builtin?: boolean;
+    /**
+     * Marks a middleware as deprecated while keeping it selectable/visible for migration.
+     */
+    deprecated?: boolean;
+    /**
+     * Optional user-facing migration guidance shown when the middleware is deprecated.
+     */
+    deprecationMessage?: I18nObject;
 };
+export declare function isUserAddableAgentMiddleware(meta?: Pick<TAgentMiddlewareMeta, 'builtin'> | null): boolean;
 export declare function getAgentMiddlewareNodes(graph: TXpertGraph, agentKey: string): TXpertTeamNode[];

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

@@ -0,0 +1,26 @@
+import type { ThreadGoalStatus } from '@xpert-ai/chatkit-types';
+import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
+export type { 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'>;
+export interface IThreadGoal extends IBasePerTenantAndOrganizationEntityModel {
+    conversationId: string;
+    threadId: string;
+    objective: string;
+    status: ThreadGoalStatus;
+    tokensUsed: number;
+    elapsedSeconds: number;
+    continuationCount: number;
+    statusUpdatedAt?: Date | string | null;
+    completedAt?: Date | string | null;
+    blockedAt?: Date | string | null;
+}
+export type TThreadGoalSetRequest = {
+    objective: string;
+};
+export type TThreadGoalPatchRequest = {
+    objective?: string;
+    status?: ThreadGoalUserStatus;
+};
+export declare function isRunnableThreadGoalStatus(status: ThreadGoalStatus | null | undefined): boolean;

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

@@ -146,6 +146,10 @@ export type TXpertAgentOptions = {
      * Attachment config of agent
      */
     attachment?: TXpertAgentAttachment;
+    /**
+     * Built-in file understanding tools config of agent
+     */
+    fileUnderstanding?: TXpertAgentFileUnderstanding;
     /**
      * Config of middlewares for agent
      */
@@ -170,6 +174,12 @@ export type TXpertAgentAttachment = TXpertAgentVision & {
      */
     maxNum?: number;
 };
+export type TXpertAgentFileUnderstanding = {
+    /**
+     * Enable built-in tools for understanding conversation files. Default: true
+     */
+    enabled?: boolean;
+};
 export type TAgentPromptTemplate = {
     id: string;
     role: 'ai' | 'human';

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

@@ -36,9 +36,12 @@ export interface IXpertProject extends TXpertProject, IBasePerTenantAndOrganizat
     knowledges?: IKnowledgebase[];
     members?: IUser[];
     /**
-     * @deprecated Use *file volume* instead
+     * @deprecated Use project file volume / FileAsset workspace projection instead.
      */
     files?: IXpertProjectFile[];
+    /**
+     * @deprecated Use project file volume / FileAsset workspace projection instead.
+     */
     attachments?: IStorageFile[];
     vcs?: IXpertProjectVCS;
 }
@@ -80,7 +83,7 @@ export interface IXpertProjectVCS extends IBasePerXpertProjectEntityModel {
     repository?: string;
 }
 /**
- * @deprecated Use `attachments`
+ * @deprecated Use project file volume / FileAsset workspace projection instead.
  */
 export interface IXpertProjectFile extends IBasePerXpertProjectEntityModel, Omit<TFile, 'createdAt' | 'updatedAt'> {
 }

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

@@ -3,6 +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';
 export interface IXpertTemplate extends IBasePerTenantEntityModel {
     key: string;
     name?: string;
@@ -74,6 +75,7 @@ export interface ITemplateSkillSyncResult {
 }
 export type TTemplate = {
     id: string;
+    key?: string;
     name: string;
     title: string;
     description: string;
@@ -81,6 +83,16 @@ export type TTemplate = {
     copyright: string;
     privacyPolicy?: string;
     export_data: string;
+    targetApps?: PluginTargetApp[];
+    targetAppMeta?: PluginTargetAppMeta | null;
+    source?: 'builtin' | 'plugin' | string;
+    pluginName?: string;
+    pluginDisplayName?: string;
+    order?: number;
+    default?: boolean;
+    startPrompts?: string[];
+    releaseNotes?: string;
+    xpertName?: string;
 };
 export type TXpertTemplate = TTemplate & {
     avatar: TAvatar;

package/src/plugin.d.ts

@@ -1,6 +1,6 @@
 import { IBasePerTenantAndOrganizationEntityModel } from './base-entity.model';
 import { JsonSchemaObjectType } from './ai/types';
-import { IconDefinition } from './types';
+import { IconDefinition, I18nObject } from './types';
 export type PluginName = string;
 export declare const PLUGIN_LEVEL: {
     readonly SYSTEM: "system";
@@ -33,6 +33,63 @@ 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 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';
+export type PluginMarketplaceContributionType = 'app' | 'view' | 'feature' | 'tool' | 'assistant-template' | (string & {});
+export type PluginMarketplaceOperationAccess = 'read' | 'write' | 'admin' | (string & {});
+export interface PluginMarketplaceOperation {
+    name: string;
+    displayName?: string | I18nObject;
+    description?: string | I18nObject;
+    access?: PluginMarketplaceOperationAccess;
+    tags?: string[];
+}
+export interface PluginMarketplaceContribution {
+    id?: string;
+    type: PluginMarketplaceContributionType;
+    name: string;
+    displayName?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    operations?: PluginMarketplaceOperation[];
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface PluginTargetAppMarketplaceMetadata {
+    contents?: PluginMarketplaceContribution[];
+    featured?: boolean;
+    screenshots?: string[];
+    readme?: string;
+    updatedAt?: string;
+}
+export interface PluginTargetAppRuntimeMetadata {
+    middlewareProviders?: string[];
+    viewProviders?: string[];
+    templateProviders?: string[];
+    [key: string]: unknown;
+}
+export interface PluginSdkCompatibilityWarning {
+    code: PluginSdkCompatibilityWarningCode;
+    packageName: PluginName;
+    hostVersion: string;
+    peerRange?: string | null;
+    message: string;
+}
+export interface PluginTargetAppMetadata {
+    /**
+     * App-owned classification values. Each target app owns the vocabulary for its own entry.
+     */
+    types?: string[];
+    /**
+     * Minimum version of the target app that can safely use this plugin.
+     */
+    minAppVersion?: string;
+    capabilities?: string[];
+    marketplace?: PluginTargetAppMarketplaceMetadata;
+    runtime?: PluginTargetAppRuntimeMetadata;
+    [key: string]: unknown;
+}
+export type PluginTargetAppMeta = Record<string, PluginTargetAppMetadata | undefined>;
 export interface PluginCodeSourceConfig {
     workspacePath?: string;
 }
@@ -46,6 +103,24 @@ export interface PluginMeta {
      * Declares the plugin's operational level used for visibility and install/uninstall guardrails.
      */
     level?: PluginLevel;
+    /**
+     * Declares the product surfaces this plugin is intended to appear in.
+     *
+     * When omitted, the plugin remains a generic xpert-pro plugin for backwards compatibility.
+     */
+    targetApps?: PluginTargetApp[];
+    /**
+     * App-specific metadata grouped by target app without overloading the technical category.
+     */
+    targetAppMeta?: PluginTargetAppMeta;
+    /**
+     * Marks a plugin as deprecated while keeping it installable/visible for migration.
+     */
+    deprecated?: boolean;
+    /**
+     * Optional user-facing migration guidance shown when the plugin is deprecated.
+     */
+    deprecationMessage?: I18nObject;
     icon?: IconDefinition;
     category: 'set' | 'doc-source' | 'agent' | 'tools' | 'model' | 'vlm' | 'vector-store' | 'integration' | 'datasource' | 'database' | 'middleware';
     displayName: string;
@@ -102,6 +177,7 @@ export interface IPluginDescriptor {
     configSchema?: JsonSchemaObjectType;
     configurationStatus?: PluginConfigurationStatus | null;
     configurationError?: string | null;
+    sdkCompatibilityWarnings?: PluginSdkCompatibilityWarning[];
     loadStatus?: PluginLoadStatus | null;
     loadError?: string | null;
     effectiveInCurrentScope: boolean;

package/src/view-extension/model.d.ts

@@ -1,11 +1,13 @@
-import type { I18nObject } from '../types';
+import type { I18nObject, IconDefinition } from '../types';
+import type { JsonSchemaObjectType } from '../ai/types';
 export type XpertViewHostType = 'integration' | 'knowledgebase' | 'agent' | 'project' | 'sandbox' | string;
 export type XpertViewSlotMode = 'tabs' | 'sections' | 'widgets' | 'sidebar';
-export type XpertViewSchemaType = 'stats' | 'table' | 'list' | 'detail' | 'raw_json';
+export type XpertViewSchemaType = 'stats' | 'table' | 'list' | 'detail' | 'raw_json' | 'remote_component';
 export type XpertViewValueType = 'text' | 'number' | 'status' | 'datetime' | 'json';
 export type XpertViewColumnDataType = 'text' | 'number' | 'date' | 'datetime' | 'status' | 'tag' | 'avatar' | 'link';
 export type XpertViewActionPlacement = 'toolbar' | 'row';
 export type XpertViewActionType = 'invoke' | 'navigate' | 'open_detail' | 'refresh';
+export type XpertViewActionTransport = 'json' | 'file';
 export type XpertViewSortDirection = 'asc' | 'desc';
 export type XpertViewFilterOperator = 'eq' | 'neq' | 'contains' | 'starts_with' | 'ends_with' | 'in' | 'gt' | 'gte' | 'lt' | 'lte';
 export type XpertViewScalar = string | number | boolean | null;
@@ -21,9 +23,15 @@ export interface XpertViewHostContext {
     permissions?: string[];
     locale?: string;
 }
+export interface XpertViewHostCapabilities {
+    features?: string[];
+}
+export type XpertViewHostState = Record<string, unknown>;
 export interface XpertResolvedViewHostContext extends XpertViewHostContext {
     slots: XpertViewSlot[];
     hostSnapshot?: unknown;
+    capabilities?: XpertViewHostCapabilities;
+    hostState?: XpertViewHostState;
 }
 export interface XpertViewSlot {
     key: string;
@@ -44,6 +52,18 @@ export interface XpertViewPolling {
     enabled: boolean;
     intervalMs?: number;
 }
+export interface XpertViewActivation {
+    requiredFeatures?: string[];
+}
+export interface XpertWorkbenchViewOptions {
+    fixed?: boolean;
+    menu?: {
+        enabled?: boolean;
+        label?: string | I18nObject;
+        order?: number;
+        icon?: IconDefinition;
+    };
+}
 export interface XpertViewCachePolicy {
     enabled?: boolean;
     ttlMs?: number;
@@ -55,6 +75,7 @@ export interface XpertViewQuerySchema {
     supportsFilter?: boolean;
     supportsCursor?: boolean;
     supportsSelection?: boolean;
+    supportsParameters?: boolean;
     defaultPageSize?: number;
 }
 export interface XpertViewDataSource {
@@ -77,6 +98,7 @@ export interface XpertViewQuery {
     sortDirection?: XpertViewSortDirection;
     filters?: XpertViewFilter[];
     selectionId?: string;
+    parameters?: Record<string, XpertViewScalar | XpertViewScalar[]>;
 }
 export interface XpertStatsViewSchema {
     type: 'stats';
@@ -133,24 +155,98 @@ export interface XpertDetailViewSchema {
 export interface XpertRawJsonViewSchema {
     type: 'raw_json';
 }
-export type XpertViewSchema = XpertStatsViewSchema | XpertTableViewSchema | XpertListViewSchema | XpertDetailViewSchema | XpertRawJsonViewSchema;
+export interface XpertRemoteComponentViewSchema {
+    type: 'remote_component';
+    runtime: 'react';
+    protocolVersion: 1;
+    component: {
+        isolation: 'iframe' | 'module_federation';
+        entry: string;
+        module?: string;
+        exportName?: string;
+        integrity?: string;
+        propsSchema?: JsonSchemaObjectType;
+    };
+    dataSource: {
+        mode: 'platform';
+    };
+    actions?: XpertViewActionDefinition[];
+}
+export interface XpertRemoteComponentEntry {
+    html: string;
+    contentType?: 'text/html; charset=utf-8';
+}
+export type XpertViewSchema = XpertStatsViewSchema | XpertTableViewSchema | XpertListViewSchema | XpertDetailViewSchema | XpertRawJsonViewSchema | XpertRemoteComponentViewSchema;
+export interface XpertViewParameterDefinition {
+    key: string;
+    label: I18nObject;
+    description?: I18nObject;
+    required?: boolean;
+    type?: 'string' | 'number' | 'boolean';
+    optionSource?: {
+        mode: 'provider';
+        searchable?: boolean;
+        preload?: boolean;
+        dependsOn?: string[];
+    };
+}
+export interface XpertViewParameterOption {
+    value: XpertViewScalar;
+    label: string;
+    description?: string | null;
+    disabled?: boolean;
+}
+export interface XpertViewParameterOptionsQuery {
+    search?: string;
+    parameters?: Record<string, XpertViewScalar | XpertViewScalar[]>;
+}
+export interface XpertViewParameterOptionsResult {
+    items: XpertViewParameterOption[];
+}
 export interface XpertViewActionDefinition {
     key: string;
     label: I18nObject;
     icon?: string;
     placement?: XpertViewActionPlacement;
     actionType: XpertViewActionType;
+    transport?: XpertViewActionTransport;
+    inputSchema?: JsonSchemaObjectType;
+    inputDefaults?: 'target' | Record<string, unknown>;
     confirm?: {
         title?: I18nObject;
         message?: I18nObject;
     };
     permissions?: string[];
 }
+export interface XpertViewClientCommandDefinition {
+    key: string;
+    label?: I18nObject;
+    description?: I18nObject;
+    permissions?: string[];
+}
+export type XpertViewHostEventSubscriptionActionType = 'refresh' | 'forward' | 'refresh-and-forward';
+export interface XpertViewHostEventSubscription {
+    key: string;
+    event: string;
+    filter?: {
+        sources?: string[];
+        toolNames?: string[];
+        viewKeys?: string[];
+        visualizationTypes?: string[];
+    };
+    action?: {
+        type?: XpertViewHostEventSubscriptionActionType;
+        debounceMs?: number;
+    };
+}
+export interface XpertViewHostEvents {
+    subscriptions?: XpertViewHostEventSubscription[];
+}
 export interface XpertExtensionViewManifest {
     key: string;
     title: I18nObject;
     description?: I18nObject;
-    icon?: string;
+    icon?: IconDefinition;
     hostType: XpertViewHostType;
     slot: string;
     order?: number;
@@ -160,12 +256,19 @@ export interface XpertExtensionViewManifest {
     badge?: XpertViewBadge;
     refreshable?: boolean;
     polling?: XpertViewPolling;
+    activation?: XpertViewActivation;
+    workbench?: XpertWorkbenchViewOptions;
     view: XpertViewSchema;
     dataSource: XpertViewDataSource;
+    parameters?: XpertViewParameterDefinition[];
     actions?: XpertViewActionDefinition[];
+    clientCommands?: XpertViewClientCommandDefinition[];
+    hostEvents?: XpertViewHostEvents;
 }
 export interface XpertViewActionRequest {
     targetId?: string;
+    input?: Record<string, unknown> | null;
+    parameters?: Record<string, XpertViewScalar | XpertViewScalar[]>;
 }
 export interface XpertViewDataResult<TItem = unknown, TSummary = unknown> {
     items?: TItem[];