@xpert-ai/contracts 3.12.1 → 3.13.0

package/index.cjs.js

@@ -3821,6 +3821,7 @@ exports.MCPServerType = void 0;
     MCPServerType["CODE"] = "code";
     MCPServerType["HTTP"] = "http";
 })(exports.MCPServerType || (exports.MCPServerType = {}));
+var MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 
 /**
  * Build a hierarchical tree structure from a flat list of DocumentInterface objects,
@@ -5697,8 +5698,13 @@ var PLUGIN_RESOURCE_INSTALLATION_STATUS = {
     FAILED: "failed"
 };
 
+var ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
+var ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
+
 exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.API_PRINCIPAL_USER_ID_HEADER = API_PRINCIPAL_USER_ID_HEADER;
+exports.ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = ASSISTANT_CHAT_SEND_MESSAGE_COMMAND;
+exports.ASSISTANT_CONTEXT_SET_COMMAND = ASSISTANT_CONTEXT_SET_COMMAND;
 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;
@@ -5740,6 +5746,7 @@ exports.KnowledgeTask = KnowledgeTask;
 exports.KnowledgebaseChannel = KnowledgebaseChannel;
 exports.LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME = LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME;
 exports.LanguagesMap = LanguagesMap;
+exports.MCP_APP_RESOURCE_MIME_TYPE = MCP_APP_RESOURCE_MIME_TYPE;
 exports.MDX = schema;
 exports.MEMORY_PROFILE_PROMPT = MEMORY_PROFILE_PROMPT;
 exports.MEMORY_QA_PROMPT = MEMORY_QA_PROMPT;

package/index.esm.js

@@ -3819,6 +3819,7 @@ var MCPServerType;
     MCPServerType["CODE"] = "code";
     MCPServerType["HTTP"] = "http";
 })(MCPServerType || (MCPServerType = {}));
+var MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 
 /**
  * Build a hierarchical tree structure from a flat list of DocumentInterface objects,
@@ -5695,4 +5696,7 @@ var PLUGIN_RESOURCE_INSTALLATION_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, 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_IDEMPOTENCY_KEY, XPERT_TASK_SCHEDULE_PROPERTY_PREFIX, 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 };
+var ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
+var ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
+
+export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, API_PRINCIPAL_USER_ID_HEADER, ASSISTANT_CHAT_SEND_MESSAGE_COMMAND, ASSISTANT_CONTEXT_SET_COMMAND, 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, MCP_APP_RESOURCE_MIME_TYPE, 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_IDEMPOTENCY_KEY, XPERT_TASK_SCHEDULE_PROPERTY_PREFIX, 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.12.1",
+  "version": "3.13.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.13"
+    "@xpert-ai/chatkit-types": "~0.4.1"
   },
   "types": "./index.d.ts"
 }

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

@@ -122,6 +122,26 @@ export interface IChatConversation extends IBasePerTenantAndOrganizationEntityMo
 export type TChatConversationLog = IChatConversation & {
     messageCount: number;
 };
+export interface IChatConversationReadState extends IBasePerTenantAndOrganizationEntityModel {
+    conversationId: string;
+    userId: string;
+    lastReadAt: Date | string;
+    lastReadMessageId?: string | null;
+}
+export interface IChatConversationMarkReadRequest {
+    lastReadMessageId?: string | null;
+}
+export interface IChatConversationUnreadXpertsRequest {
+    xpertIds: string[];
+}
+export interface IChatConversationUnreadXpertSummary {
+    xpertId: string;
+    unreadMessages: number;
+    unreadConversations: number;
+    latestUnreadAt?: Date | string | null;
+    latestUnreadConversationId?: string | null;
+    latestUnreadThreadId?: string | null;
+}
 export type ChatMessage = {
     conversationId: string;
     id: string;

package/src/ai/index.d.ts

@@ -1,7 +1,7 @@
 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 { IconDefinition, IconType } from '../types';
 export type { TChatRequest } from './xpert-chat.model';
 export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from './chat-event.model';
 export * from './assistant-binding.model';

package/src/ai/xpert-tool-mcp.model.d.ts

@@ -1,3 +1,6 @@
+import type { TMcpAppCsp, TMcpAppPermissions, TMcpAppToolResult, TMcpAppVisibility } from '@xpert-ai/chatkit-types';
+import type { I18nObject } from '../i18n.model';
+import type { IconDefinition } from '../types';
 export declare enum MCPServerType {
     SSE = "sse",
     STDIO = "stdio",
@@ -8,18 +11,19 @@ export declare enum MCPServerType {
  * Configuration for stdio transport connection
  */
 export interface StdioConnection {
-    transport: "stdio";
+    transport: 'stdio';
     command: string;
     args: string[];
     env?: Record<string, string>;
+    stderr?: 'pipe' | 'inherit' | 'ignore' | string;
     encoding?: string;
-    encodingErrorHandler?: "strict" | "ignore" | "replace";
+    encodingErrorHandler?: 'strict' | 'ignore' | 'replace';
 }
 /**
  * Configuration for SSE transport connection
  */
 export interface SSEConnection {
-    transport: "sse";
+    transport: 'sse';
     url: string;
     headers?: Record<string, string>;
     useNodeEventSource?: boolean;
@@ -28,7 +32,7 @@ export interface SSEConnection {
  * Configuration for Streamable HTTP transport connection
  */
 export interface HttpConnection {
-    transport: "http";
+    transport: 'http';
     url: string;
     headers?: Record<string, string>;
     /**
@@ -43,19 +47,44 @@ export type TMCPServerReconnect = {
      */
     enabled?: boolean;
     /**
-      * Maximum number of restart attempts
-      */
+     * Maximum number of restart attempts
+     */
     maxAttempts?: number;
     /**
-      * Delay in milliseconds between restart attempts
-      */
+     * Delay in milliseconds between restart attempts
+     */
     delayMs?: number;
 };
+export type TMcpStdioRuntimePolicy = {
+    /**
+     * Runtime provider requested by the toolset or plugin. v1 supports
+     * local-process; sandbox and sidecar are reserved extension points.
+     */
+    provider?: 'local-process' | 'sandbox' | 'sidecar' | string;
+    /**
+     * Maximum startup wait time in milliseconds.
+     */
+    startupTimeoutMs?: number;
+    /**
+     * Maximum idle lifetime in milliseconds before the host may close the runtime.
+     */
+    idleTimeoutMs?: number;
+    /**
+     * Maximum total lifetime in milliseconds.
+     */
+    maxLifetimeMs?: number;
+    /**
+     * Optional command allow-list requested by the plugin/toolset. The platform
+     * allow-list remains authoritative.
+     */
+    allowedCommands?: string[];
+};
 export type TMCPServer = {
     type: MCPServerType;
     command?: string;
     args?: string[];
     env?: Record<string, string>;
+    stderr?: 'pipe' | 'inherit' | 'ignore' | string;
     encoding?: string;
     encodingErrorHandler?: string;
     /**
@@ -84,8 +113,74 @@ export type TMCPServer = {
      * Init scripts for sandbox
      */
     initScripts?: string;
+    /**
+     * Requested stdio runtime policy. The platform clamps this policy before use.
+     */
+    runtime?: TMcpStdioRuntimePolicy;
 };
 export type TMCPSchema = {
     servers?: Record<string, TMCPServer>;
     mcpServers?: Record<string, TMCPServer>;
 };
+export declare const MCP_APP_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
+export type TMcpAppUiMeta = {
+    resourceUri: string;
+    title?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    /**
+     * @deprecated MCP Apps resource security metadata belongs on the resource
+     * content item `_meta.ui`. Tool-level values are kept only as a legacy
+     * fallback while older plugins migrate.
+     */
+    csp?: TMcpAppCsp;
+    /**
+     * @deprecated MCP Apps resource security metadata belongs on the resource
+     * content item `_meta.ui`. Tool-level values are kept only as a legacy
+     * fallback while older plugins migrate.
+     */
+    permissions?: TMcpAppPermissions;
+    domain?: string;
+    prefersBorder?: boolean;
+};
+export type TMcpToolAppMeta = {
+    serverName: string;
+    name: string;
+    displayName: string;
+    inputSchema?: Record<string, unknown>;
+    visibility: TMcpAppVisibility[];
+    ui?: TMcpAppUiMeta;
+    annotations?: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
+};
+export type TMcpAppComponentData = {
+    type: 'McpApp';
+    appInstanceId: string;
+    appInstanceToken?: string;
+    resourceUri: string;
+    toolName: string;
+    toolCallId?: string;
+    toolsetId?: string;
+    serverName?: string;
+    executionId?: string;
+    title?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    csp?: TMcpAppCsp;
+    permissions?: TMcpAppPermissions;
+    domain?: string;
+    prefersBorder?: boolean;
+    toolInput?: Record<string, unknown>;
+    /**
+     * Standardized initial CallToolResult used to replay MCP App history without
+     * re-running the originating tool. Raw app HTML is never persisted here.
+     */
+    toolResult?: TMcpAppToolResult;
+    /** Serialized byte size of the initial tool result when known. */
+    toolResultSize?: number;
+    /** True when the initial tool result was too large to inline in chat history. */
+    toolResultTruncated?: boolean;
+    visibility?: TMcpAppVisibility[];
+    status?: 'running' | 'success' | 'fail';
+    error?: string;
+};

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

@@ -6,6 +6,7 @@ import { ITag } from '../tag-entity.model';
 import { TCopilotModel } from './copilot-model.model';
 import { Subscriber } from 'rxjs';
 import { I18nObject } from '../types';
+import { TMcpStdioRuntimePolicy } from './xpert-tool-mcp.model';
 export declare enum XpertToolsetCategoryEnum {
     BUILTIN = "builtin",
     API = "api",
@@ -63,6 +64,11 @@ export type TXpertToolsetOptions = {
     toolPositions?: Record<string, number>;
     disableToolDefault?: boolean;
     needSandbox?: boolean;
+    /**
+     * Runtime policy requested for MCP stdio toolsets. The server clamps this
+     * policy against platform and tenant-level security settings.
+     */
+    mcpRuntime?: TMcpStdioRuntimePolicy;
     [key: string]: any;
 };
 /**
@@ -187,6 +193,8 @@ export type TToolsetParams = {
     xpertId?: string;
     conversationId?: string;
     agentKey?: string;
+    executionId?: string;
+    appInstanceId?: string;
     signal?: AbortSignal;
     env: Record<string, unknown>;
 };

package/src/plugin.d.ts

@@ -1,6 +1,7 @@
 import { IBasePerTenantAndOrganizationEntityModel } from './base-entity.model';
 import { JsonSchemaObjectType } from './ai/types';
 import type { IXpert } from './ai/xpert.model';
+import type { TMcpStdioRuntimePolicy } from './ai/xpert-tool-mcp.model';
 import type { JSONValue } from './core.model';
 import { IconDefinition, I18nObject } from './types';
 export type PluginName = string;
@@ -120,6 +121,7 @@ export interface XpertPluginMcpServerPolicy {
     enabled?: boolean;
     defaultToolsApprovalMode?: PluginMcpToolApprovalMode;
     enabledTools?: string[];
+    runtime?: TMcpStdioRuntimePolicy;
     tools?: {
         [toolName: string]: {
             approvalMode?: PluginMcpToolApprovalMode;

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

@@ -227,6 +227,8 @@ export interface XpertViewClientCommandDefinition {
     description?: I18nObject;
     permissions?: string[];
 }
+export declare const ASSISTANT_CHAT_SEND_MESSAGE_COMMAND = "assistant.chat.send_message";
+export declare const ASSISTANT_CONTEXT_SET_COMMAND = "assistant.context.set";
 /**
  * Action a host should take when a view host event matches a manifest subscription.
  */