@xpert-ai/contracts 3.12.0 → 3.13.0

package/index.cjs.js

@@ -3808,7 +3808,8 @@ var Attachment_Type_Options = [
     }
 ];
 
-var XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+var XPERT_TASK_SCHEDULE_PROPERTY_PREFIX = "xpert_task_";
+var XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY = "__idempotency_key";
 
 var TASK_DESCRIPTION_PREFIX = "Launch a new agent to handle complex, multi-step tasks autonomously. \n\nAvailable agent types and the tools they have access to:";
 var TASK_DESCRIPTION_SUFFIX = 'When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.\n\nWhen to use the Agent tool:\n- When you are instructed to execute custom slash commands. Use the Agent tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file")\n\nWhen NOT to use the Agent tool:\n- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly\n- If you are searching for a specific term or definition within a known location, use the Glob tool instead, to find the match more quickly\n- If you are searching for content within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly\n- Other tasks that are not related to the agent descriptions above\n\n\nUsage notes:\n1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses\n2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.\n3. Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.\n4. The agent\'s outputs should generally be trusted\n5. Clearly tell the agent whether you expect it to create content, perform analysis, or just do research (search, file reads, web fetches, etc.), since it is not aware of the user\'s intent\n6. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.\n\nExample usage:\n\n<example_agent_descriptions>\n"content-reviewer": use this agent after you are done creating significant content or documents\n"greeting-responder": use this agent when to respond to user greetings with a friendly joke\n"research-analyst": use this agent to conduct thorough research on complex topics\n</example_agent_description>\n\n<example>\nuser: "Please write a function that checks if a number is prime"\nassistant: Sure let me write a function that checks if a number is prime\nassistant: First let me use the Write tool to write a function that checks if a number is prime\nassistant: I\'m going to use the Write tool to write the following code:\n<code>\nfunction isPrime(n) {\n  if (n <= 1) return false\n  for (let i = 2; i * i <= n; i++) {\n    if (n % i === 0) return false\n  }\n  return true\n}\n</code>\n<commentary>\nSince significant content was created and the task was completed, now use the content-reviewer agent to review the work\n</commentary>\nassistant: Now let me use the content-reviewer agent to review the code\nassistant: Uses the Task tool to launch with the content-reviewer agent \n</example>\n\n<example>\nuser: "Can you help me research the environmental impact of different renewable energy sources and create a comprehensive report?"\n<commentary>\nThis is a complex research task that would benefit from using the research-analyst agent to conduct thorough analysis\n</commentary>\nassistant: I\'ll help you research the environmental impact of renewable energy sources. Let me use the research-analyst agent to conduct comprehensive research on this topic.\nassistant: Uses the Task tool to launch with the research-analyst agent, providing detailed instructions about what research to conduct and what format the report should take\n</example>\n\n<example>\nuser: "Hello"\n<commentary>\nSince the user is greeting, use the greeting-responder agent to respond with a friendly joke\n</commentary>\nassistant: "I\'m going to use the Task tool to launch with the greeting-responder agent"\n</example>';
@@ -3820,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,
@@ -5696,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;
@@ -5739,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;
@@ -5785,7 +5793,8 @@ exports.USAGE_HOUR_FORMAT = USAGE_HOUR_FORMAT;
 exports.VariableOperations = VariableOperations;
 exports.WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME = WORKSPACE_PUBLIC_SKILL_REPOSITORY_NAME;
 exports.WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER = WORKSPACE_PUBLIC_SKILL_SOURCE_PROVIDER;
-exports.XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY;
+exports.XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY = XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY;
+exports.XPERT_TASK_SCHEDULE_PROPERTY_PREFIX = XPERT_TASK_SCHEDULE_PROPERTY_PREFIX;
 exports.agentLabel = agentLabel;
 exports.agentUniqueName = agentUniqueName;
 exports.allChannels = allChannels;

package/index.esm.js

@@ -3806,7 +3806,8 @@ var Attachment_Type_Options = [
     }
 ];
 
-var XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+var XPERT_TASK_SCHEDULE_PROPERTY_PREFIX = "xpert_task_";
+var XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY = "__idempotency_key";
 
 var TASK_DESCRIPTION_PREFIX = "Launch a new agent to handle complex, multi-step tasks autonomously. \n\nAvailable agent types and the tools they have access to:";
 var TASK_DESCRIPTION_SUFFIX = 'When using the Task tool, you must specify a subagent_type parameter to select which agent type to use.\n\nWhen to use the Agent tool:\n- When you are instructed to execute custom slash commands. Use the Agent tool with the slash command invocation as the entire prompt. The slash command can take arguments. For example: Task(description="Check the file")\n\nWhen NOT to use the Agent tool:\n- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly\n- If you are searching for a specific term or definition within a known location, use the Glob tool instead, to find the match more quickly\n- If you are searching for content within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly\n- Other tasks that are not related to the agent descriptions above\n\n\nUsage notes:\n1. Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses\n2. When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.\n3. Each agent invocation is stateless. You will not be able to send additional messages to the agent, nor will the agent be able to communicate with you outside of its final report. Therefore, your prompt should contain a highly detailed task description for the agent to perform autonomously and you should specify exactly what information the agent should return back to you in its final and only message to you.\n4. The agent\'s outputs should generally be trusted\n5. Clearly tell the agent whether you expect it to create content, perform analysis, or just do research (search, file reads, web fetches, etc.), since it is not aware of the user\'s intent\n6. If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.\n\nExample usage:\n\n<example_agent_descriptions>\n"content-reviewer": use this agent after you are done creating significant content or documents\n"greeting-responder": use this agent when to respond to user greetings with a friendly joke\n"research-analyst": use this agent to conduct thorough research on complex topics\n</example_agent_description>\n\n<example>\nuser: "Please write a function that checks if a number is prime"\nassistant: Sure let me write a function that checks if a number is prime\nassistant: First let me use the Write tool to write a function that checks if a number is prime\nassistant: I\'m going to use the Write tool to write the following code:\n<code>\nfunction isPrime(n) {\n  if (n <= 1) return false\n  for (let i = 2; i * i <= n; i++) {\n    if (n % i === 0) return false\n  }\n  return true\n}\n</code>\n<commentary>\nSince significant content was created and the task was completed, now use the content-reviewer agent to review the work\n</commentary>\nassistant: Now let me use the content-reviewer agent to review the code\nassistant: Uses the Task tool to launch with the content-reviewer agent \n</example>\n\n<example>\nuser: "Can you help me research the environmental impact of different renewable energy sources and create a comprehensive report?"\n<commentary>\nThis is a complex research task that would benefit from using the research-analyst agent to conduct thorough analysis\n</commentary>\nassistant: I\'ll help you research the environmental impact of renewable energy sources. Let me use the research-analyst agent to conduct comprehensive research on this topic.\nassistant: Uses the Task tool to launch with the research-analyst agent, providing detailed instructions about what research to conduct and what format the report should take\n</example>\n\n<example>\nuser: "Hello"\n<commentary>\nSince the user is greeting, use the greeting-responder agent to respond with a friendly joke\n</commentary>\nassistant: "I\'m going to use the Task tool to launch with the greeting-responder agent"\n</example>';
@@ -3818,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,
@@ -5694,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_RUNTIME_STATE_KEY, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createConversationTitleSummaryEvent, createFollowUpConsumedEvent, createMessageAppendContextTracker, createThreadGoalClearedEvent, createThreadGoalUpdatedEvent, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, ensureAssistantBindingSkillWorkspacePreference, extractSemanticModelDraft, figureOutXpert, filterAssistantBindingDisabledSkillIds, filterAssistantBindingDisabledTools, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getAssistantBindingDisabledSkillIds, getAssistantBindingDisabledTools, getAssistantManagement, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, getXpertAgentRecursionLimit, getXpertWorkspaceVisibility, inferMessageAppendContext, isAgentKey, isAgentWorkflowNode, isAgentWorkflowNodeType, isAssistantBindingSkillEnabled, isAssistantBindingToolEnabled, isAssistantBindingToolPreferencesEmpty, isAudioType, isContextCompressionComponentData, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRequiredMiddleware, isRouterKey, isRunnableThreadGoalStatus, isSystemManagedAssistant, isTenantSharedXpertWorkspace, isToolEnabled, isUserAddableAgentMiddleware, isUserManagedAssistant, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, mergeMessageContentForDisplay, messageContentText, normalizeAssistantBindingToolPreferences, normalizeMiddlewareNode, normalizeMiddlewareNodes, normalizeMiddlewareProvider, normalizeXpertAgentConfig, omitXpertRelations, replaceAgentInDraft, resolveDraftPrimaryAgent, resolveDraftRuntimeGraph, resolveI18nText, resolveMessageAppendContext, resolveRuntimeXpert, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, updateAssistantBindingSkillPreferences, updateAssistantBindingToolPreferences, uuid, workflowNodeIdentifier, xpertLabel };
+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.0",
+  "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';
@@ -57,3 +57,4 @@ export * from './middleware.model';
 export * from './context-compression.model';
 export * from './sandbox';
 export * from './message-content.utils';
+export * from './mobile.model';

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

@@ -0,0 +1,79 @@
+import type { AssistantBindingScope, AssistantBindingSourceScope, AssistantCode, IResolvedAssistantBinding } from './assistant-binding.model';
+import type { SANDBOX_TERMINAL_NAMESPACE } from './sandbox-terminal.model';
+import type { TAvatar } from '../types';
+import type { LanguagesEnum } from '../user.model';
+import type { XpertTypeEnum } from './xpert.model';
+export interface XpertMobileDeploymentConfig {
+    apiBaseUrl?: string | null;
+    apiBasePath: '/api';
+    aiApiPath: '/api/ai';
+    chatkitFrameUrl: string;
+    viewHostsPath: '/api/view-hosts';
+    socketNamespaces: {
+        sandboxTerminal: typeof SANDBOX_TERMINAL_NAMESPACE;
+    };
+    capabilities: {
+        chatkit: boolean;
+        extensionViews: boolean;
+        scheduledTasks: boolean;
+        fileMemory: boolean;
+        sandboxTerminal: boolean;
+        publicChatkitSessions: boolean;
+    };
+}
+export interface XpertMobileUserSummary {
+    id: string;
+    tenantId?: string | null;
+    email?: string | null;
+    name?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    fullName?: string | null;
+    imageUrl?: string | null;
+    preferredLanguage?: LanguagesEnum | string | null;
+}
+export interface XpertMobileOrganizationSummary {
+    id: string;
+    tenantId?: string | null;
+    name: string;
+    imageUrl?: string | null;
+    isDefault: boolean;
+    isActive: boolean;
+    timeZone?: string | null;
+    preferredLanguage?: LanguagesEnum | string | null;
+}
+export interface XpertMobileAssistantBindingSummary extends Pick<IResolvedAssistantBinding, 'assistantId' | 'enabled' | 'tenantId' | 'organizationId' | 'userId'> {
+    code: AssistantCode;
+    scope: AssistantBindingScope;
+    sourceScope: AssistantBindingSourceScope;
+}
+export interface XpertMobileBootstrap {
+    deployment: XpertMobileDeploymentConfig;
+    user: XpertMobileUserSummary;
+    organizations: XpertMobileOrganizationSummary[];
+    activeOrganizationId?: string | null;
+    defaultOrganizationId?: string | null;
+    assistantBindings: XpertMobileAssistantBindingSummary[];
+}
+export interface XpertMobileXpertSummary {
+    id: string;
+    slug: string;
+    name: string;
+    type: XpertTypeEnum | string;
+    title?: string | null;
+    titleCN?: string | null;
+    description?: string | null;
+    avatar?: TAvatar | null;
+    version?: string | null;
+    latest?: boolean | null;
+    workspaceId?: string | null;
+    organizationId?: string | null;
+    publishAt?: Date | string | null;
+    starters?: string[] | null;
+}
+export interface XpertMobileXpertsResponse {
+    items: XpertMobileXpertSummary[];
+    total: number;
+    limit: number;
+    offset: number;
+}

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

@@ -4,7 +4,8 @@ import type { TXpertChatState } from '@xpert-ai/chatkit-types';
 import { IChatConversation } from './chat.model';
 import { JsonSchemaObjectType } from './types';
 import { IXpert } from './xpert.model';
-export declare const XPERT_TASK_SCHEDULE_RUNTIME_STATE_KEY = "xpertTaskSchedule";
+export declare const XPERT_TASK_SCHEDULE_PROPERTY_PREFIX = "xpert_task_";
+export declare const XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY = "__idempotency_key";
 export type TXpertTaskScheduleCapabilities = {
     xpertId: string;
     agentKey?: string;
@@ -16,7 +17,7 @@ export type TXpertTaskScheduleCapabilities = {
     stateSchema?: JsonSchemaObjectType;
 };
 export type TXpertTaskScheduleRuntimeState = {
-    idempotencyKey?: string;
+    [XPERT_TASK_SCHEDULE_IDEMPOTENCY_KEY]?: string;
 };
 /**
  * Tools for Xpert

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

@@ -38,6 +38,9 @@ export interface XpertViewSlot {
     title?: I18nObject;
     mode: XpertViewSlotMode;
     order?: number;
+    manifestPolicy?: {
+        requireFeatureActivation?: boolean;
+    };
 }
 export interface XpertViewSource {
     provider: string;
@@ -224,24 +227,94 @@ 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.
+ */
 export type XpertViewHostEventSubscriptionActionType = 'refresh' | 'forward' | 'refresh-and-forward';
+/**
+ * Declarative host event subscription owned by a view manifest.
+ */
 export interface XpertViewHostEventSubscription {
+    /** Stable subscription key used for de-duping and diagnostics. */
     key: string;
+    /** Machine-readable event type, for example `assistant.tool.completed`. */
     event: string;
     filter?: {
+        /** Optional event source allow-list, for example `chatkit`. */
         sources?: string[];
+        /** Optional tool name allow-list for assistant tool completion events. */
         toolNames?: string[];
+        /** Optional remote view key allow-list for visualization events. */
         viewKeys?: string[];
+        /** Optional visualization type allow-list. */
         visualizationTypes?: string[];
     };
     action?: {
+        /** Defaults to `refresh` when omitted. */
         type?: XpertViewHostEventSubscriptionActionType;
+        /** Suppresses repeated matching events with the same debounce key for this duration. */
         debounceMs?: number;
     };
 }
+/**
+ * Host event subscriptions declared by a remote view manifest.
+ */
 export interface XpertViewHostEvents {
     subscriptions?: XpertViewHostEventSubscription[];
 }
+/**
+ * Optional visualization metadata attached to a host event.
+ */
+export interface XpertViewHostEventVisualization {
+    /** Visualization renderer/type discriminator. */
+    type?: string;
+    /** Remote view key associated with the emitted visualization. */
+    viewKey?: string;
+    /** Human-readable visualization title. */
+    title?: string;
+    /** Host slot that should receive the visualization. */
+    slotKey?: string;
+    /** Parameter key associated with this visualization payload. */
+    parameterKey?: string;
+}
+/**
+ * Event payload forwarded to remote components. Keep this shape host-agnostic so
+ * the same plugin can run in xpert and data-xpert.
+ */
+export interface XpertRemoteViewHostEventMessage {
+    /** Stable event id for diagnostics and de-duping. */
+    id: string;
+    /** Machine-readable event type, for example `assistant.tool.completed`. */
+    type: string;
+    /** Event source, for example `chatkit`. */
+    source: string;
+    /** ISO timestamp captured when the host normalized the event. */
+    receivedAt: string;
+    /** Conversation or execution thread id when available. */
+    threadId?: string;
+    /** Tool name for assistant tool events. */
+    toolName?: string;
+    /** Tool call id when provided by the runtime. */
+    toolCallId?: string;
+    /** Runtime run id when provided by the runtime. */
+    runId?: string;
+    /** Tool duration in milliseconds when provided by the runtime. */
+    durationMs?: number;
+    /** Opaque event data. Plugin-specific ids stay inside this payload. */
+    data?: Record<string, unknown>;
+    /** Optional visualization metadata used by manifest filters and remote views. */
+    visualization?: XpertViewHostEventVisualization;
+}
+/**
+ * Host-internal event message. `hostType` and `hostId` are routing fields and
+ * must be stripped before forwarding to remote components.
+ */
+export interface XpertViewHostEventMessage extends XpertRemoteViewHostEventMessage {
+    hostType?: string;
+    hostId?: string;
+}
 export interface XpertExtensionViewManifest {
     key: string;
     title: I18nObject;