@metad/contracts 3.6.1 → 3.6.7

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@metad/contracts",
-  "version": "3.6.1",
+  "version": "3.6.7",
   "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xpert-ai/xpert.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xpert-ai/xpert/issues"
+  },
   "scripts": {
     "docs": "yarn typedoc --out ./.docs"
   },

package/src/agent/graph.ts

@@ -17,6 +17,9 @@ export const GRAPH_NODE_SUMMARIZE_CONVERSATION = 'summarize_conversation'
 export const GRAPH_NODE_TITLE_CONVERSATION = 'title_conversation'
 export const STATE_VARIABLE_FILES = 'files'
 export const STATE_VARIABLE_INPUT = 'input'
+export const STATE_SYS_VOLUME = 'volume'
+export const STATE_SYS_WORKSPACE_PATH = 'workspace_path'
+export const STATE_SYS_WORKSPACE_URL = 'workspace_url'
 export const STATE_VARIABLE_TITLE_CHANNEL = channelName('title')
 
 export type TMessageChannel = {

package/src/agent/variables.ts

@@ -1,4 +1,5 @@
-import { TWorkflowVarGroup } from "../ai";
+import { TWorkflowVarGroup } from "../ai/xpert-workflow.model"
+import { TXpertParameter, XpertParameterTypeEnum } from "../ai/xpert.model"
 
 /**
  * 
@@ -18,4 +19,48 @@ export function getVariableSchema(variables: TWorkflowVarGroup[], variable: stri
         group,
         variable: group?.variables.find((_) => _.name === (rest.join('.') || groupName))
     }
-}
+}
+
+export const FILE_VARIABLES: TXpertParameter[] = [
+    {
+        name: 'filePath',
+        type: XpertParameterTypeEnum.STRING,
+        description: {
+            en_US: 'The path to the file',
+            zh_Hans: '文件的路径'
+        },
+
+    },
+    {
+        name: 'fileName',
+        type: XpertParameterTypeEnum.STRING,
+        description: {
+            en_US: 'The name of the file',
+            zh_Hans: '文件的名称'
+        },
+    },
+    {
+        name: 'fileUrl',
+        type: XpertParameterTypeEnum.STRING,
+        description: {
+            en_US: 'The URL of the file',
+            zh_Hans: '文件的URL地址'
+        },
+    },
+    {
+        name: 'fileSize',
+        type: XpertParameterTypeEnum.NUMBER,
+        description: {
+            en_US: 'The size of the file in bytes',
+            zh_Hans: '文件的大小，单位为字节'
+        },
+    },
+    {
+        name: 'mimeType',
+        type: XpertParameterTypeEnum.STRING,
+        description: {
+            en_US: 'The MIME type of the file',
+            zh_Hans: '文件的MIME类型'
+        },
+    }
+]

package/src/ai/ai-model.model.ts

@@ -3,39 +3,40 @@ import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model'
 import { I18nObject } from '../types'
 import { ICopilot } from './copilot.model'
 
+
 export interface IAiModel extends IBasePerTenantAndOrganizationEntityModel {
   /**
-   * 模型名称
+   * Model name
    */
   name: string
 
   /**
-   * 模型展示名称
+   * Model display name
    */
   label: string
 
   /**
-   * 模型类型
+   * Model type
    */
   modelType: string
 
   /**
-   * 模型特性
+   * Model features
    */
   features: string[]
 
   /**
-   * 模型属性
+   * Model properties
    */
   modelProperties: Record<string, any>
 
   /**
-   * 参数规则
+   * Parameter rules
    */
   parameterRules: Record<string, any>[]
 
   /**
-   * 定价信息
+   * Pricing information
    */
   pricing: {
     input: string
@@ -45,7 +46,7 @@ export interface IAiModel extends IBasePerTenantAndOrganizationEntityModel {
   }
 
   /**
-   * 是否已废弃
+   * Deprecated
    */
   deprecated: boolean
 }
@@ -118,6 +119,7 @@ export interface CredentialFormSchema {
   options?: {
     label: I18nObject
     value: number | string | boolean
+    show_on?: FormShowOnObject[]
   }[]
   placeholder: I18nObject;
 
@@ -140,7 +142,9 @@ export enum ModelFeature {
   MULTI_TOOL_CALL = "multi-tool-call",
   AGENT_THOUGHT = "agent-thought",
   VISION = "vision",
-  STREAM_TOOL_CALL = "stream-tool-call"
+  STREAM_TOOL_CALL = "stream-tool-call",
+  VIDEO = "video",
+  STRUCTURED_OUTPUT = "structured-output"
 }
 
 export enum ModelPropertyKey {

package/src/ai/index.ts

@@ -23,6 +23,7 @@ export * from './xpert-agent.model'
 export * from './xpert-tool.model'
 export * from './xpert-toolset.model'
 export * from './xpert-workspace.model'
+export * from './xpert-table.model'
 export * from './xpert.model'
 export * from './xpert.utils'
 export * from './types'

package/src/ai/knowledge-doc-chunk.model.ts

@@ -34,6 +34,9 @@ export interface IDocChunkMetadata {
   score?: number
   relevanceScore?: number
 
+  // tokens
+  tokens?: number
+
   [key: string]: any
 }
 

package/src/ai/knowledge-doc.model.ts

@@ -3,11 +3,12 @@ import { IIntegration } from '../integration.model'
 import { IStorageFile } from '../storage-file.model'
 import { IKnowledgeDocumentPage } from './knowledge-doc-page.model'
 import { IKnowledgebaseTask } from './knowledgebase-task.model'
-import { IKnowledgebase } from './knowledgebase.model'
+import { IKnowledgebase, KBMetadataFieldDef } from './knowledgebase.model'
 import { TRagWebOptions } from './rag-web'
 import { IKnowledgeDocumentChunk } from './knowledge-doc-chunk.model'
 import { DocumentSourceProviderCategoryEnum } from './knowledge-pipeline'
 import { TCopilotModel } from './copilot-model.model'
+import { I18nObject } from '../types'
 
 
 export type DocumentParserConfig = {
@@ -193,7 +194,7 @@ export type TKnowledgeDocument = {
 /**
  * Document, include file, web pages, folder, virtual, etc.
  */
-export interface IKnowledgeDocument<T = Metadata> extends TKnowledgeDocument, IBasePerTenantAndOrganizationEntityModel {
+export interface IKnowledgeDocument<T extends KnowledgeDocumentMetadata = KnowledgeDocumentMetadata> extends TKnowledgeDocument, IBasePerTenantAndOrganizationEntityModel {
   parent?: IKnowledgeDocument | null
   children?: IKnowledgeDocument[]
   knowledgebase?: IKnowledgebase
@@ -203,16 +204,34 @@ export interface IKnowledgeDocument<T = Metadata> extends TKnowledgeDocument, IB
   metadata?: T
 }
 
-// export interface IDocumentChunk<Metadata = DocumentMetadata> {
-//   id: string
-//   pageContent: string
-//   metadata: Metadata & {
-//     knowledgeId?: string
-//   }
-//   collection_id: string
-// }
+/**
+ * System built-in standard document Metadata structure
+ */
+export interface StandardDocumentMetadata {
+  // ---- Document Info ----
+  originalFileName?: string;          // Original file name, e.g. "Complex_SQL_QA.markdown"
+  originalFileSize?: string | null;   // Original file size (if missing, display as "-")
+  uploadTime?: string;                // Upload time in ISO format
+  lastUpdatedTime?: string;           // Last updated time
+  source?: string;                    // Source, e.g. "Local File" / "Web Import" / "API"
+  
+  // ---- Technical Parameters ----
+  segmentRule?: string;               // Segmentation rule, e.g. "General"
+  segmentLength?: number;             // Maximum segment length (token or char)
+  averageSegmentLength?: string;      // Average segment length
+  segmentCount?: number;              // Number of segments
+  recallRate?: string;                // Recall count statistics, e.g. "0.00% (0/11)"
+  embedTime?: string;                 // Embedding time, e.g. "1.99 sec"
+  embedCost?: string | null;          // Embedding cost (if none, display as "-")
+  tokens?: number;                    // Number of tokens in the document
+}
+
+export interface KnowledgeDocumentMetadata extends StandardDocumentMetadata {
+  [key: string]: any
+}
+
 
-export type Metadata = any
+// export type Metadata = any
 
 export interface IKnowledgeDocumentCreateInput
 	extends IKnowledgeDocument, IBasePerTenantAndOrganizationEntityModel {}
@@ -249,4 +268,97 @@ export function classificateDocumentCategory(entity: Partial<IKnowledgeDocument>
 									isVideoType(entity.type) ? KBDocumentCategoryEnum.Video :
 									isAudioType(entity.type) ? KBDocumentCategoryEnum.Audio :
 									KBDocumentCategoryEnum.Text
-}
+}
+
+/**
+ * System standard Metadata field definition constants
+ * It can be used for rendering, validation, sorting, displaying descriptions, etc.
+ */
+export const STANDARD_METADATA_FIELDS: { group: I18nObject; fields: KBMetadataFieldDef[] }[] = [
+  // Document Info
+  {
+    group: {
+      en_US: 'Document Info',
+      zh_Hans: '文档信息'
+    },
+    fields: [
+      {
+        key: 'title',
+        label: { en_US: 'Original File Name', zh_Hans: '原始文件名称' },
+        type: 'string'
+      },
+      // {
+      //   key: 'originalFileSize',
+      //   label: { en_US: 'Original File Size', zh_Hans: '原始文件大小' },
+      //   type: 'string'
+      // },
+      // {
+      //   key: 'uploadTime',
+      //   label: { en_US: 'Upload Time', zh_Hans: '上传日期' },
+      //   type: 'datetime'
+      // },
+      // {
+      //   key: 'lastUpdatedTime',
+      //   label: { en_US: 'Last Updated Time', zh_Hans: '最后更新时间' },
+      //   type: 'datetime'
+      // },
+      // {
+      //   key: 'source',
+      //   label: { en_US: 'Source', zh_Hans: '来源' },
+      //   type: 'string'
+      // }
+    ]
+  },
+  // Technical Parameters
+  {
+    group: {
+      en_US: 'Technical Parameters',
+      zh_Hans: '技术参数'
+    },
+    fields: [
+       {
+        key: 'tokens',
+        label: { en_US: 'Tokens', zh_Hans: '词元' },
+        type: 'number'
+      },
+      // {
+      //   key: 'segmentRule',
+      //   label: { en_US: 'Segmentation Rule', zh_Hans: '分段规则' },
+      //   type: 'string'
+      // },
+  //     {
+  //       key: 'segmentLength',
+  //       label: { en_US: 'Segment Length', zh_Hans: '段落长度' },
+  //       type: 'number'
+  //     },
+  //     {
+  //       key: 'averageSegmentLength',
+  //       label: { en_US: 'Average Segment Length', zh_Hans: '平均段落长度' },
+  //       type: 'string'
+  //     },
+  //     {
+  //       key: 'segmentCount',
+  //       label: { en_US: 'Segment Count', zh_Hans: '段落数量' },
+  //       type: 'number'
+  //     },
+  //     {
+  //       key: 'recallRate',
+  //       label: { en_US: 'Recall Count', zh_Hans: '召回次数' },
+  //       type: 'string'
+  //     },
+  //     {
+  //       key: 'embedTime',
+  //       label: { en_US: 'Embedding Time', zh_Hans: '嵌入时间' },
+  //       type: 'string'
+  //     },
+  //     {
+  //       key: 'embedCost',
+  //       label: { en_US: 'Embedding Cost', zh_Hans: '嵌入花费' },
+  //       type: 'string'
+  //     }
+    ]
+  }
+] as const;
+
+
+export type StandardMetadataFieldKey = typeof STANDARD_METADATA_FIELDS[number]['fields'][number]['key'];

package/src/ai/knowledgebase.model.ts

@@ -1,5 +1,5 @@
 import { ICopilotModel } from './copilot-model.model'
-import { TAvatar } from '../types'
+import { I18nObject, TAvatar } from '../types'
 import { IBasePerWorkspaceEntityModel } from './xpert-workspace.model'
 import { IKnowledgeDocument } from './knowledge-doc.model'
 import { IXpert } from './xpert.model'
@@ -107,6 +107,11 @@ export type TKnowledgebase = {
   recall?: TKBRecallParams
 
   status?: string
+  
+  /**
+   * Metadata custom field definition array
+   */
+	metadataSchema?: KBMetadataFieldDef[]
 
   /**
    * API service enabled
@@ -172,6 +177,16 @@ export type DocumentMetadata = IDocChunkMetadata & {
     relevanceScore?: number
 } & Record<string, any>;
 
+export type MetadataFieldType =
+  | 'string' | 'number' | 'boolean' | 'enum' | 'datetime' | 'string[]' | 'number[]' | 'object';
+
+export type KBMetadataFieldDef = {
+  key: string;                // Unique key, e.g. "department"
+  label?: I18nObject;             // Display label
+  type: MetadataFieldType;
+  enumValues?: string[];
+  description?: string;
+}
 
 /**
  * Channel name for knowledgebase pipeline

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

@@ -166,7 +166,13 @@ export type TXpertAgentOptions = {
    */
   vision?: {
     enabled?: boolean
+    /**
+     * Variable name that store the list of files to be understood
+     */
     variable?: string
+    /**
+     * Image resolution for vision tasks
+     */
     resolution?: 'high' | 'low'
   }
 }

package/src/ai/xpert-table.model.ts

@@ -0,0 +1,100 @@
+import { letterStartSUID } from '../types'
+import { IWorkflowNode, WorkflowNodeTypeEnum } from './xpert-workflow.model'
+import { IBasePerWorkspaceEntityModel } from './xpert-workspace.model'
+
+/**
+ * 表状态：符合我们前面讨论的多状态流程
+ */
+export enum XpertTableStatus {
+  DRAFT = 'draft',
+  READY = 'ready',
+  PENDING_ACTIVATION = 'pendingActivation',
+  ACTIVE = 'active',
+  NEEDS_MIGRATION = 'needsMigration',
+  DEPRECATED = 'deprecated',
+  ERROR = 'error'
+}
+
+/**
+ * Custom Table for Xpert
+ */
+export interface IXpertTable extends IBasePerWorkspaceEntityModel, TXpertTable {}
+
+export type TXpertTable = {
+  name: string // 逻辑表名（用户侧看到的名称，如 "customer_orders"）
+  description?: string
+  database?: string
+  schema?: string
+  columns?: TXpertTableColumn[]
+  status: XpertTableStatus
+  version?: number
+  activatedAt?: Date
+  message?: string
+}
+
+export type TXpertTableColumn = {
+  name: string
+  type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json'
+  label?: string
+  required?: boolean
+}
+
+
+// ===============================
+// 📦 Database Operation Nodes
+// ===============================
+
+export interface IWorkflowNodeDBOperation extends IWorkflowNode {
+  tableId: string
+}
+
+export interface IWFNDBInsert extends IWorkflowNodeDBOperation {
+  type: WorkflowNodeTypeEnum.DB_INSERT,
+  columns?: Record<string, {
+    type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json';
+    value?: any
+    valueSelector?: string
+  }>
+}
+
+export function genXpertDBInsertKey() {
+  return letterStartSUID('DBInsert_')
+}
+
+export interface IWFNDBUpdate extends IWorkflowNodeDBOperation {
+  type: WorkflowNodeTypeEnum.DB_UPDATE
+  columns?: Record<string, {
+    type: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json';
+    value?: any
+    valueSelector?: string
+  }>
+}
+
+export function genXpertDBUpdateKey() {
+  return letterStartSUID('DBUpdate_')
+}
+
+export interface IWFNDBDelete extends IWorkflowNodeDBOperation {
+  type: WorkflowNodeTypeEnum.DB_DELETE,
+}
+
+export function genXpertDBDeleteKey() {
+  return letterStartSUID('DBDelete_')
+}
+
+export interface IWFNDBQuery extends IWorkflowNodeDBOperation {
+  type: WorkflowNodeTypeEnum.DB_QUERY,
+}
+
+export function genXpertDBQueryKey() {
+  return letterStartSUID('DBQuery_')
+}
+
+export interface IWFNDBSql extends IWorkflowNodeDBOperation {
+  type: WorkflowNodeTypeEnum.DB_SQL
+  sqlTemplate?: string
+}
+
+export function genXpertDBSqlKey() {
+  return letterStartSUID('DBSql_')
+}

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

@@ -56,6 +56,11 @@ export type TMCPServer = {
   url?: string,
   headers?: Record<string, string>
   useNodeEventSource?: boolean
+  /**
+   * Default timeout in milliseconds for tool execution. Must be greater than 0.
+   * If not specified, tools will use their own configured timeout values.
+   */
+  defaultToolTimeout?: number
 
   files?: {name: string; content: string}[]
 

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

@@ -1,3 +1,4 @@
+import type { JSONSchema4 } from "json-schema";
 import { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model'
 import { I18nObject } from '../types'
 import { AiProviderRole } from './copilot.model'
@@ -111,8 +112,12 @@ export interface ApiToolBundle {
   summary?: string;
   // operation_id
   operation_id?: string;
-  // parameters
+  /**
+   * parameters
+   * @deprecated use schema
+   */
   parameters?: TToolParameter[];
+  schema?: JSONSchema4
   // author
   author: string;
   // icon

package/src/ai/xpert-workflow.model.ts

@@ -2,7 +2,7 @@ import { I18nObject, IconDefinition, letterStartSUID } from "../types"
 import { ICopilotModel } from "./copilot-model.model"
 import { TKBRecallParams } from "./knowledgebase.model"
 import { ApiAuthType, TErrorHandling, TXpertRefParameter } from "./types"
-import { TStateVariable, TXpertParameter } from "./xpert.model"
+import { TKBRetrievalSettings, TStateVariable, TXpertParameter } from "./xpert.model"
 
 export type TWorkflowNodeMeta = {
   name: string
@@ -28,15 +28,9 @@ export enum WorkflowNodeTypeEnum {
   IF_ELSE = 'if-else',
   LIST_OPERATOR = 'list-operator',
   VARIABLE_AGGREGATOR = 'variable-aggregator',
-  // SPLITTER = 'splitter',
   ITERATING = 'iterating',
-  ANSWER = 'answer',
-  CODE = 'code',
   HTTP = 'http',
-  KNOWLEDGE = 'knowledge',
   SUBFLOW = 'subflow',
-  TEMPLATE = 'template',
-  CLASSIFIER = 'classifier',
   TOOL = 'tool',
   AGENT_TOOL = 'agent-tool',
   NOTE = 'note',
@@ -51,6 +45,47 @@ export enum WorkflowNodeTypeEnum {
   CHUNKER = 'chunker',
   UNDERSTANDING = 'understanding',
   KNOWLEDGE_BASE = 'knowledgebase',
+
+  // ===============================
+  // 📦 Transform Nodes
+  // ===============================
+  CLASSIFIER = 'classifier',
+  KNOWLEDGE = 'knowledge',
+  CODE = 'code',
+  TEMPLATE = 'template',
+  ANSWER = 'answer',
+  JSON_STRINGIFY = 'json-stringify',
+  JSON_PARSE = 'json-parse',
+
+  // ===============================
+  // 📦 Database Operation Nodes
+  // ===============================
+
+  /**
+   * Custom SQL
+   */
+  DB_SQL = 'db-sql',
+
+  /**
+   * Insert data (INSERT)
+   */
+  DB_INSERT = 'db-insert',
+
+  /**
+   * Update data (UPDATE)
+   */
+  DB_UPDATE = 'db-update',
+
+  /**
+   * Delete data (DELETE)
+   */
+  DB_DELETE = 'db-delete',
+
+  /**
+   * Query data (SELECT)
+   */
+  DB_QUERY = 'db-query',
+  
 }
 
 export interface IWorkflowNode {
@@ -312,6 +347,7 @@ export interface IWFNKnowledgeRetrieval extends IWorkflowNode {
   queryVariable: string
   knowledgebases: string[]
   recall?: TKBRecallParams
+  retrieval?: TKBRetrievalSettings
 }
 
 export interface IWFNSubflow extends IWorkflowNode {
@@ -416,6 +452,16 @@ export interface IWFNTask extends IWorkflowNode {
   descriptionSuffix?: string
 }
 
+export interface IWFNJSONStringify extends IWorkflowNode {
+  type: WorkflowNodeTypeEnum.JSON_STRINGIFY
+  inputVariable: string
+}
+
+export interface IWFNJSONParse extends IWorkflowNode {
+  type: WorkflowNodeTypeEnum.JSON_PARSE
+  inputVariable: string
+}
+
 export function genXpertTriggerKey() {
   return letterStartSUID('Trigger_')
 }
@@ -428,6 +474,13 @@ export function genVariableAggregatorKey() {
   return letterStartSUID('VariableAggregator_')
 }
 
+export function genJSONStringifyKey() {
+  return letterStartSUID('JSONStringify_')
+}
+export function genJSONParseKey() {
+  return letterStartSUID('JSONParse_')
+}
+
 export function isAgentKey(key: string) {
   return key?.toLowerCase().startsWith('agent_')
 }

package/src/ai/xpert.model.ts

@@ -11,10 +11,10 @@ import { IXpertToolset } from './xpert-toolset.model'
 import { IBasePerWorkspaceEntityModel } from './xpert-workspace.model'
 import { IIntegration } from '../integration.model'
 import { TChatFrom, TSensitiveOperation } from './chat.model'
-import { IWorkflowNode, TVariableAssigner, VariableOperationEnum } from './xpert-workflow.model'
+import { IWorkflowNode, TVariableAssigner, TWFCase, VariableOperationEnum } from './xpert-workflow.model'
 import { IEnvironment } from './environment.model'
 import { IStorageFile } from '../storage-file.model'
-import { STATE_VARIABLE_HUMAN, TInterruptCommand } from '../agent'
+import { STATE_VARIABLE_HUMAN, TInterruptCommand } from '../agent/graph'
 
 export type ToolCall = LToolCall
 
@@ -289,10 +289,15 @@ export type TXpertAgentConfig = {
   mute?: string[][]
 
   /**
-   * Recall params
+   * Recall knowledge params
    */
   recalls?: Record<string, TKBRecallParams>
 
+  /**
+   * Retrieval params for every knowledgebase
+   */
+  retrievals?: Record<string, TKBRetrievalSettings>
+
   /**
    * Summarize the title of the conversation
    */
@@ -390,7 +395,9 @@ export enum XpertParameterTypeEnum {
   NUMBER = 'number',
   OBJECT = 'object',
   SELECT = 'select',
+  FILE = 'file',
   ARRAY_STRING = 'array[string]',
+  ARRAY_NUMBER = 'array[number]',
   ARRAY = 'array[object]',
   ARRAY_FILE = 'array[file]',
   ARRAY_DOCUMENT = 'array[document]',
@@ -611,3 +618,20 @@ export type TChatOptions = {
    */
   tools?: (StructuredToolInterface | RunnableToolLike)[]
 }
+
+/**
+ * Knowledgebase retrieval settings
+ */
+export type TKBRetrievalSettings = {
+  metadata: {
+    filtering_mode: "disabled" | "automatic" | "manual"
+    /**
+     * Conditions (filter) when mode is manual
+     */
+    filtering_conditions: TWFCase
+    /**
+     * Parameter fields (tool call) when mode is automatic
+     */
+    fields: Record<string, object>
+  }
+}

package/src/analytics/data-source.ts

@@ -58,7 +58,7 @@ export interface IColumnDef {
   /**
    * Types in javascript
    */
-  type: 'number' | 'string' | 'boolean'
+  type: 'number' | 'string' | 'boolean' | 'object' | 'timestamp'
   /**
    * Original data type in database
    */

package/src/analytics/gateway.ts

@@ -4,6 +4,7 @@ export type TGatewayQueryEvent = {
   id: string
   organizationId: string
   dataSourceId: string
+  tenantId?: string
   modelId?: string
   isDraft: boolean
   body: {

package/src/analytics/indicator.ts

@@ -58,6 +58,27 @@ export type TIndicator = {
   businessAreaId?: string
 }
 
+/**
+ * Fields included in the draft of Indicator, please keep it in sync with TIndicator type
+ */
+export const IndicatorDraftFields: Array<keyof IIndicator> = [
+  "code",
+  "name",
+  "type",
+  "visible",
+  "isApplication",
+  "modelId",
+  "entity",
+  "unit",
+  "principal",
+  "authentication",
+  "certificationId",
+  "validity",
+  "business",
+  "options",
+  "businessAreaId"
+]
+
 export type TIndicatorDraft = TIndicator & {
   checklist?: ChecklistItem[]
   version?: number
@@ -66,12 +87,6 @@ export type TIndicatorDraft = TIndicator & {
 
 export interface IIndicator extends IBasePerProjectEntityModel, TIndicator {
   draft?: TIndicatorDraft
-  /**
-   * Is active: Activate / Deactivate
-   * 
-   * @deprecated use status instead
-   */
-  isActive?: boolean
   
   /**
    * Visibilty in public or secret or private
@@ -87,6 +102,7 @@ export interface IIndicator extends IBasePerProjectEntityModel, TIndicator {
   status?: IndicatorStatusEnum
   embeddingStatus?: EmbeddingStatusEnum
   error?: string
+  publishedAt?: Date
   
   businessArea?: IBusinessArea
 

package/src/analytics/semantic-model-entity.ts

@@ -27,6 +27,7 @@ export type SemanticModelEntityJob = {
   error?: string
   createdAt?: Date
   endAt?: Date
+  tokens?: number
 }
 
 export interface ISemanticModelEntity extends IBasePerTenantAndOrganizationEntityModel {

package/src/analytics/semantic-model-member.ts

@@ -36,6 +36,10 @@ export interface ISemanticModelMember extends IBasePerTenantAndOrganizationEntit
 
   parentUniqueName: string
 
+  metadata?: {
+    tokens: number
+  }
+
   // Has Vector
   vector?: boolean
 }

package/src/analytics/semantic-model.ts

@@ -194,6 +194,16 @@ export enum SemanticModelStatusEnum {
   Archived = 'archived'
 }
 
+export interface ISemanticModelCache extends IBasePerTenantAndOrganizationEntityModel {
+  key: string
+  language?: string
+  modelId?: string
+  model?: ISemanticModel
+  query?: string
+  data?: string
+}
+
+
 /**
  * @deprecated Equivalent to `VirtualCube` in the ocap framework
  */

package/src/plugin.ts

@@ -6,7 +6,7 @@ export interface PluginMeta {
   name: PluginName
   version: string
   icon?: IconDefinition
-  category: 'set' | 'doc-source' | 'agent' | 'tools' | 'model' | 'vlm' | 'vector-store' | 'integration'
+  category: 'set' | 'doc-source' | 'agent' | 'tools' | 'model' | 'vlm' | 'vector-store' | 'integration' | 'datasource' | 'database'
   displayName: string
   description: string
   keywords?: string[]