@xpert-ai/plugin-sdk 3.10.0 → 3.11.2

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @xpert-ai/plugin-sdk
 
+## 3.11.2
+
+### Patch Changes
+
+- 7418eef: version
+
+## 4.0.0
+
+### Minor Changes
+
+- d92d0f2: upgrade zard ui
+
+### Patch Changes
+
+- Updated dependencies [d92d0f2]
+  - @xpert-ai/contracts@3.11.0
+
+## 3.11.0
+
+### Minor Changes
+
+- 49101da: release
+
+### Patch Changes
+
+- Updated dependencies [49101da]
+  - @xpert-ai/contracts@3.10.1
+
 ## 3.10.0
 
 ### Minor Changes

package/index.cjs.js

@@ -524,7 +524,7 @@ class BaseStrategyRegistry {
         var _this_strategies_get_get;
         const strategy = (_this_strategies_get_get = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.get(type)) != null ? _this_strategies_get_get : orgKey === GLOBAL_ORGANIZATION_SCOPE ? undefined : (_this_strategies_get1 = this.strategies.get(GLOBAL_ORGANIZATION_SCOPE)) == null ? void 0 : _this_strategies_get1.get(type);
         if (!strategy) {
-            throw new Error(`No strategy found for type ${type}`);
+            throw new Error(`No strategy found for type '${type}' for strategy '${this.strategyKey}'`);
         }
         return strategy;
     }
@@ -2678,6 +2678,10 @@ const KnowledgebaseRuntimeCapability = createRuntimeCapability('platform.knowled
     description: 'List, search, and write chunks in platform knowledgebases.'
 });
 
+const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.documents', {
+    description: 'Upload, import, create, process, inspect, and delete persistent knowledgebase documents.'
+});
+
 const AssistantTaskRuntimeCapability = createRuntimeCapability('platform.assistant_task', {
     description: 'Start asynchronous tasks on the current platform assistant.'
 });
@@ -4502,6 +4506,7 @@ exports.JUMP_TO_TARGETS = JUMP_TO_TARGETS;
 exports.JsonSchemaValidator = JsonSchemaValidator;
 exports.KNOWLEDGE_STRATEGY = KNOWLEDGE_STRATEGY;
 exports.KnowledgeStrategyKey = KnowledgeStrategyKey;
+exports.KnowledgebaseDocumentsRuntimeCapability = KnowledgebaseDocumentsRuntimeCapability;
 exports.KnowledgebaseRuntimeCapability = KnowledgebaseRuntimeCapability;
 exports.LLMUsage = LLMUsage;
 exports.LargeLanguageModel = LargeLanguageModel;

package/index.esm.js

@@ -503,7 +503,7 @@ class BaseStrategyRegistry {
         var _this_strategies_get_get;
         const strategy = (_this_strategies_get_get = (_this_strategies_get = this.strategies.get(orgKey)) == null ? void 0 : _this_strategies_get.get(type)) != null ? _this_strategies_get_get : orgKey === GLOBAL_ORGANIZATION_SCOPE ? undefined : (_this_strategies_get1 = this.strategies.get(GLOBAL_ORGANIZATION_SCOPE)) == null ? void 0 : _this_strategies_get1.get(type);
         if (!strategy) {
-            throw new Error(`No strategy found for type ${type}`);
+            throw new Error(`No strategy found for type '${type}' for strategy '${this.strategyKey}'`);
         }
         return strategy;
     }
@@ -2657,6 +2657,10 @@ const KnowledgebaseRuntimeCapability = createRuntimeCapability('platform.knowled
     description: 'List, search, and write chunks in platform knowledgebases.'
 });
 
+const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.documents', {
+    description: 'Upload, import, create, process, inspect, and delete persistent knowledgebase documents.'
+});
+
 const AssistantTaskRuntimeCapability = createRuntimeCapability('platform.assistant_task', {
     description: 'Start asynchronous tasks on the current platform assistant.'
 });
@@ -4416,4 +4420,4 @@ function escapeHtmlAttribute(value) {
 
 const VIEW_EXTENSION_CACHE_SERVICE_TOKEN = 'XPERT_PLUGIN_VIEW_EXTENSION_CACHE_SERVICE';
 
-export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultAgentMiddlewareRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, renderRemoteReactIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };
+export { ACCOUNT_BINDING_PERMISSION_SERVICE_TOKEN, AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, AssistantTaskRuntimeCapability, BOUND_IDENTITY_LOGIN_PERMISSION_SERVICE_TOKEN, BaseHTTPQueryRunner, BaseQueryRunner, BaseSQLQueryRunner, BaseSandbox, BaseStrategyRegistry, BaseTool, BaseToolset, BuiltinToolset, CHAT_CHANNEL, CHAT_CHANNEL_TEXT_LIMITS, CancelConversationCommand, ChatChannel, ChatChannelRegistry, ChatOAICompatReasoningModel, CommonParameterRules, CreateModelClientCommand, CredentialsValidateFailedError, DATASOURCE_STRATEGY, DBCreateTableMode, DBProtocolEnum, DBSyntaxEnum, DBTableAction, DBTableDataAction, DEFAULT_EXECUTION_CONFIG, DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS, DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC, DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS, DEFAULT_SANDBOX_SHELL_TIMEOUT_MS, DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DefaultAgentMiddlewareRuntimeCapabilityRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, FileRuntimeCapability, FileStorageProvider, FileStorageProviderRegistry, FileUploadTargetRegistry, FileUploadTargetStrategy, GLOBAL_ORGANIZATION_SCOPE, HANDOFF_PERMISSION_SERVICE_TOKEN, HANDOFF_PROCESSOR_STRATEGY, HANDOFF_QUEUE_SERVICE_TOKEN, HandoffProcessorRegistry, HandoffProcessorStrategy, IMAGE_UNDERSTANDING_STRATEGY, INTEGRATION_PERMISSION_SERVICE_TOKEN, INTEGRATION_STRATEGY, ImageUnderstandingRegistry, ImageUnderstandingStrategy, IntegrationStrategyKey, IntegrationStrategyRegistry, JUMP_TO_TARGETS, JsonSchemaValidator, KNOWLEDGE_STRATEGY, KnowledgeStrategyKey, KnowledgeStrategyRegistry, KnowledgebaseDocumentsRuntimeCapability, KnowledgebaseRuntimeCapability, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, PLUGIN_CONFIG_RESOLVER_TOKEN, PLUGIN_METADATA, PLUGIN_METADATA_KEY, PROVIDE_AI_MODEL_LLM, PROVIDE_AI_MODEL_MODERATION, PROVIDE_AI_MODEL_RERANK, PROVIDE_AI_MODEL_SPEECH2TEXT, PROVIDE_AI_MODEL_TEXT_EMBEDDING, PROVIDE_AI_MODEL_TTS, RETRIEVER_STRATEGY, RequestContext, RequestContextMiddleware, RequirePermissionOperation, RerankModel, RetrieverRegistry, RetrieverStrategy, SANDBOX_PROVIDER, SANDBOX_SHELL_TIMEOUT_LIMITS_SEC, SKILL_SOURCE_PROVIDER, SSOProviderRegistry, SSOProviderStrategyKey, SSO_BINDING_PERMISSION_SERVICE_TOKEN, SSO_PROVIDER, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, SkillSourceProviderRegistry, SkillSourceProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VIEW_EXTENSION_CACHE_SERVICE_TOKEN, VIEW_EXTENSION_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XPERT_RUNTIME_CAPABILITIES_TOKEN, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, createRuntimeCapability, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isSandboxManagedServiceAdapter, isSandboxServiceProxyAdapter, isSandboxTerminalAdapter, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, renderRemoteReactIframeHtml, resolveSandboxBackend, resolveSandboxExecutionOptions, resolveSandboxManagedServiceAdapter, resolveSandboxServiceProxyAdapter, resolveSandboxTerminalAdapter, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.10.0",
+  "version": "3.11.2",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -16,11 +16,11 @@
     "directory": "dist"
   },
   "dependencies": {
+    "@xpert-ai/contracts": "workspace:*",
     "js-tiktoken": "^1.0.21"
   },
   "peerDependencies": {
     "@langchain/core": "*",
-    "@xpert-ai/contracts": "workspace:*",
     "@xpert-ai/ocap-core": "workspace:*",
     "@nestjs/common": "*",
     "@nestjs/core": "*",

package/src/lib/agent/middleware/capabilities/index.d.ts

@@ -1,3 +1,4 @@
 export * from './knowledgebase';
+export * from './knowledgebase-documents';
 export * from './assistant-task';
 export * from './file';

package/src/lib/agent/middleware/capabilities/knowledgebase-documents.d.ts

@@ -0,0 +1,121 @@
+import { JSONValue } from '@xpert-ai/contracts';
+export type AgentMiddlewareKnowledgebaseDocumentFile = {
+    buffer: Buffer;
+    originalname?: string;
+    mimetype?: string;
+    size?: number;
+};
+export type AgentMiddlewareKnowledgebaseDocumentMetadata = Record<string, JSONValue>;
+export type AgentMiddlewareKnowledgebaseDocumentParserConfig = Record<string, JSONValue>;
+export type AgentMiddlewareKnowledgebaseDocumentDraft = {
+    id?: string;
+    name?: string;
+    type?: string;
+    category?: string;
+    sourceType?: string;
+    sourceConfig?: Record<string, JSONValue>;
+    filePath?: string;
+    fileUrl?: string;
+    mimeType?: string;
+    size?: string | number;
+    parentId?: string;
+    parserConfig?: AgentMiddlewareKnowledgebaseDocumentParserConfig;
+    metadata?: AgentMiddlewareKnowledgebaseDocumentMetadata;
+};
+export type AgentMiddlewareKnowledgebaseDocumentRecord = {
+    id: string;
+    name?: string;
+    type?: string;
+    category?: string | null;
+    sourceType?: string | null;
+    filePath?: string;
+    fileUrl?: string;
+    mimeType?: string;
+    size?: string | number;
+    status?: string | null;
+    progress?: number | null;
+    processMsg?: string | null;
+    knowledgebaseId?: string;
+    metadata?: AgentMiddlewareKnowledgebaseDocumentMetadata;
+};
+export type AgentMiddlewareKnowledgebaseUploadFileInput = {
+    knowledgebaseId: string;
+    file: AgentMiddlewareKnowledgebaseDocumentFile;
+    path?: string;
+    parentId?: string;
+};
+export type AgentMiddlewareKnowledgebaseUploadedFile = {
+    name: string;
+    filePath: string;
+    fileUrl: string;
+    mimeType?: string;
+    size?: number;
+    sourceHash?: string;
+};
+export type AgentMiddlewareKnowledgebaseCreateDocumentsInput = {
+    knowledgebaseId: string;
+    documents: AgentMiddlewareKnowledgebaseDocumentDraft[];
+    parserConfig?: AgentMiddlewareKnowledgebaseDocumentParserConfig;
+    metadata?: AgentMiddlewareKnowledgebaseDocumentMetadata;
+    process?: boolean;
+};
+export type AgentMiddlewareKnowledgebaseCreateDocumentsResult = {
+    documents: AgentMiddlewareKnowledgebaseDocumentRecord[];
+    processingStarted?: boolean;
+};
+export type AgentMiddlewareKnowledgebaseImportArchiveInput = {
+    knowledgebaseId: string;
+    file: AgentMiddlewareKnowledgebaseDocumentFile;
+    path?: string;
+    parentId?: string;
+    packageId?: string;
+    packageCode?: string;
+    parserConfig?: AgentMiddlewareKnowledgebaseDocumentParserConfig;
+    metadata?: AgentMiddlewareKnowledgebaseDocumentMetadata;
+    process?: boolean;
+    maxEntries?: number;
+    maxEntrySizeBytes?: number;
+    maxDepth?: number;
+    supportedExtensions?: string[];
+};
+export type AgentMiddlewareKnowledgebaseImportArchiveResult = {
+    archive: AgentMiddlewareKnowledgebaseUploadedFile;
+    documents: AgentMiddlewareKnowledgebaseDocumentRecord[];
+    skipped: Array<{
+        path: string;
+        reason: string;
+    }>;
+    warnings: string[];
+    processingStarted?: boolean;
+    unsupported?: boolean;
+};
+export type AgentMiddlewareKnowledgebaseStartProcessingInput = {
+    knowledgebaseId?: string;
+    documentIds: string[];
+};
+export type AgentMiddlewareKnowledgebaseDocumentStatusInput = {
+    knowledgebaseId?: string;
+    documentIds: string[];
+};
+export type AgentMiddlewareKnowledgebaseDocumentStatusResult = {
+    documents: AgentMiddlewareKnowledgebaseDocumentRecord[];
+};
+export type AgentMiddlewareKnowledgebaseDeleteDocumentsInput = {
+    knowledgebaseId?: string;
+    documentIds: string[];
+};
+export type AgentMiddlewareKnowledgebaseDeleteDocumentsResult = {
+    knowledgebaseId?: string;
+    documentIds: string[];
+    deletedDocumentCount: number;
+    missingDocumentIds?: string[];
+};
+export interface AgentMiddlewareKnowledgebaseDocumentsApi {
+    uploadFile(input: AgentMiddlewareKnowledgebaseUploadFileInput): Promise<AgentMiddlewareKnowledgebaseUploadedFile>;
+    importArchive(input: AgentMiddlewareKnowledgebaseImportArchiveInput): Promise<AgentMiddlewareKnowledgebaseImportArchiveResult>;
+    createDocuments(input: AgentMiddlewareKnowledgebaseCreateDocumentsInput): Promise<AgentMiddlewareKnowledgebaseCreateDocumentsResult>;
+    startProcessing(input: AgentMiddlewareKnowledgebaseStartProcessingInput): Promise<AgentMiddlewareKnowledgebaseDocumentStatusResult>;
+    getDocumentStatus(input: AgentMiddlewareKnowledgebaseDocumentStatusInput): Promise<AgentMiddlewareKnowledgebaseDocumentStatusResult>;
+    deleteDocuments(input: AgentMiddlewareKnowledgebaseDeleteDocumentsInput): Promise<AgentMiddlewareKnowledgebaseDeleteDocumentsResult>;
+}
+export declare const KnowledgebaseDocumentsRuntimeCapability: import("../runtime-capability").RuntimeCapabilityKey<AgentMiddlewareKnowledgebaseDocumentsApi>;

package/src/lib/agent/middleware/capabilities/knowledgebase.d.ts

@@ -21,6 +21,7 @@ export type AgentMiddlewareKnowledgebaseSearchInput = {
     requestId?: string;
 };
 export type AgentMiddlewareKnowledgebaseDocument = {
+    id?: string;
     pageContent: string;
     metadata?: Record<string, unknown>;
 };
@@ -62,9 +63,25 @@ export type AgentMiddlewareKnowledgebaseWriteChunkResult = {
     chunkId?: string;
     message?: string;
 };
+export type AgentMiddlewareKnowledgebaseDeleteChunksInput = {
+    xpertId: string;
+    agentKey: string;
+    knowledgebaseIds: string[];
+    knowledgebaseId: string;
+    writeKeys?: string[];
+    writeKeyPrefix?: string;
+};
+export type AgentMiddlewareKnowledgebaseDeleteChunksResult = {
+    deletedCount: number;
+    knowledgebaseId: string;
+    documentId?: string;
+    writeKeys?: string[];
+    writeKeyPrefix?: string;
+};
 export interface AgentMiddlewareKnowledgebaseApi {
     list(input: AgentMiddlewareKnowledgebaseListInput): Promise<AgentMiddlewareKnowledgebaseListItem[]>;
     search(input: AgentMiddlewareKnowledgebaseSearchInput): Promise<AgentMiddlewareKnowledgebaseDocument[]>;
     writeChunk(input: AgentMiddlewareKnowledgebaseWriteChunkInput): Promise<AgentMiddlewareKnowledgebaseWriteChunkResult>;
+    deleteChunks(input: AgentMiddlewareKnowledgebaseDeleteChunksInput): Promise<AgentMiddlewareKnowledgebaseDeleteChunksResult>;
 }
 export declare const KnowledgebaseRuntimeCapability: import("../runtime-capability").RuntimeCapabilityKey<AgentMiddlewareKnowledgebaseApi>;

package/src/lib/agent/middleware/strategy.interface.d.ts

@@ -1,6 +1,7 @@
 import { IWFNMiddleware, TAgentMiddlewareMeta, TXpertFeatures } from '@xpert-ai/contracts';
 import { StructuredToolInterface } from '@langchain/core/tools';
 import { RunnableToolLike } from '@langchain/core/runnables';
+import { BaseStore } from '@langchain/langgraph';
 import { AgentMiddleware } from './types';
 import { PromiseOrValue } from '../../types';
 import { AgentMiddlewareRuntimeApi } from './runtime';
@@ -15,6 +16,7 @@ export interface IAgentMiddlewareContext {
     xpertFeatures?: TXpertFeatures | null;
     agentKey?: string;
     knowledgebaseIds?: string[];
+    store?: BaseStore;
     node: IWFNMiddleware;
     tools: Map<string, StructuredToolInterface | RunnableToolLike>;
     runtime: AgentMiddlewareRuntimeApi;

package/src/lib/types.d.ts

@@ -1,4 +1,4 @@
-import { IconDefinition, JsonSchemaObjectType, PluginMeta, PluginTargetApp, PluginTargetAppMeta, TAvatar, XpertTypeEnum } from '@xpert-ai/contracts';
+import { IconDefinition, JsonSchemaObjectType, PluginMeta, PluginTargetApp, PluginTargetAppMeta, TAvatar, XpertTemplatePluginDependencies, XpertTypeEnum } from '@xpert-ai/contracts';
 import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
 import type { ZodSchema } from 'zod';
@@ -68,6 +68,7 @@ export interface XpertTemplateContribution {
     startPrompts?: string[];
     releaseNotes?: string;
     xpertName?: string;
+    dependencies?: XpertTemplatePluginDependencies;
     [key: string]: unknown;
 }
 export interface XpertTemplateProvider {

package/src/lib/workflow/node/strategy.interface.d.ts

@@ -1,6 +1,9 @@
-import { Runnable } from '@langchain/core/runnables';
+import { Runnable, RunnableToolLike } from '@langchain/core/runnables';
+import { DynamicStructuredTool, StructuredToolInterface } from '@langchain/core/tools';
+import { ToolInputSchemaBase } from '@langchain/core/dist/tools/types';
+import { InteropZodType } from '@langchain/core/utils/types';
 import { BaseChannel } from '@langchain/langgraph';
-import { IEnvironment, IWorkflowNode, TWorkflowNodeMeta, TXpertGraph, TWorkflowVarGroup, TXpertParameter, TXpertTeamNode } from '@xpert-ai/contracts';
+import { IEnvironment, IWorkflowNode, TWorkflowNodeMeta, TVariableAssigner, TXpertGraph, TWorkflowVarGroup, TXpertParameter, TXpertTeamNode } from '@xpert-ai/contracts';
 import { PromiseOrValue } from '../../types';
 export type TWorkflowNodeParams<TConfig = any> = {
     xpertId: string;
@@ -17,6 +20,14 @@ export type TWorkflowNodeResult = {
         annotation: BaseChannel;
     };
     navigator?: (state: any, config: any) => Promise<any>;
+    caller?: string;
+    toolset?: {
+        provider: string;
+        title: string;
+        id?: string;
+    };
+    tool?: DynamicStructuredTool<ToolInputSchemaBase, any, any> | StructuredToolInterface<ToolInputSchemaBase, any, any> | RunnableToolLike<InteropZodType, unknown>;
+    variables?: TVariableAssigner[];
 };
 /**
  * Workflow Node Strategy interface
@@ -37,6 +48,8 @@ export interface IWorkflowNodeStrategy<TConfig = any, TResult = any> {
         xpertId: string;
         environment: IEnvironment;
         isDraft: boolean;
+        leaderKey?: string;
+        conversationId?: string;
     }): PromiseOrValue<TWorkflowNodeResult>;
     inputVariables?(entity: IWorkflowNode, variables?: TWorkflowVarGroup[]): TXpertParameter[];
     outputVariables(entity: IWorkflowNode): TXpertParameter[];