@xpert-ai/contracts 3.10.0 → 3.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/contracts",
-  "version": "3.10.0",
+  "version": "3.10.1",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "dependencies": {
-    "@xpert-ai/chatkit-types": "~0.3.11"
+    "@xpert-ai/chatkit-types": "~0.3.12"
   },
   "types": "./index.d.ts"
 }

package/src/ai/knowledge-graph.model.d.ts

@@ -22,6 +22,7 @@ export type KnowledgeGraphItemOrigin = 'extracted' | 'manual' | 'curated';
 export type KnowledgeGraphVisibility = 'active' | 'hidden';
 export type GraphRagConfig = {
     enabled?: boolean;
+    mode?: GraphRagRetrievalMode;
     entityTopK?: number;
     neighborHops?: number;
     communityTopK?: number;

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

@@ -146,6 +146,10 @@ export type TXpertAgentOptions = {
      * Attachment config of agent
      */
     attachment?: TXpertAgentAttachment;
+    /**
+     * Built-in file understanding tools config of agent
+     */
+    fileUnderstanding?: TXpertAgentFileUnderstanding;
     /**
      * Config of middlewares for agent
      */
@@ -170,6 +174,12 @@ export type TXpertAgentAttachment = TXpertAgentVision & {
      */
     maxNum?: number;
 };
+export type TXpertAgentFileUnderstanding = {
+    /**
+     * Enable built-in tools for understanding conversation files. Default: true
+     */
+    enabled?: boolean;
+};
 export type TAgentPromptTemplate = {
     id: string;
     role: 'ai' | 'human';

package/src/plugin.d.ts

@@ -34,6 +34,47 @@ export type PluginConfigurationStatus = (typeof PLUGIN_CONFIGURATION_STATUS)[key
 export type PluginLoadStatus = (typeof PLUGIN_LOAD_STATUS)[keyof typeof PLUGIN_LOAD_STATUS];
 export type PluginScopeRelation = 'none' | 'overrides-global' | 'shadowed-by-organization';
 export type PluginTargetApp = 'xpert' | 'data-xpert' | (string & {});
+export type PluginSdkCompatibilityWarningCode = 'plugin-sdk-peer-dependency-missing' | 'plugin-sdk-peer-range-invalid' | 'plugin-sdk-peer-range-incompatible' | 'plugin-sdk-peer-range-spans-major';
+export type PluginMarketplaceContributionType = 'app' | 'view' | 'feature' | 'tool' | 'assistant-template' | (string & {});
+export type PluginMarketplaceOperationAccess = 'read' | 'write' | 'admin' | (string & {});
+export interface PluginMarketplaceOperation {
+    name: string;
+    displayName?: string | I18nObject;
+    description?: string | I18nObject;
+    access?: PluginMarketplaceOperationAccess;
+    tags?: string[];
+}
+export interface PluginMarketplaceContribution {
+    id?: string;
+    type: PluginMarketplaceContributionType;
+    name: string;
+    displayName?: string | I18nObject;
+    description?: string | I18nObject;
+    icon?: IconDefinition;
+    operations?: PluginMarketplaceOperation[];
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface PluginTargetAppMarketplaceMetadata {
+    contents?: PluginMarketplaceContribution[];
+    featured?: boolean;
+    screenshots?: string[];
+    readme?: string;
+    updatedAt?: string;
+}
+export interface PluginTargetAppRuntimeMetadata {
+    middlewareProviders?: string[];
+    viewProviders?: string[];
+    templateProviders?: string[];
+    [key: string]: unknown;
+}
+export interface PluginSdkCompatibilityWarning {
+    code: PluginSdkCompatibilityWarningCode;
+    packageName: PluginName;
+    hostVersion: string;
+    peerRange?: string | null;
+    message: string;
+}
 export interface PluginTargetAppMetadata {
     /**
      * App-owned classification values. Each target app owns the vocabulary for its own entry.
@@ -44,6 +85,8 @@ export interface PluginTargetAppMetadata {
      */
     minAppVersion?: string;
     capabilities?: string[];
+    marketplace?: PluginTargetAppMarketplaceMetadata;
+    runtime?: PluginTargetAppRuntimeMetadata;
     [key: string]: unknown;
 }
 export type PluginTargetAppMeta = Record<string, PluginTargetAppMetadata | undefined>;
@@ -134,6 +177,7 @@ export interface IPluginDescriptor {
     configSchema?: JsonSchemaObjectType;
     configurationStatus?: PluginConfigurationStatus | null;
     configurationError?: string | null;
+    sdkCompatibilityWarnings?: PluginSdkCompatibilityWarning[];
     loadStatus?: PluginLoadStatus | null;
     loadError?: string | null;
     effectiveInCurrentScope: boolean;

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

@@ -1,4 +1,4 @@
-import type { I18nObject } from '../types';
+import type { I18nObject, IconDefinition } from '../types';
 import type { JsonSchemaObjectType } from '../ai/types';
 export type XpertViewHostType = 'integration' | 'knowledgebase' | 'agent' | 'project' | 'sandbox' | string;
 export type XpertViewSlotMode = 'tabs' | 'sections' | 'widgets' | 'sidebar';
@@ -61,7 +61,7 @@ export interface XpertWorkbenchViewOptions {
         enabled?: boolean;
         label?: string | I18nObject;
         order?: number;
-        icon?: string;
+        icon?: IconDefinition;
     };
 }
 export interface XpertViewCachePolicy {
@@ -246,7 +246,7 @@ export interface XpertExtensionViewManifest {
     key: string;
     title: I18nObject;
     description?: I18nObject;
-    icon?: string;
+    icon?: IconDefinition;
     hostType: XpertViewHostType;
     slot: string;
     order?: number;