@xpert-ai/contracts 3.10.0 → 3.11.0

package/index.cjs.js

@@ -2242,7 +2242,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 +2331,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_");
 }
@@ -5646,6 +5655,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 +5738,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;
@@ -5796,6 +5845,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

@@ -2240,7 +2240,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 +2329,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_");
 }
@@ -5644,5 +5653,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, 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.0",
+  "version": "3.11.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.11"
+    "@xpert-ai/chatkit-types": "~0.3.13"
   },
   "types": "./index.d.ts"
 }

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/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-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-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/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/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,8 +68,149 @@ 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';
+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 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;
+    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.
@@ -44,6 +221,8 @@ export interface PluginTargetAppMetadata {
      */
     minAppVersion?: string;
     capabilities?: string[];
+    marketplace?: PluginTargetAppMarketplaceMetadata;
+    runtime?: PluginTargetAppRuntimeMetadata;
     [key: string]: unknown;
 }
 export type PluginTargetAppMeta = Record<string, PluginTargetAppMetadata | undefined>;
@@ -134,10 +313,12 @@ export interface IPluginDescriptor {
     configSchema?: JsonSchemaObjectType;
     configurationStatus?: PluginConfigurationStatus | null;
     configurationError?: string | null;
+    sdkCompatibilityWarnings?: PluginSdkCompatibilityWarning[];
     loadStatus?: PluginLoadStatus | null;
     loadError?: string | null;
     effectiveInCurrentScope: boolean;
     scopeRelation?: PluginScopeRelation;
+    componentSummary?: PluginComponentSummary;
 }
 export interface IPluginLatestVersionStatus {
     organizationId?: string;
@@ -153,3 +334,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;
+    };
+}

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

@@ -1,4 +1,4 @@
-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';
@@ -61,7 +61,7 @@ export interface XpertWorkbenchViewOptions {
         enabled?: boolean;
         label?: string | I18nObject;
         order?: number;
-        icon?: string;
+        icon?: IconDefinition;
     };
 }
 export interface XpertViewCachePolicy {
@@ -246,7 +246,7 @@ export interface XpertExtensionViewManifest {
     key: string;
     title: I18nObject;
     description?: I18nObject;
-    icon?: string;
+    icon?: IconDefinition;
     hostType: XpertViewHostType;
     slot: string;
     order?: number;