@xpert-ai/plugin-sdk 3.8.1 → 3.8.4

package/index.esm.js

@@ -936,6 +936,8 @@ BuiltinToolset.provider = '';
     }
 }
 
+const PLUGIN_CONFIG_RESOLVER_TOKEN = 'XPERT_PLUGIN_CONFIG_RESOLVER';
+
 /**
  * System token for resolving integration read service from plugin context.
  */ const INTEGRATION_PERMISSION_SERVICE_TOKEN = 'XPERT_PLUGIN_INTEGRATION_PERMISSION_SERVICE';
@@ -1989,11 +1991,11 @@ class LLMUsage {
     }
     plus(other) {
         /**
-		 * Add two LLMUsage instances together.
-		 *
-		 * @param other: Another LLMUsage instance to add
-		 * @return: A new LLMUsage instance with summed values
-		 */ if (this.totalTokens === 0) {
+     * Add two LLMUsage instances together.
+     *
+     * @param other: Another LLMUsage instance to add
+     * @return: A new LLMUsage instance with summed values
+     */ if (this.totalTokens === 0) {
             return other;
         } else {
             return new LLMUsage(this.promptTokens + other.promptTokens, other.promptUnitPrice, other.promptPriceUnit, this.promptPrice + other.promptPrice, this.completionTokens + other.completionTokens, other.completionUnitPrice, other.completionPriceUnit, this.completionPrice + other.completionPrice, this.totalTokens + other.totalTokens, this.totalPrice + other.totalPrice, other.currency, this.latency + other.latency);
@@ -2001,11 +2003,11 @@ class LLMUsage {
     }
     add(other) {
         /**
-		 * Overload the + operator to add two LLMUsage instances.
-		 *
-		 * @param other: Another LLMUsage instance to add
-		 * @return: A new LLMUsage instance with summed values
-		 */ return this.plus(other);
+     * Overload the + operator to add two LLMUsage instances.
+     *
+     * @param other: Another LLMUsage instance to add
+     * @return: A new LLMUsage instance with summed values
+     */ return this.plus(other);
     }
     constructor(promptTokens, promptUnitPrice, promptPriceUnit, promptPrice, completionTokens, completionUnitPrice, completionPriceUnit, completionPrice, totalTokens, totalPrice, currency, latency){
         this.promptTokens = promptTokens;
@@ -2125,6 +2127,78 @@ class LargeLanguageModel extends AIModel {
             }
         };
     }
+    createHandleVerboseCallbacks(enabled, logger) {
+        if (!enabled) {
+            return [];
+        }
+        const targetLogger = logger != null ? logger : _class_private_field_loose_base(this, _logger)[_logger];
+        return [
+            {
+                handleChatModelStart: (llm, messages, runId, parentRunId, extraParams, tags, metadata, runName)=>{
+                    targetLogger.verbose(this.formatVerboseLog('chat_model/start', {
+                        runId,
+                        parentRunId,
+                        runName,
+                        model: llm,
+                        messages,
+                        extraParams,
+                        tags,
+                        metadata
+                    }));
+                },
+                handleLLMStart: (llm, prompts, runId, parentRunId, extraParams, tags, metadata, runName)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/start', {
+                        runId,
+                        parentRunId,
+                        runName,
+                        model: llm,
+                        prompts,
+                        extraParams,
+                        tags,
+                        metadata
+                    }));
+                },
+                handleLLMEnd: (output, runId, parentRunId, tags, extraParams)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/end', {
+                        runId,
+                        parentRunId,
+                        output,
+                        tags,
+                        extraParams
+                    }));
+                },
+                handleLLMError: (err, runId, parentRunId, tags, extraParams)=>{
+                    targetLogger.verbose(this.formatVerboseLog('llm/error', {
+                        runId,
+                        parentRunId,
+                        error: this.formatError(err),
+                        tags,
+                        extraParams
+                    }));
+                }
+            }
+        ];
+    }
+    formatVerboseLog(event, payload) {
+        return `[langchain][${event}] ${this.stringifyLogPayload(payload)}`;
+    }
+    stringifyLogPayload(payload) {
+        try {
+            return JSON.stringify(payload, null, 2);
+        } catch (error) {
+            return `[unserializable payload: ${this.formatError(error)}]`;
+        }
+    }
+    formatError(error) {
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                message: error.message,
+                stack: error.stack
+            };
+        }
+        return error;
+    }
     constructor(...args){
         super(...args);
         Object.defineProperty(this, _logger, {
@@ -2615,34 +2689,100 @@ class CancelConversationCommand {
 }
 CancelConversationCommand.type = '[Chat Conversation] Cancel';
 
+const FILE_STORAGE_PROVIDER = 'FILE_STORAGE_PROVIDER';
+const FileStorageProvider = (provider)=>applyDecorators(SetMetadata(FILE_STORAGE_PROVIDER, provider), SetMetadata(STRATEGY_META_KEY, FILE_STORAGE_PROVIDER));
+
+let FileStorageProviderRegistry = class FileStorageProviderRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(FILE_STORAGE_PROVIDER, discoveryService, reflector);
+    }
+};
+FileStorageProviderRegistry = __decorate([
+    Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
+        typeof Reflector === "undefined" ? Object : Reflector
+    ])
+], FileStorageProviderRegistry);
+
+const FILE_UPLOAD_TARGET_STRATEGY = 'FILE_UPLOAD_TARGET_STRATEGY';
+const FileUploadTargetStrategy = (type)=>applyDecorators(SetMetadata(FILE_UPLOAD_TARGET_STRATEGY, type), SetMetadata(STRATEGY_META_KEY, FILE_UPLOAD_TARGET_STRATEGY));
+
+let FileUploadTargetRegistry = class FileUploadTargetRegistry extends BaseStrategyRegistry {
+    constructor(discoveryService, reflector){
+        super(FILE_UPLOAD_TARGET_STRATEGY, discoveryService, reflector);
+    }
+};
+FileUploadTargetRegistry = __decorate([
+    Injectable(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [
+        typeof DiscoveryService === "undefined" ? Object : DiscoveryService,
+        typeof Reflector === "undefined" ? Object : Reflector
+    ])
+], FileUploadTargetRegistry);
+
+const SANDBOX_SHELL_TIMEOUT_LIMITS_SEC = {
+    min: 1,
+    max: 3600
+};
+const DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC = 600;
+const DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC = 120;
+const DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC = 120;
+const DEFAULT_SANDBOX_SHELL_TIMEOUT_MS = DEFAULT_SANDBOX_SHELL_TIMEOUT_SEC * 1000;
+const DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS = DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_SEC * 1000;
+const DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS = DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_SEC * 1000;
+const DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES = 1024 * 1024;
+const DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS = {
+    timeoutMs: DEFAULT_SANDBOX_SHELL_TIMEOUT_MS,
+    maxOutputBytes: DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES
+};
+const DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS = {
+    timeoutMs: DEFAULT_SANDBOX_FILE_SEARCH_TIMEOUT_MS,
+    maxOutputBytes: DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES
+};
+const DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS = {
+    timeoutMs: DEFAULT_SANDBOX_FILE_OPERATION_TIMEOUT_MS,
+    maxOutputBytes: DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES
+};
+function secondsToMilliseconds(seconds) {
+    return Math.trunc(seconds * 1000);
+}
+function formatSandboxTimeout(timeoutMs) {
+    const timeoutSeconds = timeoutMs / 1000;
+    const secondsLabel = Number.isInteger(timeoutSeconds) ? String(timeoutSeconds) : Number(timeoutSeconds.toFixed(3)).toString();
+    return `${secondsLabel}s (${timeoutMs}ms)`;
+}
+function buildSandboxTimeoutMessage(subject, timeoutMs) {
+    return `${subject} timed out after ${formatSandboxTimeout(timeoutMs)}`;
+}
+function appendSandboxMessage(output, message) {
+    return output ? `${output}\n${message}` : message;
+}
+function resolveSandboxExecutionOptions(options, defaults = DEFAULT_SANDBOX_SHELL_EXECUTION_OPTIONS) {
+    const timeoutMs = typeof (options == null ? void 0 : options.timeoutMs) === 'number' && Number.isFinite(options.timeoutMs) && options.timeoutMs > 0 ? Math.trunc(options.timeoutMs) : typeof defaults.timeoutMs === 'number' && Number.isFinite(defaults.timeoutMs) && defaults.timeoutMs > 0 ? Math.trunc(defaults.timeoutMs) : DEFAULT_SANDBOX_SHELL_TIMEOUT_MS;
+    const maxOutputBytes = typeof (options == null ? void 0 : options.maxOutputBytes) === 'number' && Number.isFinite(options.maxOutputBytes) && options.maxOutputBytes > 0 ? Math.trunc(options.maxOutputBytes) : typeof defaults.maxOutputBytes === 'number' && Number.isFinite(defaults.maxOutputBytes) && defaults.maxOutputBytes > 0 ? Math.trunc(defaults.maxOutputBytes) : DEFAULT_SANDBOX_EXECUTION_MAX_OUTPUT_BYTES;
+    return {
+        timeoutMs,
+        maxOutputBytes
+    };
+}
+
 /**
- * Protocol definition for pluggable memory backends.
- *
- * This module defines the BackendProtocol that all backend implementations
- * must follow. Backends can store files in different locations (state, filesystem,
- * database, etc.) and provide a uniform interface for file operations.
- */ /**
  * Type guard to check if a backend supports execution.
  *
  * @param backend - Backend instance to check
  * @returns True if the backend implements SandboxBackendProtocol
  */ function isSandboxBackend(backend) {
-    return typeof backend.execute === "function" && typeof backend.id === "string";
+    return typeof backend.execute === 'function' && typeof backend.id === 'string';
 }
 
-/**
- * BaseSandbox: Abstract base class for sandbox backends with command execution.
- *
- * This class provides default implementations for all SandboxBackendProtocol
- * methods using shell commands executed via execute(). Concrete implementations
- * only need to implement the execute() method.
- *
- * Requires Node.js 20+ on the sandbox host.
- */ const MAX_LINE_LENGTH = 500;
+const MAX_LINE_LENGTH = 500;
 const MAX_GREP_LINE_LENGTH = 2000;
 const GREP_RESULT_LIMIT = 100;
 const GLOB_RESULT_LIMIT = 100;
-const WRITE_EXISTS_OUTPUT = "Error: File already exists";
+const WRITE_EXISTS_OUTPUT = 'Error: File already exists';
 /**
  * UTF-8 safe Base64 encoding function.
  * Replaces btoa() which only supports Latin1 characters.
@@ -2656,17 +2796,17 @@ const WRITE_EXISTS_OUTPUT = "Error: File already exists";
     const truncated = files.length > limit;
     const finalFiles = truncated ? files.slice(0, limit) : files;
     if (finalFiles.length === 0) {
-        return "No files found";
+        return 'No files found';
     }
     const lines = [];
     for (const file of finalFiles){
         lines.push(file.path);
     }
     if (truncated) {
-        lines.push("");
-        lines.push("(Results truncated. Consider using a more specific path or pattern.)");
+        lines.push('');
+        lines.push('(Results truncated. Consider using a more specific path or pattern.)');
     }
-    return lines.join("\n");
+    return lines.join('\n');
 }
 /**
  * Format grep matches into human-readable output grouped by file.
@@ -2675,28 +2815,28 @@ const WRITE_EXISTS_OUTPUT = "Error: File already exists";
     const truncated = matches.length > limit;
     const finalMatches = truncated ? matches.slice(0, limit) : matches;
     if (finalMatches.length === 0) {
-        return "No matches found";
+        return 'No matches found';
     }
     const lines = [
         `Found ${finalMatches.length} matches`
     ];
-    let currentFile = "";
+    let currentFile = '';
     for (const match of finalMatches){
         if (currentFile !== match.path) {
-            if (currentFile !== "") {
-                lines.push("");
+            if (currentFile !== '') {
+                lines.push('');
             }
             currentFile = match.path;
             lines.push(`${match.path}:`);
         }
-        const text = match.text.length > MAX_GREP_LINE_LENGTH ? match.text.substring(0, MAX_GREP_LINE_LENGTH) + "..." : match.text;
+        const text = match.text.length > MAX_GREP_LINE_LENGTH ? match.text.substring(0, MAX_GREP_LINE_LENGTH) + '...' : match.text;
         lines.push(`  Line ${match.line}: ${text}`);
     }
     if (truncated) {
-        lines.push("");
-        lines.push("(Results truncated. Consider using a more specific path or pattern.)");
+        lines.push('');
+        lines.push('(Results truncated. Consider using a more specific path or pattern.)');
     }
-    return lines.join("\n");
+    return lines.join('\n');
 }
 /**
  * Node.js command template for glob operations.
@@ -3177,14 +3317,14 @@ console.log(count);
  */ function buildGrepCommand(pattern, searchPath, globPattern) {
     const patternB64 = utf8ToBase64(pattern);
     const pathB64 = utf8ToBase64(searchPath);
-    const globB64 = globPattern ? utf8ToBase64(globPattern) : "";
+    const globB64 = globPattern ? utf8ToBase64(globPattern) : '';
     return `node -e "
 const fs = require('fs');
 const path = require('path');
 
 const pattern = Buffer.from('${patternB64}', 'base64').toString('utf-8');
 const searchPath = Buffer.from('${pathB64}', 'base64').toString('utf-8');
-const globPattern = ${globPattern ? `Buffer.from('${globB64}', 'base64').toString('utf-8')` : "null"};
+const globPattern = ${globPattern ? `Buffer.from('${globB64}', 'base64').toString('utf-8')` : 'null'};
 
 let regex;
 try {
@@ -3253,8 +3393,15 @@ try {
  *
  * Requires Node.js 20+ on the sandbox host.
  */ class BaseSandbox {
-    async streamExecute(command, onLine) {
-        const result = await this.execute(command);
+    /**
+   * Internal hook for file/search operations. Concrete backends can override
+   * this to distinguish "background helper commands" from user-facing shell
+   * execute calls.
+   */ executeOperation(command, options) {
+        return this.execute(command, options);
+    }
+    async streamExecute(command, onLine, options) {
+        const result = await this.execute(command, options);
         if (result.output) {
             onLine(result.output);
         }
@@ -3267,12 +3414,12 @@ try {
    * @returns List of FileInfo objects for files and directories directly in the directory.
    */ async lsInfo(path) {
         const command = buildLsCommand(path);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             return [];
         }
         const infos = [];
-        const lines = result.output.trim().split("\n").filter(Boolean);
+        const lines = result.output.trim().split('\n').filter(Boolean);
         for (const line of lines){
             try {
                 const parsed = JSON.parse(line);
@@ -3298,16 +3445,16 @@ try {
    * @returns Human-readable directory tree with indentation
    */ async listDir(dirPath, offset = 1, limit = 25, depth = 2) {
         if (offset < 1) {
-            return "Error: offset must be a 1-indexed entry number";
+            return 'Error: offset must be a 1-indexed entry number';
         }
         if (limit < 1) {
-            return "Error: limit must be greater than zero";
+            return 'Error: limit must be greater than zero';
         }
         if (depth < 1) {
-            return "Error: depth must be greater than zero";
+            return 'Error: depth must be greater than zero';
         }
         const command = buildListDirCommand(dirPath, offset, limit, depth);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             return result.output || `Error: Failed to list directory '${dirPath}'`;
         }
@@ -3324,7 +3471,7 @@ try {
    * @returns Formatted file content with line numbers, or error message
    */ async read(filePath, offset = 1, limit = 2000, mode = 'slice', indentation) {
         const command = mode === 'indentation' ? buildIndentationReadCommand(filePath, offset, limit, indentation != null ? indentation : {}) : buildSliceReadCommand(filePath, offset, limit);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
             return result.output || `Error: File '${filePath}' not found`;
         }
@@ -3332,17 +3479,17 @@ try {
     }
     /**
    * Structured search results or error string for invalid input.
-   */ async grepRaw(pattern, path = "/", include = null) {
+   */ async grepRaw(pattern, path = '/', include = null) {
         const command = buildGrepCommand(pattern, path, include);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
         if (result.exitCode === 1) {
             // Check if it's a regex error
-            if (result.output.includes("Invalid regex:")) {
+            if (result.output.includes('Invalid regex:')) {
                 return result.output.trim();
             }
         }
         const matches = [];
-        const lines = result.output.trim().split("\n").filter(Boolean);
+        const lines = result.output.trim().split('\n').filter(Boolean);
         for (const line of lines){
             try {
                 const parsed = JSON.parse(line);
@@ -3359,23 +3506,23 @@ try {
     }
     /**
    * Search file contents for a regex pattern, returning human-readable output.
-   */ async grep(pattern, path = "/", include = null) {
+   */ async grep(pattern, path = '/', include = null) {
         const result = await this.grepRaw(pattern, path, include);
-        if (typeof result === "string") {
+        if (typeof result === 'string') {
             return result;
         }
         if (result.length === 0) {
-            return "No matches found";
+            return 'No matches found';
         }
         return formatGrepOutput(result);
     }
     /**
    * Structured glob matching returning FileInfo objects.
-   */ async globInfo(pattern, path = "/") {
+   */ async globInfo(pattern, path = '/') {
         const command = buildGlobCommand(path, pattern);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_SEARCH_EXECUTION_OPTIONS);
         const infos = [];
-        const lines = result.output.trim().split("\n").filter(Boolean);
+        const lines = result.output.trim().split('\n').filter(Boolean);
         for (const line of lines){
             try {
                 const parsed = JSON.parse(line);
@@ -3393,10 +3540,10 @@ try {
     }
     /**
    * Find files matching a glob pattern, returning human-readable output.
-   */ async glob(pattern, path = "/") {
+   */ async glob(pattern, path = '/') {
         const files = await this.globInfo(pattern, path);
         if (files.length === 0) {
-            return "No files found";
+            return 'No files found';
         }
         return formatGlobOutput(files);
     }
@@ -3404,9 +3551,9 @@ try {
    * Create a new file with content.
    */ async write(filePath, content) {
         const command = buildWriteCommand(filePath, content);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
-            const output = (result.output || "").trim();
+            const output = (result.output || '').trim();
             if (output.includes(WRITE_EXISTS_OUTPUT)) {
                 return {
                     error: `Cannot write to ${filePath} because it already exists. Read and then make an edit, or write to a new path.`
@@ -3426,7 +3573,7 @@ try {
         };
     }
     async writeViaUpload(filePath, content) {
-        const existsCheck = await this.execute(buildExistsCommand(filePath));
+        const existsCheck = await this.executeOperation(buildExistsCommand(filePath), DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (existsCheck.exitCode === 0) {
             return {
                 error: `Cannot write to ${filePath} because it already exists. Read and then make an edit, or write to a new path.`
@@ -3435,7 +3582,7 @@ try {
         const uploads = await this.uploadFiles([
             [
                 filePath,
-                Buffer.from(content, "utf-8")
+                Buffer.from(content, 'utf-8')
             ]
         ]);
         const first = uploads[0];
@@ -3458,9 +3605,9 @@ try {
    * Append content to a file. Creates the file if it doesn't exist.
    */ async append(filePath, content) {
         const command = buildAppendCommand(filePath, content);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         if (result.exitCode !== 0) {
-            const output = (result.output || "").trim();
+            const output = (result.output || '').trim();
             return {
                 error: output ? `Failed to append to file '${filePath}': ${output}` : `Failed to append to file '${filePath}'.`
             };
@@ -3474,7 +3621,7 @@ try {
    * Edit a file by replacing string occurrences.
    */ async edit(filePath, oldString, newString, replaceAll = false) {
         const command = buildEditCommand(filePath, oldString, newString, replaceAll);
-        const result = await this.execute(command);
+        const result = await this.executeOperation(command, DEFAULT_SANDBOX_FILE_OPERATION_EXECUTION_OPTIONS);
         switch(result.exitCode){
             case 0:
                 {
@@ -3510,7 +3657,7 @@ try {
    */ async multiEdit(filePath, edits) {
         if (!edits || edits.length === 0) {
             return {
-                error: "No edits provided"
+                error: 'No edits provided'
             };
         }
         const results = [];
@@ -3554,4 +3701,4 @@ SandboxProviderRegistry = __decorate([
     ])
 ], SandboxProviderRegistry);
 
-export { AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, 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, DOCUMENT_SOURCE_STRATEGY, DOCUMENT_TRANSFORMER_STRATEGY, DataSourceStrategy, DataSourceStrategyRegistry, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, 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, LLMUsage, LargeLanguageModel, ModelProvider, ORGANIZATION_METADATA_KEY, OpenAICompatibleReranker, PERMISSION_OPERATION_METADATA_KEY, 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, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VectorStoreRegistry, VectorStoreStrategy, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, runWithRequestContext, sumTokenUsage };
+export { AGENT_CHAT_DISPATCH_MESSAGE_TYPE, AGENT_MIDDLEWARE_STRATEGY, AIModelProviderNotFoundException, AIModelProviderRegistry, AIModelProviderStrategy, AI_MODEL_PROVIDER, ANALYTICS_PERMISSION_SERVICE_TOKEN, AdapterDataSourceStrategy, AgentMiddlewareRegistry, AgentMiddlewareStrategy, AiModelNotFoundException, 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, DocumentSourceRegistry, DocumentSourceStrategy, DocumentTransformerRegistry, DocumentTransformerStrategy, FILE_STORAGE_PROVIDER, FILE_UPLOAD_TARGET_STRATEGY, 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, 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, STRATEGY_META_KEY, SandboxProviderRegistry, SandboxProviderStrategy, Speech2TextChatModel, SpeechToTextModel, StrategyBus, TEXT_SPLITTER_STRATEGY, TOOLSET_STRATEGY, TextEmbeddingModelManager, TextSplitterRegistry, TextSplitterStrategy, TextToSpeechModel, ToolsetRegistry, ToolsetStrategy, USER_PERMISSION_SERVICE_TOKEN, VECTOR_STORE_STRATEGY, VectorStoreRegistry, VectorStoreStrategy, WORKFLOW_NODE_STRATEGY, WORKFLOW_TRIGGER_STRATEGY, WorkflowNodeRegistry, WorkflowNodeStrategy, WorkflowTriggerRegistry, WorkflowTriggerStrategy, WrapWorkflowNodeExecutionCommand, XpFileSystem, XpertServerPlugin, als, appendSandboxMessage, buildSandboxTimeoutMessage, calcTokenUsage, chunkText, countTokensSafe, createI18nInstance, createPluginLogger, defineAgentMessageType, defineChannelMessageType, downloadRemoteFile, formatSandboxTimeout, getErrorMessage, getModelContextSize, getPermissionOperationMetadata, getPositionList, getPositionMap, getRequestContext, getRequiredPermissionOperation, isRemoteFile, isSandboxBackend, isStructuredMessageType, loadYamlFile, mergeCredentials, mergeParentChildChunks, normalizeContextSize, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.8.1",
+  "version": "3.8.4",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/index.d.ts

@@ -13,5 +13,6 @@ export * from './lib/data/index';
 export * from './lib/ai-model/index';
 export * from './lib/agent/index';
 export * from './lib/channel/index';
+export * from './lib/file/index';
 export * from './lib/strategy';
 export * from './lib/sandbox/index';

package/src/lib/ai-model/llm.d.ts

@@ -41,6 +41,15 @@ export declare abstract class LargeLanguageModel extends AIModel {
         handleLLMError: (err: any) => void;
     };
     protected getCustomizableModelSchemaFromCredentials(model: string, credentials: Record<string, any>): AIModelEntity | null;
+    protected createHandleVerboseCallbacks(enabled?: boolean, logger?: Logger): {
+        handleChatModelStart: (llm: any, messages: any, runId: any, parentRunId: any, extraParams: any, tags: any, metadata: any, runName: any) => void;
+        handleLLMStart: (llm: any, prompts: any, runId: any, parentRunId: any, extraParams: any, tags: any, metadata: any, runName: any) => void;
+        handleLLMEnd: (output: any, runId: any, parentRunId: any, tags: any, extraParams: any) => void;
+        handleLLMError: (err: any, runId: any, parentRunId: any, tags: any, extraParams: any) => void;
+    }[];
+    private formatVerboseLog;
+    private stringifyLogPayload;
+    private formatError;
 }
 export declare function calcTokenUsage(output: LLMResult): TTokenUsage;
 /**

package/src/lib/core/index.d.ts

@@ -1,4 +1,5 @@
 export * from './file-system';
+export * from './plugin-config';
 export * from './permissions';
 export * from './schema';
 export * from './i18n';

package/src/lib/core/permissions/general.d.ts

@@ -1,4 +1,4 @@
-import type { IIntegration } from '@metad/contracts';
+import type { IIntegration, IPagination } from '@metad/contracts';
 /**
  * Base Permission type
  */
@@ -68,4 +68,5 @@ export declare const INTEGRATION_PERMISSION_SERVICE_TOKEN = "XPERT_PLUGIN_INTEGR
  */
 export interface IntegrationPermissionService {
     read<TIntegration = IIntegration>(id: string, options?: Record<string, any>): Promise<TIntegration | null>;
+    findAll<TIntegration = IIntegration>(options?: Record<string, any>): Promise<IPagination<TIntegration>>;
 }

package/src/lib/core/plugin-config.d.ts

@@ -0,0 +1,9 @@
+export interface PluginConfigResolveOptions<TConfig extends object = Record<string, any>> {
+    organizationId?: string;
+    fallbackToGlobal?: boolean;
+    defaults?: Partial<TConfig>;
+}
+export interface IPluginConfigResolver {
+    resolve<TConfig extends object = Record<string, any>>(pluginName: string, options?: PluginConfigResolveOptions<TConfig>): TConfig;
+}
+export declare const PLUGIN_CONFIG_RESOLVER_TOKEN = "XPERT_PLUGIN_CONFIG_RESOLVER";

package/src/lib/file/file-storage/index.d.ts

@@ -0,0 +1,3 @@
+export * from './provider.decorator';
+export * from './provider.interface';
+export * from './provider.registry';

package/src/lib/file/file-storage/provider.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const FILE_STORAGE_PROVIDER = "FILE_STORAGE_PROVIDER";
+export declare const FileStorageProvider: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/src/lib/file/file-storage/provider.interface.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { FileStorageOption, FileSystem, UploadedFile } from '@metad/contracts';
+export interface IFileStorageProvider {
+    readonly name: string;
+    readonly config?: FileSystem & Record<string, any>;
+    url(path: string): string;
+    path(path: string): string;
+    handler(options: FileStorageOption): any;
+    getFile(file: string): Promise<Buffer>;
+    putFile(fileContent: string | Buffer | URL, path?: string): Promise<UploadedFile>;
+    deleteFile(path: string): Promise<void>;
+    mapUploadedFile?(file: any): UploadedFile;
+}

package/src/lib/file/file-storage/provider.registry.d.ts

@@ -0,0 +1,6 @@
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { BaseStrategyRegistry } from '../../strategy';
+import { IFileStorageProvider } from './provider.interface';
+export declare class FileStorageProviderRegistry extends BaseStrategyRegistry<IFileStorageProvider> {
+    constructor(discoveryService: DiscoveryService, reflector: Reflector);
+}

package/src/lib/file/file-upload/index.d.ts

@@ -0,0 +1,3 @@
+export * from './strategy.decorator';
+export * from './strategy.interface';
+export * from './strategy.registry';

package/src/lib/file/file-upload/strategy.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const FILE_UPLOAD_TARGET_STRATEGY = "FILE_UPLOAD_TARGET_STRATEGY";
+export declare const FileUploadTargetStrategy: (type: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/src/lib/file/file-upload/strategy.interface.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { IFileAssetDestination, IFileAssetSource, IStorageFile, IUploadFileTarget } from '@metad/contracts';
+export type TFileUploadRequestContext = {
+    tenantId?: string;
+    organizationId?: string;
+    userId?: string;
+};
+export type TResolvedFileUploadSource = {
+    name: string;
+    originalName: string;
+    mimeType?: string;
+    size?: number;
+    buffer: Buffer;
+    source: IFileAssetSource;
+    storageFile?: IStorageFile;
+};
+export type TFileUploadContext = {
+    request: TFileUploadRequestContext;
+    metadata?: Record<string, any>;
+};
+export type TStorageProviderType = string;
+export interface IFileUploadTargetStrategy<TTarget extends IUploadFileTarget = IUploadFileTarget> {
+    upload(source: TResolvedFileUploadSource, target: TTarget, context: TFileUploadContext): Promise<IFileAssetDestination>;
+}

package/src/lib/file/file-upload/strategy.registry.d.ts

@@ -0,0 +1,6 @@
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { BaseStrategyRegistry } from '../../strategy';
+import { IFileUploadTargetStrategy } from './strategy.interface';
+export declare class FileUploadTargetRegistry extends BaseStrategyRegistry<IFileUploadTargetStrategy> {
+    constructor(discoveryService: DiscoveryService, reflector: Reflector);
+}