@xpert-ai/plugin-sdk 3.8.4 → 3.9.0-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.8.4",
+  "version": "3.9.0-beta.1",
   "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,12 +31,10 @@
     "i18next": "*",
     "json-schema": "*",
     "jsonwebtoken": "*",
-    "fs": "*",
-    "path": "*",
     "passport-jwt": "*",
     "rxjs": "*",
-    "stream": "*",
     "yaml": "*",
     "zod": "*"
-  }
-}
+  },
+  "types": "./index.d.ts"
+}

package/src/index.d.ts

@@ -16,3 +16,4 @@ export * from './lib/channel/index';
 export * from './lib/file/index';
 export * from './lib/strategy';
 export * from './lib/sandbox/index';
+export * from './lib/view-extension/index';

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/handoff/handoff-processor.decorator.d.ts

@@ -8,4 +8,4 @@ export declare const HANDOFF_PROCESSOR_STRATEGY = "HANDOFF_PROCESSOR_STRATEGY";
  * 1) Which message types it handles
  * 2) Default execution policy (lane/timeout)
  */
-export declare function HandoffProcessorStrategy(provider: string, metadata: HandoffProcessorMetadata): <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare function HandoffProcessorStrategy(provider: string, metadata: HandoffProcessorMetadata): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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

@@ -1,2 +1,3 @@
+export * from './skill/index';
 export * from './middleware';
 export * from './handoff';

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.decorator.d.ts

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

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.decorator.d.ts

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

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,6 +1,4 @@
-/// <reference types="node" />
-/// <reference types="node" />
-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,6 +1,5 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { 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 {
@@ -11,6 +10,8 @@ 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 currentApiKey(): IApiKey | null;
+    static currentApiPrincipal(): IApiPrincipal | null;
     static currentRequest(): IncomingMessage;
     static currentTenantId(): string;
     static currentUserId(): string;
@@ -22,7 +23,11 @@ export declare class RequestContext {
      * @returns The language code (LanguagesEnum) extracted from the headers, or the default language (ENGLISH) if not found.
      */
     static getLanguageCode(): LanguagesEnum;
-    static getOrganizationId(): string;
+    static getScope(): IRequestScopeContext;
+    static getOrganizationId(): string | null;
+    static isTenantScope(): boolean;
+    static isOrganizationScope(): boolean;
+    static requireOrganizationScope(): string;
     static hasPermissions(findPermissions: Array<PermissionsEnum | string>, throwError?: boolean): boolean;
     static hasAnyPermission(findPermissions: PermissionsEnum[], throwError?: boolean): boolean;
     static currentToken(throwError?: boolean): any;

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

@@ -1,5 +1,4 @@
-/// <reference types="node" />
-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

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { FileSystemPermission } from './permissions';
 /**
  * Restricted FileSystem based on granted permissions
@@ -35,7 +33,7 @@ export declare class XpFileSystem {
     /**
      * Read file contents
      */
-    readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer>;
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<NonSharedBuffer>;
     /**
      * Write file contents
      */
@@ -52,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/analytics.d.ts

@@ -1,4 +1,3 @@
-import type { DSCoreService } from '@metad/ocap-core';
 import type { BasePermission } from './general';
 export type AnalyticsPermissionOperation = 'dscore' | 'query' | 'model' | 'indicator' | 'create_indicator';
 /**
@@ -37,9 +36,9 @@ export interface AnalyticsIndicatorValidationInput {
 /**
  * Analytics service exposed to plugins under permission control.
  */
-export interface AnalyticsPermissionService {
+export interface AnalyticsPermissionService<TDSCoreService = unknown> {
     resolveChatBIModels(modelIds: string[]): Promise<AnalyticsResolvedChatBIModel[]>;
-    getDSCoreService(input?: AnalyticsDSCoreInput): Promise<DSCoreService>;
+    getDSCoreService(input?: AnalyticsDSCoreInput): Promise<TDSCoreService>;
     visitChatBIModel(modelId: string, cubeName: string): Promise<void>;
     ensureCreateIndicatorAccess(): Promise<void>;
     validateIndicatorStatement(input: AnalyticsIndicatorValidationInput): Promise<void>;

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/strategy.decorator.d.ts

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

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

@@ -1,10 +1,7 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 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.decorator.d.ts

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

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

@@ -1,6 +1,4 @@
-/// <reference types="node" />
-/// <reference types="node" />
-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.decorator.d.ts

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

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

@@ -1,6 +1,4 @@
-/// <reference types="node" />
-/// <reference types="node" />
-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.decorator.d.ts

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

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.decorator.d.ts

@@ -2,4 +2,4 @@ export declare const IMAGE_UNDERSTANDING_STRATEGY = "IMAGE_UNDERSTANDING_STRATEG
 /**
  * Decorator to mark a provider as an Image Understanding Strategy
  */
-export declare const ImageUnderstandingStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare const ImageUnderstandingStrategy: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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.decorator.d.ts

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

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.decorator.d.ts

@@ -2,4 +2,4 @@ export declare const RETRIEVER_STRATEGY = "RETRIEVER_STRATEGY";
 /**
  * Decorator to mark a provider as a Retriever Strategy
  */
-export declare const RetrieverStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare const RetrieverStrategy: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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.decorator.d.ts

@@ -2,4 +2,4 @@ export declare const DOCUMENT_SOURCE_STRATEGY = "DOCUMENT_SOURCE_STRATEGY";
 /**
  * Decorator to mark a provider as a Document Source Strategy
  */
-export declare const DocumentSourceStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare const DocumentSourceStrategy: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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.decorator.d.ts

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

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.decorator.d.ts

@@ -2,4 +2,4 @@ export declare const DOCUMENT_TRANSFORMER_STRATEGY = "DOCUMENT_TRANSFORMER_STRAT
 /**
  * Decorator to mark a provider as a Document Transformer Strategy
  */
-export declare const DocumentTransformerStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare const DocumentTransformerStrategy: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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,3 +1,4 @@
+import { IBackendProtocol, TSandboxConfigurable } from '@xpert-ai/contracts';
 import type { SandboxExecutionOptions } from './execution';
 /**
  * Protocol definition for pluggable memory backends.
@@ -190,7 +191,7 @@ export interface FileUploadResponse {
  * Methods can return either direct values or Promises, allowing both
  * synchronous and asynchronous implementations.
  */
-export interface BackendProtocol {
+export interface BackendProtocol extends IBackendProtocol {
     /**
      * Structured listing with file metadata.
      *
@@ -346,13 +347,8 @@ export interface SandboxBackendProtocol extends BackendProtocol {
     /** Canonical sandbox environment identifier bound to this backend */
     readonly environmentId?: string | null;
 }
-/**
- * Type guard to check if a backend supports execution.
- *
- * @param backend - Backend instance to check
- * @returns True if the backend implements SandboxBackendProtocol
- */
-export declare function isSandboxBackend(backend: BackendProtocol): backend is SandboxBackendProtocol;
+export declare function isSandboxBackend(backend: unknown): backend is SandboxBackendProtocol;
+export declare function resolveSandboxBackend(sandbox: TSandboxConfigurable | SandboxBackendProtocol | null | undefined | unknown): SandboxBackendProtocol | null;
 /**
  * State and store container for backend initialization.
  *

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

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

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/strategy.d.ts

@@ -1,6 +1,6 @@
-import { OnModuleInit } from "@nestjs/common";
-import { DiscoveryService, Reflector } from "@nestjs/core";
-import { StrategyBus } from "./core/strategy-bus";
+import { OnModuleInit } from '@nestjs/common';
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { StrategyBus } from './core/strategy-bus';
 export declare class BaseStrategyRegistry<S> implements OnModuleInit {
     protected readonly strategyKey: string;
     protected discoveryService: DiscoveryService;

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.decorator.d.ts

@@ -2,4 +2,4 @@ export declare const TOOLSET_STRATEGY = "TOOLSET_STRATEGY";
 /**
  * Decorator to mark a provider as a Toolset Strategy
  */
-export declare const ToolsetStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+export declare const ToolsetStrategy: (provider: string) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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/vectorstore/strategy.decorator.d.ts

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

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

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

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

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

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

@@ -0,0 +1,7 @@
+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[];
+    getViewData(context: XpertResolvedViewHostContext, viewKey: string, query: XpertViewQuery): Promise<XpertViewDataResult> | XpertViewDataResult;
+    executeViewAction?(context: XpertResolvedViewHostContext, viewKey: string, actionKey: string, request: XpertViewActionRequest): Promise<XpertViewActionResult> | XpertViewActionResult;
+}

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

@@ -0,0 +1,10 @@
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { BaseStrategyRegistry } from '../strategy';
+import { IXpertViewExtensionProvider } from './provider.interface';
+export declare class ViewExtensionProviderRegistry extends BaseStrategyRegistry<IXpertViewExtensionProvider> {
+    constructor(discoveryService: DiscoveryService, reflector: Reflector);
+    listEntries(organizationId?: string): Array<{
+        providerKey: string;
+        provider: IXpertViewExtensionProvider;
+    }>;
+}