@xpert-ai/plugin-sdk 3.9.0-beta.0 → 3.9.0-beta.2

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @xpert-ai/plugin-sdk
+
+## 3.9.0-beta.2
+
+### Patch Changes
+
+- Updates
+- Updated dependencies
+  - @xpert-ai/contracts@3.9.0-beta.2
+  - @xpert-ai/ocap-core@3.9.0-beta.2
+
+## 3.9.0-beta.1
+
+### Patch Changes
+
+- beta v
+- Updated dependencies
+  - @xpert-ai/contracts@3.9.0-beta.1
+  - @xpert-ai/ocap-core@3.9.0-beta.1

package/index.cjs.js

@@ -5,7 +5,7 @@ var constants = require('@nestjs/common/constants');
 var lodashEs = require('lodash-es');
 var core = require('@nestjs/core');
 var rxjs = require('rxjs');
-var contracts = require('@metad/contracts');
+var contracts = require('@xpert-ai/contracts');
 var node_async_hooks = require('node:async_hooks');
 var passportJwt = require('passport-jwt');
 var jsonwebtoken = require('jsonwebtoken');
@@ -148,6 +148,15 @@ class RequestContext {
         const session = getRequestContext();
         return session;
     }
+    static currentApiKey() {
+        var _RequestContext_currentApiPrincipal;
+        var _RequestContext_currentApiPrincipal_apiKey;
+        return (_RequestContext_currentApiPrincipal_apiKey = (_RequestContext_currentApiPrincipal = RequestContext.currentApiPrincipal()) == null ? void 0 : _RequestContext_currentApiPrincipal.apiKey) != null ? _RequestContext_currentApiPrincipal_apiKey : null;
+    }
+    static currentApiPrincipal() {
+        const user = RequestContext.currentUser();
+        return (user == null ? void 0 : user.apiKey) ? user : null;
+    }
     static currentRequest() {
         const requestContext = RequestContext.currentRequestContext();
         if (requestContext) {
@@ -155,11 +164,6 @@ class RequestContext {
         }
         return null;
     }
-    static currentApiKey() {
-        const user = RequestContext.currentUser();
-        var _user_apiKey;
-        return (_user_apiKey = user == null ? void 0 : user.apiKey) != null ? _user_apiKey : null;
-    }
     static currentTenantId() {
         const user = RequestContext.currentUser();
         if (user) {
@@ -971,8 +975,7 @@ BuiltinToolset.provider = '';
      * @param filePath Relative file path
      * @returns Web URL of file
      */ fullUrl(filePath) {
-        const url = new URL(filePath, this.baseUrl);
-        return url.href;
+        return this.buildUrl(filePath);
     }
     /**
      * Read file contents
@@ -992,8 +995,7 @@ BuiltinToolset.provider = '';
             recursive: true
         });
         await fsPromises.writeFile(fullPath, content);
-        const url = new URL(filePath, this.baseUrl);
-        return url.href;
+        return this.buildUrl(filePath);
     }
     /**
      * Delete a file
@@ -1019,6 +1021,23 @@ BuiltinToolset.provider = '';
             return false;
         }
     }
+    // Keep URL generation tolerant of protocol-relative base URLs like "//localhost:3000",
+    // which are used by the current dev config and would otherwise make `new URL()` throw.
+    buildUrl(filePath) {
+        if (/^[a-zA-Z][a-zA-Z\d+.-]*:/.test(filePath) || filePath.startsWith('//')) {
+            return filePath;
+        }
+        const normalizedPath = this.encodePath(`${filePath}`.replace(/^\/+/, ''));
+        const normalizedBaseUrl = `${this.baseUrl}`.replace(/\/+$/, '');
+        if (normalizedBaseUrl.startsWith('//')) {
+            return `${normalizedBaseUrl}/${normalizedPath}`;
+        }
+        const url = new URL(normalizedPath, `${normalizedBaseUrl}/`);
+        return url.href;
+    }
+    encodePath(filePath) {
+        return filePath.split('/').map((segment)=>encodeURIComponent(segment)).join('/');
+    }
     constructor(permission, basePath, baseUrl){
         this.basePath = basePath;
         this.baseUrl = baseUrl;
@@ -3871,6 +3890,8 @@ exports.ViewExtensionProviderRegistry = __decorate([
     ])
 ], exports.ViewExtensionProviderRegistry);
 
+const VIEW_EXTENSION_CACHE_SERVICE_TOKEN = 'XPERT_PLUGIN_VIEW_EXTENSION_CACHE_SERVICE';
+
 exports.AGENT_CHAT_DISPATCH_MESSAGE_TYPE = AGENT_CHAT_DISPATCH_MESSAGE_TYPE;
 exports.AGENT_MIDDLEWARE_STRATEGY = AGENT_MIDDLEWARE_STRATEGY;
 exports.AIModelProviderNotFoundException = AIModelProviderNotFoundException;
@@ -3966,6 +3987,7 @@ exports.TextToSpeechModel = TextToSpeechModel;
 exports.ToolsetStrategy = ToolsetStrategy;
 exports.USER_PERMISSION_SERVICE_TOKEN = USER_PERMISSION_SERVICE_TOKEN;
 exports.VECTOR_STORE_STRATEGY = VECTOR_STORE_STRATEGY;
+exports.VIEW_EXTENSION_CACHE_SERVICE_TOKEN = VIEW_EXTENSION_CACHE_SERVICE_TOKEN;
 exports.VIEW_EXTENSION_PROVIDER = VIEW_EXTENSION_PROVIDER;
 exports.VectorStoreStrategy = VectorStoreStrategy;
 exports.ViewExtensionProvider = ViewExtensionProvider;

package/index.esm.js

@@ -3,7 +3,7 @@ import { MODULE_METADATA } from '@nestjs/common/constants';
 import { pick } from 'lodash-es';
 import { DiscoveryService, Reflector } from '@nestjs/core';
 import { Subject, filter } from 'rxjs';
-import { LanguagesEnum, AiModelTypeEnum, ParameterType, PriceType, FetchFrom, ModelFeature, ModelPropertyKey } from '@metad/contracts';
+import { LanguagesEnum, AiModelTypeEnum, ParameterType, PriceType, FetchFrom, ModelFeature, ModelPropertyKey } from '@xpert-ai/contracts';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { ExtractJwt } from 'passport-jwt';
 import { verify, JsonWebTokenError } from 'jsonwebtoken';
@@ -127,6 +127,15 @@ class RequestContext {
         const session = getRequestContext();
         return session;
     }
+    static currentApiKey() {
+        var _RequestContext_currentApiPrincipal;
+        var _RequestContext_currentApiPrincipal_apiKey;
+        return (_RequestContext_currentApiPrincipal_apiKey = (_RequestContext_currentApiPrincipal = RequestContext.currentApiPrincipal()) == null ? void 0 : _RequestContext_currentApiPrincipal.apiKey) != null ? _RequestContext_currentApiPrincipal_apiKey : null;
+    }
+    static currentApiPrincipal() {
+        const user = RequestContext.currentUser();
+        return (user == null ? void 0 : user.apiKey) ? user : null;
+    }
     static currentRequest() {
         const requestContext = RequestContext.currentRequestContext();
         if (requestContext) {
@@ -134,11 +143,6 @@ class RequestContext {
         }
         return null;
     }
-    static currentApiKey() {
-        const user = RequestContext.currentUser();
-        var _user_apiKey;
-        return (_user_apiKey = user == null ? void 0 : user.apiKey) != null ? _user_apiKey : null;
-    }
     static currentTenantId() {
         const user = RequestContext.currentUser();
         if (user) {
@@ -950,8 +954,7 @@ BuiltinToolset.provider = '';
      * @param filePath Relative file path
      * @returns Web URL of file
      */ fullUrl(filePath) {
-        const url = new URL(filePath, this.baseUrl);
-        return url.href;
+        return this.buildUrl(filePath);
     }
     /**
      * Read file contents
@@ -971,8 +974,7 @@ BuiltinToolset.provider = '';
             recursive: true
         });
         await fsPromises.writeFile(fullPath, content);
-        const url = new URL(filePath, this.baseUrl);
-        return url.href;
+        return this.buildUrl(filePath);
     }
     /**
      * Delete a file
@@ -998,6 +1000,23 @@ BuiltinToolset.provider = '';
             return false;
         }
     }
+    // Keep URL generation tolerant of protocol-relative base URLs like "//localhost:3000",
+    // which are used by the current dev config and would otherwise make `new URL()` throw.
+    buildUrl(filePath) {
+        if (/^[a-zA-Z][a-zA-Z\d+.-]*:/.test(filePath) || filePath.startsWith('//')) {
+            return filePath;
+        }
+        const normalizedPath = this.encodePath(`${filePath}`.replace(/^\/+/, ''));
+        const normalizedBaseUrl = `${this.baseUrl}`.replace(/\/+$/, '');
+        if (normalizedBaseUrl.startsWith('//')) {
+            return `${normalizedBaseUrl}/${normalizedPath}`;
+        }
+        const url = new URL(normalizedPath, `${normalizedBaseUrl}/`);
+        return url.href;
+    }
+    encodePath(filePath) {
+        return filePath.split('/').map((segment)=>encodeURIComponent(segment)).join('/');
+    }
     constructor(permission, basePath, baseUrl){
         this.basePath = basePath;
         this.baseUrl = baseUrl;
@@ -3850,4 +3869,6 @@ ViewExtensionProviderRegistry = __decorate([
     ])
 ], ViewExtensionProviderRegistry);
 
-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, SKILL_SOURCE_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_PROVIDER, VectorStoreRegistry, VectorStoreStrategy, ViewExtensionProvider, ViewExtensionProviderRegistry, 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, resolveSandboxBackend, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };
+const VIEW_EXTENSION_CACHE_SERVICE_TOKEN = 'XPERT_PLUGIN_VIEW_EXTENSION_CACHE_SERVICE';
+
+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, SKILL_SOURCE_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, 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, resolveSandboxBackend, resolveSandboxExecutionOptions, runWithRequestContext, secondsToMilliseconds, sumTokenUsage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.9.0-beta.0",
+  "version": "3.9.0-beta.2",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -12,15 +12,16 @@
   "main": "./index.cjs.js",
   "module": "./index.esm.js",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "directory": "dist"
   },
   "dependencies": {
     "js-tiktoken": "^1.0.21"
   },
   "peerDependencies": {
     "@langchain/core": "*",
-    "@metad/contracts": "*",
-    "@metad/ocap-core": "*",
+    "@xpert-ai/contracts": "workspace:*",
+    "@xpert-ai/ocap-core": "workspace:*",
     "@nestjs/common": "*",
     "@nestjs/core": "*",
     "@nestjs/cqrs": "*",
@@ -30,11 +31,8 @@
     "i18next": "*",
     "json-schema": "*",
     "jsonwebtoken": "*",
-    "fs": "*",
-    "path": "*",
     "passport-jwt": "*",
     "rxjs": "*",
-    "stream": "*",
     "yaml": "*",
     "zod": "*"
   },

package/src/lib/agent/handoff/agent-chat.contract.d.ts

@@ -1,4 +1,4 @@
-import { TChatOptions, TChatRequest } from '@metad/contracts';
+import { TChatOptions, TChatRequest } from '@xpert-ai/contracts';
 export declare const AGENT_CHAT_DISPATCH_MESSAGE_TYPE: import("./message-type").StructuredHandoffMessageType;
 export interface AgentChatCallbackTarget {
     messageType: string;

package/src/lib/agent/middleware/runtime.d.ts

@@ -1,6 +1,6 @@
 import type { Runtime as LangGraphRuntime } from "@langchain/langgraph";
 import type { BaseMessage } from "@langchain/core/messages";
-import { TSandboxConfigurable } from "@metad/contracts";
+import { TSandboxConfigurable } from "@xpert-ai/contracts";
 /**
  * Type for the agent's built-in state properties.
  */

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

@@ -1,4 +1,4 @@
-import { IWFNMiddleware, TAgentMiddlewareMeta } from '@metad/contracts';
+import { IWFNMiddleware, TAgentMiddlewareMeta, TXpertFeatures } from '@xpert-ai/contracts';
 import { StructuredToolInterface } from "@langchain/core/tools";
 import { RunnableToolLike } from '@langchain/core/runnables';
 import { AgentMiddleware } from './types';
@@ -10,6 +10,7 @@ export interface IAgentMiddlewareContext {
     projectId?: string;
     conversationId?: string;
     xpertId?: string;
+    xpertFeatures?: TXpertFeatures | null;
     agentKey?: string;
     node: IWFNMiddleware;
     tools: Map<string, StructuredToolInterface | RunnableToolLike>;

package/src/lib/agent/skill/skill-source-provider.interface.d.ts

@@ -1,4 +1,4 @@
-import { ISkillRepository, ISkillRepositoryIndex, TSkillSourceMeta } from '@metad/contracts';
+import { ISkillRepository, ISkillRepositoryIndex, TSkillSourceMeta } from '@xpert-ai/contracts';
 export interface ISkillSourceProvider {
     type: string;
     meta: TSkillSourceMeta;

package/src/lib/ai-model/abstract-provider.d.ts

@@ -1,7 +1,7 @@
 import { Embeddings } from '@langchain/core/embeddings';
 import { BaseLanguageModel } from '@langchain/core/language_models/base';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { AIModelEntity, AiModelTypeEnum, IAiProviderEntity, ICopilotModel, ProviderModel } from '@metad/contracts';
+import { AIModelEntity, AiModelTypeEnum, IAiProviderEntity, ICopilotModel, ProviderModel } from '@xpert-ai/contracts';
 import { Logger } from '@nestjs/common';
 import { AIModel } from './ai-model';
 import { IAIModelProviderStrategy } from './ai-model-provider.interface';

package/src/lib/ai-model/ai-model-provider.interface.d.ts

@@ -1,4 +1,4 @@
-import { AiModelTypeEnum, IAiProviderEntity, ICopilotModel, ProviderModel, AIModelEntity } from '@metad/contracts';
+import { AiModelTypeEnum, IAiProviderEntity, ICopilotModel, ProviderModel, AIModelEntity } from '@xpert-ai/contracts';
 import { BaseLanguageModel } from '@langchain/core/language_models/base';
 import { Embeddings } from '@langchain/core/embeddings';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';

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

@@ -1,5 +1,5 @@
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { AIModelEntity, AiModelTypeEnum, ICopilotModel, ParameterRule, PriceInfo, PriceType } from '@metad/contracts';
+import { AIModelEntity, AiModelTypeEnum, ICopilotModel, ParameterRule, PriceInfo, PriceType } from '@xpert-ai/contracts';
 import { Logger } from '@nestjs/common';
 import { ModelProvider } from './abstract-provider';
 import { IAIModel, TChatModelOptions } from './types/model';

package/src/lib/ai-model/commands/create-model-client.command.d.ts

@@ -1,7 +1,7 @@
 import { Embeddings } from '@langchain/core/embeddings';
 import { BaseLanguageModel } from '@langchain/core/language_models/base';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { ICopilotModel, ILLMUsage } from '@metad/contracts';
+import { ICopilotModel, ILLMUsage } from '@xpert-ai/contracts';
 import { Command } from '@nestjs/cqrs';
 import { IRerank } from '../types';
 /**

package/src/lib/ai-model/entities/defaults.d.ts

@@ -1,3 +1,3 @@
-import { ParameterRule } from "@metad/contracts";
+import { ParameterRule } from "@xpert-ai/contracts";
 import { DefaultParameterName } from "./model_entities";
 export declare const PARAMETER_RULE_TEMPLATE: Record<DefaultParameterName, ParameterRule>;

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

@@ -1,4 +1,4 @@
-import { AIModelEntity, ICopilot, ILLMUsage, ParameterRule, TTokenUsage } from '@metad/contracts';
+import { AIModelEntity, ICopilot, ILLMUsage, ParameterRule, TTokenUsage } from '@xpert-ai/contracts';
 import { Logger } from '@nestjs/common';
 import { LLMResult } from '@langchain/core/outputs';
 import { AIModel } from './ai-model';

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

@@ -1,5 +1,5 @@
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
-import { AIModelEntity, ICopilot, ICopilotModel, ILLMUsage, ParameterType, PriceInfo, PriceType } from "@metad/contracts";
+import { AIModelEntity, ICopilot, ICopilotModel, ILLMUsage, ParameterType, PriceInfo, PriceType } from "@xpert-ai/contracts";
 export type TChatModelOptions = {
     modelProperties: Record<string, any>;
     handleLLMTokens: (input: {

package/src/lib/ai-model/types/rerank.d.ts

@@ -1,5 +1,5 @@
 import { Document } from '@langchain/core/documents';
-import { ICopilotModel } from '@metad/contracts';
+import { ICopilotModel } from '@xpert-ai/contracts';
 import { AIModel } from '../ai-model';
 import { TChatModelOptions } from './model';
 export type RerankResult = {

package/src/lib/ai-model/types/text-embedding-model.d.ts

@@ -1,5 +1,5 @@
 import { Embeddings } from '@langchain/core/embeddings';
-import { ICopilotModel } from '@metad/contracts';
+import { ICopilotModel } from '@xpert-ai/contracts';
 import { AIModel } from '../ai-model';
 import { TChatModelOptions } from './model';
 export declare abstract class TextEmbeddingModelManager extends AIModel {

package/src/lib/ai-model/types/tts.d.ts

@@ -1,4 +1,4 @@
-import { ParameterRule } from '@metad/contracts';
+import { ParameterRule } from '@xpert-ai/contracts';
 import { AIModel } from '../ai-model';
 export declare abstract class TextToSpeechModel extends AIModel {
     getParameterRules(model: string, credentials: Record<string, string>): ParameterRule[];

package/src/lib/ai-model/utils/limits.d.ts

@@ -1,4 +1,4 @@
 import { BaseLanguageModel } from "@langchain/core/language_models/base";
-import { ICopilotModel } from "@metad/contracts";
+import { ICopilotModel } from "@xpert-ai/contracts";
 export declare function getModelContextSize(input: BaseLanguageModel | ICopilotModel): number | undefined;
 export declare function normalizeContextSize(value: unknown): number | undefined;

package/src/lib/channel/strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IIntegration } from '@metad/contracts';
+import { IIntegration } from '@xpert-ai/contracts';
 import { Request, Response, NextFunction } from 'express';
 /**
  * Channel metadata

package/src/lib/core/context/request-context.d.ts

@@ -1,4 +1,5 @@
-import { IApiKey, IRequestScopeContext, IUser, LanguagesEnum, PermissionsEnum, RolesEnum } from '@metad/contracts';
+import { IApiKey, IRequestScopeContext, IUser, LanguagesEnum, PermissionsEnum, RolesEnum } from '@xpert-ai/contracts';
+import type { IApiPrincipal } from '@xpert-ai/contracts';
 import type { IncomingMessage, ServerResponse } from 'http';
 import { AsyncLocalStorage } from 'node:async_hooks';
 export declare class RequestContext {
@@ -9,8 +10,9 @@ export declare class RequestContext {
     readonly extras: Record<string, any>;
     constructor(request: IncomingMessage, response: ServerResponse, reqId: string, userId?: string, extras?: Record<string, any>);
     static currentRequestContext(): RequestContext;
-    static currentRequest(): IncomingMessage;
     static currentApiKey(): IApiKey | null;
+    static currentApiPrincipal(): IApiPrincipal | null;
+    static currentRequest(): IncomingMessage;
     static currentTenantId(): string;
     static currentUserId(): string;
     static currentRoleId(): string;

package/src/lib/core/context/request-context.middleware.d.ts

@@ -1,4 +1,4 @@
-import { IUser } from '@metad/contracts';
+import { IUser } from '@xpert-ai/contracts';
 import { NestMiddleware } from '@nestjs/common';
 import { IncomingMessage, ServerResponse } from 'node:http';
 export declare class RequestContextMiddleware implements NestMiddleware {

package/src/lib/core/file-system.d.ts

@@ -50,4 +50,6 @@ export declare class XpFileSystem {
      * Utility: check if a file or directory exists
      */
     exists(targetPath: string): Promise<boolean>;
+    private buildUrl;
+    private encodePath;
 }

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

@@ -1,4 +1,4 @@
-import type { IIntegration, IPagination } from '@metad/contracts';
+import type { IIntegration, IPagination } from '@xpert-ai/contracts';
 /**
  * Base Permission type
  */

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

@@ -1,4 +1,4 @@
-import type { IUser } from '@metad/contracts';
+import type { IUser } from '@xpert-ai/contracts';
 import type { BasePermission } from './general';
 export type UserPermissionOperation = 'read' | 'write' | 'update' | 'delete';
 /**

package/src/lib/data/datasource/types.d.ts

@@ -1,7 +1,7 @@
 import * as _axios from 'axios';
 import { Readable } from 'stream';
-import { IColumnDef, IDSSchema, IDSTable } from '@metad/contracts';
-export { IColumnDef, IDSSchema, IDSTable } from '@metad/contracts';
+import { IColumnDef, IDSSchema, IDSTable } from '@xpert-ai/contracts';
+export { IColumnDef, IDSSchema, IDSTable } from '@xpert-ai/contracts';
 /**
  * The base options for DB adapters
  */

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

@@ -1,4 +1,4 @@
-import { FileStorageOption, FileSystem, UploadedFile } from '@metad/contracts';
+import { FileStorageOption, FileSystem, UploadedFile } from '@xpert-ai/contracts';
 export interface IFileStorageProvider {
     readonly name: string;
     readonly config?: FileSystem & Record<string, any>;

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

@@ -1,4 +1,4 @@
-import { IFileAssetDestination, IFileAssetSource, IStorageFile, IUploadFileTarget } from '@metad/contracts';
+import { IFileAssetDestination, IFileAssetSource, IStorageFile, IUploadFileTarget } from '@xpert-ai/contracts';
 export type TFileUploadRequestContext = {
     tenantId?: string;
     organizationId?: string;

package/src/lib/integration/strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IIntegration, TIntegrationProvider } from '@metad/contracts';
+import { IIntegration, TIntegrationProvider } from '@xpert-ai/contracts';
 export type TIntegrationStrategyParams = {
     query: string;
 };

package/src/lib/rag/image/strategy.interface.d.ts

@@ -1,6 +1,6 @@
 import { DocumentInterface } from '@langchain/core/documents';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
-import { IDocumentUnderstandingProvider, IKnowledgeDocument } from '@metad/contracts';
+import { IDocumentUnderstandingProvider, IKnowledgeDocument } from '@xpert-ai/contracts';
 import { Permissions, XpFileSystem } from '../../core/index';
 import { ChunkMetadata } from '../types';
 export type TImageUnderstandingConfig = {

package/src/lib/rag/knowledge/knowledge-strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IIntegration } from '@metad/contracts';
+import { IIntegration } from '@xpert-ai/contracts';
 import { Document } from '@langchain/core/documents';
 export type TKnowledgeStrategyParams = {
     query: string;

package/src/lib/rag/retriever/strategy.interface.d.ts

@@ -1,5 +1,5 @@
 import { VectorStore } from '@langchain/core/vectorstores';
-import { I18nObject } from '@metad/contracts';
+import { I18nObject } from '@xpert-ai/contracts';
 import { Document } from '@langchain/core/documents';
 export type TRetrieverConfig = {
     vectorStore: VectorStore;

package/src/lib/rag/source/strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IDocumentSourceProvider, IIntegration } from '@metad/contracts';
+import { IDocumentSourceProvider, IIntegration } from '@xpert-ai/contracts';
 import { Document } from '@langchain/core/documents';
 import { Permissions } from '../../core';
 export interface IDocumentSourceStrategy<TConfig = any> {

package/src/lib/rag/textsplitter/strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IDocumentChunkerProvider, KnowledgeStructureEnum } from '@metad/contracts';
+import { IDocumentChunkerProvider, KnowledgeStructureEnum } from '@xpert-ai/contracts';
 import { DocumentInterface } from '@langchain/core/documents';
 import { ChunkMetadata } from '../types';
 /**

package/src/lib/rag/transformer/strategy.interface.d.ts

@@ -1,4 +1,4 @@
-import { IDocumentProcessorProvider, IIntegration, IKnowledgeDocument } from '@metad/contracts';
+import { IDocumentProcessorProvider, IIntegration, IKnowledgeDocument } from '@xpert-ai/contracts';
 import { Permissions, XpFileSystem } from '../../core/index';
 import { ChunkMetadata } from '../types';
 export type TDocumentTransformerConfig = {

package/src/lib/rag/types.d.ts

@@ -1,6 +1,6 @@
 import { DocumentInterface } from '@langchain/core/documents';
-import { IDocChunkMetadata } from '@metad/contracts';
-export { TDocumentAsset } from '@metad/contracts';
+import { IDocChunkMetadata } from '@xpert-ai/contracts';
+export { TDocumentAsset } from '@xpert-ai/contracts';
 export interface ChunkMetadata extends IDocChunkMetadata {
     startOffset?: number;
     endOffset?: number;

package/src/lib/sandbox/protocol.d.ts

@@ -1,4 +1,4 @@
-import { IBackendProtocol, TSandboxConfigurable } from '@metad/contracts';
+import { IBackendProtocol, TSandboxConfigurable } from '@xpert-ai/contracts';
 import type { SandboxExecutionOptions } from './execution';
 /**
  * Protocol definition for pluggable memory backends.

package/src/lib/sandbox/sandbox.interface.d.ts

@@ -1,4 +1,4 @@
-import { TSandboxProviderMeta, TSandboxWorkForType } from '@metad/contracts';
+import { TSandboxProviderMeta, TSandboxWorkForType } from '@xpert-ai/contracts';
 import { SandboxBackendProtocol } from './protocol';
 export type SandboxProviderCreateOptions = {
     /**

package/src/lib/toolset/builtin.d.ts

@@ -1,6 +1,6 @@
 import { StructuredToolInterface } from '@langchain/core/tools';
 import { BaseStore } from '@langchain/langgraph';
-import { I18nObject, IXpertToolset, ToolProviderCredentials, TToolCredentials, TToolsetParams, XpertToolsetCategoryEnum } from '@metad/contracts';
+import { I18nObject, IXpertToolset, ToolProviderCredentials, TToolCredentials, TToolsetParams, XpertToolsetCategoryEnum } from '@xpert-ai/contracts';
 import { Logger } from '@nestjs/common';
 import { CommandBus, QueryBus } from '@nestjs/cqrs';
 import { BaseToolset } from './toolset';

package/src/lib/toolset/strategy.interface.d.ts

@@ -1,5 +1,5 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
-import { I18nObject, IconDefinition } from '@metad/contracts';
+import { I18nObject, IconDefinition } from '@xpert-ai/contracts';
 import { ZodSchema } from 'zod';
 import { BuiltinToolset } from './builtin';
 export interface IToolsetStrategy<TConfig = any> {

package/src/lib/toolset/toolset.d.ts

@@ -1,5 +1,5 @@
 import { BaseToolkit, StructuredTool, StructuredToolInterface } from "@langchain/core/tools";
-import { I18nObject, TStateVariable, TToolsetParams } from "@metad/contracts";
+import { I18nObject, TStateVariable, TToolsetParams } from "@xpert-ai/contracts";
 import { z } from 'zod';
 type ZodObjectAny = z.ZodObject<any, any, any, any>;
 /**

package/src/lib/types.d.ts

@@ -1,4 +1,4 @@
-import { JsonSchemaObjectType, PluginMeta } from '@metad/contracts';
+import { JsonSchemaObjectType, PluginMeta } from '@xpert-ai/contracts';
 import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
 import type { ZodSchema } from 'zod';

package/src/lib/view-extension/index.d.ts

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

package/src/lib/view-extension/provider.interface.d.ts

@@ -1,4 +1,4 @@
-import { XpertExtensionViewManifest, XpertResolvedViewHostContext, XpertViewActionRequest, XpertViewActionResult, XpertViewDataResult, XpertViewQuery } from '@metad/contracts';
+import { XpertExtensionViewManifest, XpertResolvedViewHostContext, XpertViewActionRequest, XpertViewActionResult, XpertViewDataResult, XpertViewQuery } from '@xpert-ai/contracts';
 export interface IXpertViewExtensionProvider {
     supports(context: XpertResolvedViewHostContext): Promise<boolean> | boolean;
     getViewManifests(context: XpertResolvedViewHostContext, slot: string): Promise<XpertExtensionViewManifest[]> | XpertExtensionViewManifest[];

package/src/lib/view-extension/tokens.d.ts

@@ -0,0 +1 @@
+export declare const VIEW_EXTENSION_CACHE_SERVICE_TOKEN = "XPERT_PLUGIN_VIEW_EXTENSION_CACHE_SERVICE";

package/src/lib/workflow/commands/wrap-workflow-node-execution.command.d.ts

@@ -1,4 +1,4 @@
-import { IXpertAgentExecution, JSONValue } from '@metad/contracts';
+import { IXpertAgentExecution, JSONValue } from '@xpert-ai/contracts';
 import { Command } from '@nestjs/cqrs';
 import { Subscriber } from 'rxjs';
 /**

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

@@ -1,6 +1,6 @@
 import { Runnable } from '@langchain/core/runnables';
 import { BaseChannel } from '@langchain/langgraph';
-import { IEnvironment, IWorkflowNode, TWorkflowNodeMeta, TXpertGraph, TWorkflowVarGroup, TXpertParameter, TXpertTeamNode } from '@metad/contracts';
+import { IEnvironment, IWorkflowNode, TWorkflowNodeMeta, TXpertGraph, TWorkflowVarGroup, TXpertParameter, TXpertTeamNode } from '@xpert-ai/contracts';
 import { PromiseOrValue } from '../../types';
 export type TWorkflowNodeParams<TConfig = any> = {
     xpertId: string;

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

@@ -1,4 +1,4 @@
-import { TWorkflowTriggerMeta, TXpertTeamNode } from '@metad/contracts';
+import { TWorkflowTriggerMeta, TXpertTeamNode } from '@xpert-ai/contracts';
 export type TWorkflowTriggerBootstrapMode = 'replay_publish' | 'skip';
 export type TWorkflowTriggerBootstrapConfig = {
     mode: TWorkflowTriggerBootstrapMode;