@metad/contracts 3.8.3 → 3.8.4

package/index.cjs.js

@@ -1755,7 +1755,8 @@ function agentUniqueName(agent) {
 function convertToUrlPath(title) {
     return title === null || title === void 0 ? void 0 : title.toLowerCase() // Convert to lowercase
     .replace(/\s+/g, "-") // Replace spaces with -
-    .replace(/[^a-z0-9-]/g, ""); // Remove non-alphanumeric characters
+    .replace(/[^a-z0-9-]/g, "") // Remove non-alphanumeric characters
+    ;
 }
 var VariableOperations = [
     {
@@ -1906,9 +1907,9 @@ function messageContentText(content) {
 }
 /**
  * Get workspace folder for sandbox from runnable configurable
- * 
- * @param configurable 
- * @returns 
+ *
+ * @param configurable
+ * @returns
  */ function getWorkspaceFromRunnable(configurable) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
@@ -1930,9 +1931,9 @@ function getToolCallIdFromConfig(config) {
  * Compute long-term memory namespace:
  * 1. When a user talks to a digital expert individually, use `ExpertId` + `UserId` to store memory
  * 2. When talking to a digital expert in a project, all users and digital experts share `ProjectId` to store memory
- * 
- * @param config 
- * @returns 
+ *
+ * @param config
+ * @returns
  */ function getStoreNamespace(config) {
     var configurable = config.configurable;
     return configurableStoreNamespace(configurable);
@@ -1947,11 +1948,11 @@ function configurableStoreNamespace(configurable) {
 }
 /**
  * Set value into variable of state.
- * 
- * @param state 
- * @param varName 
- * @param value 
- * @returns 
+ *
+ * @param state
+ * @param varName
+ * @param value
+ * @returns
  */ function setStateVariable(state, varName, value) {
     var _varName_split = _sliced_to_array$3(varName.split("."), 2), agentChannelName = _varName_split[0], variableName = _varName_split[1];
     if (variableName) {
@@ -1964,10 +1965,10 @@ function configurableStoreNamespace(configurable) {
 }
 /**
  * Get agent variable group from graph.
- * 
- * @param key 
- * @param graph 
- * @returns 
+ *
+ * @param key
+ * @param graph
+ * @returns
  */ function getAgentVarGroup(key, graph) {
     var _agent_options;
     var node = graph.nodes.find(function(_) {
@@ -2023,9 +2024,9 @@ function configurableStoreNamespace(configurable) {
 // Swarm
 /**
  * Get swarm partners of agent in team
- * 
- * @param graph 
- * @param agentKey 
+ *
+ * @param graph
+ * @param agentKey
  */ function getSwarmPartners(graph, agentKey, partners, leaderKey) {
     var connections = graph.connections.filter(function(conn) {
         return conn.type === "agent" && conn.to === agentKey && (leaderKey ? conn.from !== leaderKey : true) && graph.connections.some(function(_) {
@@ -3049,6 +3050,12 @@ function getAgentMiddlewareNodes(graph, agentKey) {
     return middlewares;
 }
 
+var SANDBOX_WORK_FOR_TYPES = [
+    "user",
+    "project",
+    "environment"
+];
+
 function _array_like_to_array$3(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
@@ -4350,6 +4357,19 @@ var PLUGIN_LEVEL = {
     SYSTEM: "system",
     ORGANIZATION: "organization"
 };
+var PLUGIN_SOURCE = {
+    MARKETPLACE: "marketplace",
+    LOCAL: "local",
+    GIT: "git",
+    URL: "url",
+    NPM: "npm",
+    CODE: "code",
+    ENV: "env"
+};
+var PLUGIN_CONFIGURATION_STATUS = {
+    VALID: "valid",
+    INVALID: "invalid"
+};
 
 exports.AI_MODEL_TYPE_VARIABLE = AI_MODEL_TYPE_VARIABLE;
 exports.Attachment_Type_Options = Attachment_Type_Options;
@@ -4388,9 +4408,12 @@ exports.MEMORY_PROFILE_PROMPT = MEMORY_PROFILE_PROMPT;
 exports.MEMORY_QA_PROMPT = MEMORY_QA_PROMPT;
 exports.OllamaEmbeddingsProviders = OllamaEmbeddingsProviders;
 exports.OpenAIEmbeddingsProviders = OpenAIEmbeddingsProviders;
+exports.PLUGIN_CONFIGURATION_STATUS = PLUGIN_CONFIGURATION_STATUS;
 exports.PLUGIN_LEVEL = PLUGIN_LEVEL;
+exports.PLUGIN_SOURCE = PLUGIN_SOURCE;
 exports.PermissionApprovalStatus = PermissionApprovalStatus;
 exports.PermissionGroups = PermissionGroups;
+exports.SANDBOX_WORK_FOR_TYPES = SANDBOX_WORK_FOR_TYPES;
 exports.STANDARD_METADATA_FIELDS = STANDARD_METADATA_FIELDS;
 exports.STATE_SYS_VOLUME = STATE_SYS_VOLUME;
 exports.STATE_SYS_WORKSPACE_PATH = STATE_SYS_WORKSPACE_PATH;

package/index.esm.js

@@ -1753,7 +1753,8 @@ function agentUniqueName(agent) {
 function convertToUrlPath(title) {
     return title === null || title === void 0 ? void 0 : title.toLowerCase() // Convert to lowercase
     .replace(/\s+/g, "-") // Replace spaces with -
-    .replace(/[^a-z0-9-]/g, ""); // Remove non-alphanumeric characters
+    .replace(/[^a-z0-9-]/g, "") // Remove non-alphanumeric characters
+    ;
 }
 var VariableOperations = [
     {
@@ -1904,9 +1905,9 @@ function messageContentText(content) {
 }
 /**
  * Get workspace folder for sandbox from runnable configurable
- * 
- * @param configurable 
- * @returns 
+ *
+ * @param configurable
+ * @returns
  */ function getWorkspaceFromRunnable(configurable) {
     return (configurable === null || configurable === void 0 ? void 0 : configurable.projectId) ? {
         type: "project",
@@ -1928,9 +1929,9 @@ function getToolCallIdFromConfig(config) {
  * Compute long-term memory namespace:
  * 1. When a user talks to a digital expert individually, use `ExpertId` + `UserId` to store memory
  * 2. When talking to a digital expert in a project, all users and digital experts share `ProjectId` to store memory
- * 
- * @param config 
- * @returns 
+ *
+ * @param config
+ * @returns
  */ function getStoreNamespace(config) {
     var configurable = config.configurable;
     return configurableStoreNamespace(configurable);
@@ -1945,11 +1946,11 @@ function configurableStoreNamespace(configurable) {
 }
 /**
  * Set value into variable of state.
- * 
- * @param state 
- * @param varName 
- * @param value 
- * @returns 
+ *
+ * @param state
+ * @param varName
+ * @param value
+ * @returns
  */ function setStateVariable(state, varName, value) {
     var _varName_split = _sliced_to_array$3(varName.split("."), 2), agentChannelName = _varName_split[0], variableName = _varName_split[1];
     if (variableName) {
@@ -1962,10 +1963,10 @@ function configurableStoreNamespace(configurable) {
 }
 /**
  * Get agent variable group from graph.
- * 
- * @param key 
- * @param graph 
- * @returns 
+ *
+ * @param key
+ * @param graph
+ * @returns
  */ function getAgentVarGroup(key, graph) {
     var _agent_options;
     var node = graph.nodes.find(function(_) {
@@ -2021,9 +2022,9 @@ function configurableStoreNamespace(configurable) {
 // Swarm
 /**
  * Get swarm partners of agent in team
- * 
- * @param graph 
- * @param agentKey 
+ *
+ * @param graph
+ * @param agentKey
  */ function getSwarmPartners(graph, agentKey, partners, leaderKey) {
     var connections = graph.connections.filter(function(conn) {
         return conn.type === "agent" && conn.to === agentKey && (leaderKey ? conn.from !== leaderKey : true) && graph.connections.some(function(_) {
@@ -3047,6 +3048,12 @@ function getAgentMiddlewareNodes(graph, agentKey) {
     return middlewares;
 }
 
+var SANDBOX_WORK_FOR_TYPES = [
+    "user",
+    "project",
+    "environment"
+];
+
 function _array_like_to_array$3(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
@@ -4348,5 +4355,18 @@ var PLUGIN_LEVEL = {
     SYSTEM: "system",
     ORGANIZATION: "organization"
 };
+var PLUGIN_SOURCE = {
+    MARKETPLACE: "marketplace",
+    LOCAL: "local",
+    GIT: "git",
+    URL: "url",
+    NPM: "npm",
+    CODE: "code",
+    ENV: "env"
+};
+var PLUGIN_CONFIGURATION_STATUS = {
+    VALID: "valid",
+    INVALID: "invalid"
+};
 
-export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CONTEXT_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageFeedbackRatingEnum, 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_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, 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, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseTypeEnum, 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_LEVEL, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RoleTypeEnum, RolesEnum, SMTPSecureEnum, STANDARD_METADATA_FIELDS, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_URL, STATE_VARIABLE_FILES, STATE_VARIABLE_INPUT, STATE_VARIABLE_SYS, STATE_VARIABLE_TITLE_CHANNEL, ScheduleTaskStatus, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, TOOL_NAME_REGEX, TagCategoryEnum, TaskFrequency, TaskListTypeEnum, TimeGranularity, ToolParameterForm, ToolParameterType, ToolTagEnum, TranslationLanguageMap, USAGE_HOUR_FORMAT, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createMessageAppendContextTracker, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, extractSemanticModelDraft, figureOutXpert, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, inferMessageAppendContext, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isToolEnabled, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, messageContentText, omitXpertRelations, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, uuid, workflowNodeIdentifier, xpertLabel };
+export { AIPermissionsEnum, AI_MODEL_TYPE_VARIABLE, AccessEnum, AgentEventType, AgentType, AiBusinessRole, AiFeatureEnum, AiModelTypeEnum, AiProtocol, AiProvider, AiProviderRole, AlignmentOptions, AnalyticsFeatures, AnalyticsPermissionsEnum, ApiAuthType, ApiProviderSchemaType, ApprovalPolicyTypesEnum, ApprovalPolicyTypesStringEnum, Attachment_Type_Options, AuthenticationEnum, BIInterruptMessageType, BonusTypeEnum, BusinessAreaRole, BusinessType, CONTEXT_VARIABLE_CURRENTSTATE, ChatDashboardMessageType, ChatGatewayEvent, ChatMessageFeedbackRatingEnum, 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_TENANT, DEFAULT_TIME_FORMATS, DEFAULT_TYPE, 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, KnowledgeProviderEnum, KnowledgeStructureEnum, KnowledgeTask, KnowledgebaseChannel, KnowledgebasePermission, KnowledgebaseTypeEnum, 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_SOURCE, ParameterType, ParameterTypeEnum, PayPeriodEnum, PermissionApprovalStatus, PermissionApprovalStatusTypesEnum, PermissionGroups, PermissionsEnum, PriceType, ProjectBillingEnum, ProjectOwnerEnum, ProjectStatusEnum, ProviderEnum, ProviderType, QueryStatusEnum, RegionsEnum, RequestMethodEnum, RoleTypeEnum, RolesEnum, SANDBOX_WORK_FOR_TYPES, SMTPSecureEnum, STANDARD_METADATA_FIELDS, STATE_SYS_VOLUME, STATE_SYS_WORKSPACE_PATH, STATE_SYS_WORKSPACE_URL, STATE_VARIABLE_FILES, STATE_VARIABLE_INPUT, STATE_VARIABLE_SYS, STATE_VARIABLE_TITLE_CHANNEL, ScheduleTaskStatus, SemanticModelStatusEnum, StoryStatusEnum, StoryTemplateType, SubscriptionType, TASK_DESCRIPTION_PREFIX, TASK_DESCRIPTION_SUFFIX, TENANT_AGENT_LOCAL_URL, TOOL_NAME_REGEX, TagCategoryEnum, TaskFrequency, TaskListTypeEnum, TimeGranularity, ToolParameterForm, ToolParameterType, ToolTagEnum, TranslationLanguageMap, USAGE_HOUR_FORMAT, UserType, VariableOperationEnum, VariableOperations, VectorTypeEnum, Visibility, VisitEntityEnum, VisitTypeEnum, WeekDaysEnum, WorkflowComparisonOperator, WorkflowLogicalOperator, WorkflowNodeTypeEnum, XpertAgentExecutionStatusEnum, XpertParameterTypeEnum, XpertTableStatus, XpertToolsetCategoryEnum, XpertTypeEnum, agentLabel, agentUniqueName, allChannels, appendMessageContent, appendMessagePlainText, buildChunkTree, channelName, classificateDocumentCategory, collectTreeLeaves, configurableStoreNamespace, convertToUrlPath, createAgentConnections, createMessageAppendContextTracker, createXpertGraph, createXpertNodes, embeddingCubeCollectionName, extractSemanticModelDraft, figureOutXpert, filterMessageText, findStartNodes, genJSONParseKey, genJSONStringifyKey, genListOperatorKey, genPipelineChunkerKey, genPipelineKnowledgeBaseKey, genPipelineProcessorKey, genPipelineSourceKey, genPipelineUnderstandingKey, genVariableAggregatorKey, genXpertDBDeleteKey, genXpertDBInsertKey, genXpertDBQueryKey, genXpertDBSqlKey, genXpertDBUpdateKey, genXpertIteratorKey, genXpertMiddlewareKey, genXpertSkillKey, genXpertStartKey, genXpertTriggerKey, generateCronExpression, getAgentMiddlewareNodes, getAgentVarGroup, getCurrentGraph, getEnabledTools, getStoreNamespace, getSwarmPartners, getToolCallFromConfig, getToolCallIdFromConfig, getToolLabel, getVariableSchema, getWorkflowTriggers, getWorkspaceFromRunnable, inferMessageAppendContext, isAgentKey, isAudioType, isDocumentSheet, isEnableTool, isImageType, isInterruptMessage, isIteratingKey, isIteratorKey, isMessageGroup, isMiddlewareToolEnabled, isRouterKey, isToolEnabled, isVideoType, isXpertNodeType, letterStartSUID, locateNodes, mapTranslationLanguage, messageContentText, omitXpertRelations, resolveMessageAppendContext, setStateVariable, shortTitle, stringifyMessageContent, transformInstallation, uuid, workflowNodeIdentifier, xpertLabel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metad/contracts",
-  "version": "3.8.3",
+  "version": "3.8.4",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/agent/graph.d.ts

@@ -2,6 +2,7 @@ import { BaseMessage } from '@langchain/core/messages';
 import { RunnableConfig } from '@langchain/core/runnables';
 import { TMessageContentComplex } from '@xpert-ai/chatkit-types';
 import { Subscriber } from 'rxjs';
+import { ICopilotModel } from '../ai/copilot-model.model';
 import { TWorkflowVarGroup } from '../ai/xpert-workflow.model';
 import { TXpertGraph } from '../ai/xpert.model';
 import { IXpertAgent } from '../ai/xpert-agent.model';
@@ -31,8 +32,30 @@ export type TMessageChannel = {
     error?: string | null;
 };
 export type TSandboxConfigurable = {
+    /**
+     * Resolved sandbox provider type used for this backend acquisition.
+     */
     provider?: string;
+    /**
+     * Effective working directory inside the sandbox backend.
+     */
     workingDirectory?: string;
+    /**
+     * Canonical sandbox environment id that owns this backend/container.
+     */
+    environmentId?: string | null;
+    /**
+     * Underlying runtime container id when the backend is container-backed.
+     */
+    containerId?: string | null;
+    /**
+     * Container lifecycle run id created for this acquisition, if a new
+     * container run was recorded.
+     */
+    runId?: string | null;
+    /**
+     * Concrete backend instance used by the agent/runtime.
+     */
     backend?: unknown;
 };
 export type TAgentRunnableConfigurable = {
@@ -55,6 +78,7 @@ export type TAgentRunnableConfigurable = {
     agentKey: string;
     xpertName?: string;
     toolName?: string;
+    copilotModel?: ICopilotModel;
     subscriber: Subscriber<any>;
     /**
      * Execution id of agent workflow node

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

@@ -9,6 +9,7 @@ import { IStorageFile } from '../storage-file.model';
 import { IXpertTask } from './xpert-task.model';
 import { TToolCall } from '../agent';
 import { TInterrupt } from '../agent/interrupt';
+import { IUser } from '../user.model';
 export type TChatConversationOptions = {
     parameters?: {
         input?: string;
@@ -19,8 +20,9 @@ export type TChatConversationOptions = {
     features?: Array<'timeline' | 'sandbox' | 'files'>;
     workspacePath?: string;
     workspaceUrl?: string;
+    sandboxEnvironmentId?: string;
 };
-export type TChatConversationStatus = "idle" | "busy" | "interrupted" | "error";
+export type TChatConversationStatus = 'idle' | 'busy' | 'interrupted' | 'error';
 export type TToolCallType = 'agent' | 'tool';
 export type TChatFrom = 'platform' | 'webapp' | 'debugger' | 'knowledge' | 'job' | 'api' | 'feishu' | 'lark' | 'dingtalk' | 'wecom';
 /**
@@ -90,6 +92,10 @@ export interface IChatConversation extends IBasePerTenantAndOrganizationEntityMo
      * End anonymous user
      */
     fromEndUserId?: string;
+    /**
+     * Internal user matched by fromEndUserId when available
+     */
+    fromEndUser?: IUser;
     /**
      * Chat with Xpert
      */

package/src/ai/index.d.ts

@@ -1,4 +1,5 @@
 export * from '@xpert-ai/chatkit-types';
+export type { TChatRequest } from './xpert-chat.model';
 export * from './ai-model.model';
 export * from './ai.model';
 export * from './chat.model';
@@ -21,6 +22,7 @@ export * from './knowledge-doc-page.model';
 export * from './role-permissions';
 export * from './xpert-agent-execution.model';
 export * from './xpert-agent.model';
+export * from './xpert-chat.model';
 export * from './xpert-tool.model';
 export * from './xpert-toolset.model';
 export * from './xpert-workspace.model';

package/src/ai/sandbox.d.ts

@@ -1,6 +1,8 @@
-import { I18nObject, IconDefinition } from "../types";
+import { I18nObject, IconDefinition } from '../types';
 export type TSandboxProviderMeta = {
     name: I18nObject;
     description?: I18nObject;
     icon: IconDefinition;
 };
+export declare const SANDBOX_WORK_FOR_TYPES: readonly ["user", "project", "environment"];
+export type TSandboxWorkForType = (typeof SANDBOX_WORK_FOR_TYPES)[number];

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

@@ -1,4 +1,3 @@
-import { STATE_VARIABLE_HUMAN, TChatRequestHuman, TInterruptCommand } from '@xpert-ai/chatkit-types';
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
 import { ICopilotModel, TCopilotModel } from './copilot-model.model';
 import { IKnowledgebase, TKBRecallParams } from './knowledgebase.model';
@@ -138,7 +137,7 @@ export type TXpertAgentOptions = {
      * - *jsonSchema*
      *
      */
-    structuredOutputMethod?: "functionCalling" | "jsonMode" | "jsonSchema" | string;
+    structuredOutputMethod?: 'functionCalling' | 'jsonMode' | 'jsonSchema' | string;
     /**
      * @deprecated use attachment
      */
@@ -178,41 +177,14 @@ export type TAgentPromptTemplate = {
 };
 export type TAgentOutputVariable = TXpertParameter & {
     /**
-       * value write to state's variable
-       */
+     * value write to state's variable
+     */
     variableSelector: string;
     /**
      * How to write value to variable
      */
     operation: 'append' | 'extends' | 'overwrite' | 'clear';
 };
-/**
- * @deprecated use TChatRequest
- */
-export type TChatAgentParams = {
-    /**
-     * @deprecated use state instead
-     */
-    input?: {
-        input?: string;
-        [key: string]: unknown;
-    };
-    state: {
-        [STATE_VARIABLE_HUMAN]: TChatRequestHuman;
-        [key: string]: any;
-    };
-    agentKey: string;
-    xpertId: string;
-    executionId?: string;
-    environmentId?: string;
-    /**
-     */
-    command?: TInterruptCommand;
-    /**
-     * Reject the sensitive tool calls
-     */
-    reject?: boolean;
-};
 export declare function agentLabel(agent: Partial<IXpertAgent>): string;
 export declare function agentUniqueName(agent: IXpertAgent): string;
 export declare function convertToUrlPath(title: string): string;

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

@@ -0,0 +1,64 @@
+import { STATE_VARIABLE_HUMAN, TChatRequestHuman, TInterruptCommand } from '@xpert-ai/chatkit-types';
+export type TXpertChatState = {
+    [STATE_VARIABLE_HUMAN]?: TChatRequestHuman;
+} & Record<string, any>;
+export type TXpertChatResumeDecision = {
+    type: 'confirm' | 'reject';
+    payload?: unknown;
+};
+export type TXpertChatInterruptPatch = Pick<TInterruptCommand, 'agentKey' | 'toolCalls' | 'update'>;
+export type TXpertChatTarget = {
+    aiMessageId?: string;
+    executionId?: string;
+};
+export type TXpertChatSource = {
+    aiMessageId?: string;
+    executionId?: string;
+};
+export type TXpertChatSendRequest = {
+    action: 'send';
+    conversationId?: string;
+    projectId?: string;
+    environmentId?: string;
+    sandboxEnvironmentId?: string;
+    message: {
+        clientMessageId?: string;
+        input: TChatRequestHuman;
+    };
+    state?: TXpertChatState;
+};
+export type TXpertChatResumeRequest = {
+    action: 'resume';
+    conversationId: string;
+    target: TXpertChatTarget;
+    decision: TXpertChatResumeDecision;
+    patch?: TXpertChatInterruptPatch;
+    state?: TXpertChatState;
+};
+export type TXpertChatRetryRequest = {
+    action: 'retry';
+    conversationId: string;
+    source: TXpertChatSource;
+    environmentId?: string;
+};
+export type TChatRequest = TXpertChatSendRequest | TXpertChatResumeRequest | TXpertChatRetryRequest;
+export type TXpertAgentChatRunRequest = {
+    action: 'run';
+    state: TXpertChatState;
+    agentKey: string;
+    xpertId: string;
+    environmentId?: string;
+};
+export type TXpertAgentChatResumeRequest = {
+    action: 'resume';
+    agentKey: string;
+    xpertId: string;
+    target: {
+        executionId: string;
+    };
+    decision: TXpertChatResumeDecision;
+    patch?: TXpertChatInterruptPatch;
+    environmentId?: string;
+    state?: TXpertChatState;
+};
+export type TXpertAgentChatRequest = TXpertAgentChatRunRequest | TXpertAgentChatResumeRequest;

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

@@ -65,6 +65,9 @@ export interface IXpertProjectTaskLog extends IBasePerXpertProjectEntityModel {
     logType: 'input' | 'output' | 'error';
     content: string;
 }
+/**
+ * @deprecated use CodeXpert instead
+ */
 export interface IXpertProjectVCS extends IBasePerXpertProjectEntityModel {
     integrationId?: string;
     integration?: IIntegration;

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

@@ -475,7 +475,7 @@ export type TChatOptions = {
      */
     environment?: IEnvironment;
     /**
-     * PRO: Specify a sandbox environment container to run in
+     * Specify a sandbox environment container to run in
      */
     sandboxEnvironmentId?: string;
     /**
@@ -488,7 +488,7 @@ export type TChatOptions = {
  */
 export type TKBRetrievalSettings = {
     metadata: {
-        filtering_mode: "disabled" | "automatic" | "manual";
+        filtering_mode: 'disabled' | 'automatic' | 'manual';
         /**
          * Conditions (filter) when mode is manual
          */

package/src/plugin.d.ts

@@ -6,12 +6,27 @@ export declare const PLUGIN_LEVEL: {
     readonly SYSTEM: "system";
     readonly ORGANIZATION: "organization";
 };
+export declare const PLUGIN_SOURCE: {
+    readonly MARKETPLACE: "marketplace";
+    readonly LOCAL: "local";
+    readonly GIT: "git";
+    readonly URL: "url";
+    readonly NPM: "npm";
+    readonly CODE: "code";
+    readonly ENV: "env";
+};
+export declare const PLUGIN_CONFIGURATION_STATUS: {
+    readonly VALID: "valid";
+    readonly INVALID: "invalid";
+};
 /**
  * Classifies plugin scope and governance.
  * - `system`: built-in/platform-managed plugin that users cannot install/uninstall from org APIs.
  * - `organization`: tenant/org-managed plugin that can be installed and removed per organization.
  */
 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 interface PluginMeta {
     name: PluginName;
     version: string;
@@ -31,21 +46,33 @@ export interface IPlugin extends IBasePerTenantAndOrganizationEntityModel {
     pluginName: string;
     packageName: string;
     version?: string;
-    source?: 'marketplace' | 'local' | 'git' | 'url' | 'npm' | 'code' | 'env';
+    source?: PluginSource;
     level?: PluginLevel;
     config: Record<string, any>;
+    configurationStatus?: PluginConfigurationStatus | null;
+    configurationError?: string | null;
 }
 export interface IPluginDescriptor {
     organizationId?: string;
     name: PluginName;
     meta: PluginMeta;
+    packageName?: string;
+    source?: PluginSource;
+    currentVersion?: string;
+    latestVersion?: string;
     isGlobal: boolean;
     level: PluginLevel;
     canConfigure?: boolean;
+    canUpdate?: boolean;
+    hasUpdate?: boolean;
     configSchema?: JsonSchemaObjectType;
+    configurationStatus?: PluginConfigurationStatus | null;
+    configurationError?: string | null;
 }
 export interface IPluginConfiguration<TConfig extends Record<string, any> = Record<string, any>> {
     pluginName: PluginName;
     config: TConfig;
     configSchema?: JsonSchemaObjectType;
+    configurationStatus?: PluginConfigurationStatus | null;
+    configurationError?: string | null;
 }