@xpert-ai/plugin-sdk 0.0.1 → 0.0.2

package/src/lib/toolset/builtin.ts

@@ -1,111 +0,0 @@
-import { StructuredToolInterface } from '@langchain/core/tools'
-import { BaseStore } from '@langchain/langgraph'
-import {
-	I18nObject,
-	IBuiltinTool,
-	IXpertToolset,
-	ToolProviderCredentials,
-	TToolCredentials,
-	TToolsetParams,
-	XpertToolsetCategoryEnum
-} from '@metad/contracts'
-import { Logger } from '@nestjs/common'
-import { CommandBus, QueryBus } from '@nestjs/cqrs'
-import { BaseToolset } from './toolset'
-
-/**
- * The context params of creating toolset
- */
-export type TBuiltinToolsetParams = TToolsetParams & {
-	commandBus: CommandBus
-	queryBus: QueryBus
-	store?: BaseStore
-}
-
-export interface IBuiltinToolset {
-	validateCredentials(credentials: TToolCredentials): Promise<void>
-}
-
-export abstract class BuiltinToolset<T extends StructuredToolInterface = StructuredToolInterface, C = TToolCredentials>
-	extends BaseToolset<T>
-	implements IBuiltinToolset
-{
-	static provider = ''
-	protected logger = new Logger(this.constructor.name)
-
-	providerType: XpertToolsetCategoryEnum.BUILTIN
-
-	credentialsSchema?: { [key: string]: ToolProviderCredentials }
-
-	get tenantId() {
-		return this.params?.tenantId
-	}
-	get organizationId() {
-		return this.params?.organizationId
-	}
-	get commandBus() {
-		return this.params?.commandBus
-	}
-	get queryBus() {
-		return this.params?.queryBus
-	}
-
-	get xpertId() {
-		return this.params?.xpertId
-	}
-
-	constructor(
-		public providerName: string,
-		protected toolset?: IXpertToolset,
-		protected override params?: TBuiltinToolsetParams
-	) {
-		super(params)
-	}
-
-	async validateCredentials(credentials: C): Promise<void> {
-		await this._validateCredentials(credentials)
-	}
-
-	async _validateCredentials(credentials: C) {
-		throw new Error('Method not implemented.')
-	}
-
-	getId() {
-		return this.toolset?.id
-	}
-
-	getCredentials() {
-		return this.toolset?.credentials as C
-	}
-
-	getToolTitle(name: string): string | I18nObject {
-		const tool = this.toolset?.tools?.find((tool) => tool.name === name)
-		const identity = (<IBuiltinTool>tool?.schema)?.identity
-		if (identity) {
-			return identity.label
-		}
-		return null
-	}
-
-	/**
-	 * Get credentials schema
-	 *
-	 * @returns Credentials schema
-	 */
-	getCredentialsSchema(): { [key: string]: ToolProviderCredentials } {
-		return { ...this.credentialsSchema }
-	}
-
-	/**
-	 * Get toolset entity
-	 *
-	 * @returns XpertToolset
-	 */
-	getToolset() {
-		return this.toolset
-	}
-
-	getName() {
-		return this.getToolset()?.name
-	}
-}

package/src/lib/toolset/index.ts

@@ -1,5 +0,0 @@
-export * from './strategy.decorator'
-export * from './strategy.interface'
-export * from './strategy.registry'
-export * from './builtin'
-export * from './toolset'

package/src/lib/toolset/strategy.decorator.ts

@@ -1,9 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const TOOLSET_STRATEGY = 'TOOLSET_STRATEGY';
-
-/**
- * Decorator to mark a provider as a Toolset Strategy
- */
-export const ToolsetStrategy = (provider: string) =>
-  SetMetadata(TOOLSET_STRATEGY, provider);

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

@@ -1,32 +0,0 @@
-import { DynamicStructuredTool } from '@langchain/core/tools'
-import { I18nObject } from '@metad/contracts'
-import { ZodSchema } from 'zod'
-import { BuiltinToolset } from './builtin'
-
-export interface IToolsetStrategy<TConfig = any> {
-  /**
-   * Metadata about this toolset
-   */
-  readonly meta: {
-    author: string // author name
-    tags: string[] // tags for categorization
-    name: string // unique key
-    label: I18nObject // i18n label
-    description?: I18nObject // optional i18n description
-    configSchema: any // JSON schema for config validation
-    icon?: {
-      svg?: string
-      png?: string // base64 encoded png image
-      color?: string
-    }
-  }
-
-  /**
-   * Validate the configuration
-   */
-  validateConfig(config: TConfig): Promise<void>
-
-  create(config: TConfig): Promise<BuiltinToolset>
-
-  createTools(): DynamicStructuredTool<ZodSchema>[]
-}

package/src/lib/toolset/strategy.registry.ts

@@ -1,17 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { DiscoveryService, Reflector } from '@nestjs/core';
-import { TOOLSET_STRATEGY } from './strategy.decorator';
-import { IToolsetStrategy } from './strategy.interface';
-import { BaseStrategyRegistry } from '../strategy';
-
-@Injectable()
-export class ToolsetRegistry<TConfig = any>
-  extends BaseStrategyRegistry<IToolsetStrategy<TConfig>> 
-{
-  constructor(
-    discoveryService: DiscoveryService,
-    reflector: Reflector
-  ) {
-    super(TOOLSET_STRATEGY, discoveryService, reflector);
-  }
-}

package/src/lib/toolset/toolset.ts

@@ -1,76 +0,0 @@
-import { BaseToolkit, StructuredTool, StructuredToolInterface } from "@langchain/core/tools"
-import { I18nObject, TStateVariable, TToolsetParams } from "@metad/contracts"
-import { z } from 'zod'
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type ZodObjectAny = z.ZodObject<any, any, any, any>;
-
-/**
- * Base ability for all toolsets
- */
-export abstract class BaseToolset<T extends StructuredToolInterface = StructuredToolInterface> extends BaseToolkit {
-	abstract providerName: string
-	// For Langchain
-	tools: T[]
-	// For Langgraph
-	stateVariables: TStateVariable[]
-
-	constructor(protected params?: TToolsetParams) {
-		super()
-	}
-
-	/**
-	 * Async init tools
-	 *
-	 * @returns
-	 */
-	async initTools() {
-		return this.tools
-	}
-
-	/**
-	 * Get ID of the toolset
-	 */
-	abstract getId(): string
-	/**
-	 * Get name of the toolset
-	 */
-	abstract getName(): string
-
-	/**
-	 * Get one tool
-	 *
-	 * @param toolName
-	 * @returns
-	 */
-	getTool(toolName: string) {
-		return this.getTools()?.find((tool) => tool.name === toolName)
-	}
-
-	/**
-	 * Get state variables config
-	 *
-	 * @returns State variables
-	 */
-	async getVariables(): Promise<TStateVariable[]> {
-		return null
-	}
-
-	/**
-	 * Get title of tool
-	 */
-	abstract getToolTitle(name: string): string | I18nObject
-
-	/**
-     * Close all (connections).
-     */
-    async close(): Promise<void> {
-		//
-	}
-}
-
-export abstract class BaseTool<T extends ZodObjectAny = ZodObjectAny> extends StructuredTool<T> {
-	schema: any = z
-		.object({ input: z.string().optional() })
-		.transform((obj) => obj.input)
-}

package/src/lib/types.ts

@@ -1,47 +0,0 @@
-import { PluginMeta } from '@metad/contracts';
-import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
-import type { ZodSchema } from 'zod';
-
-export interface PluginLifecycle {
-  /** 在模块注册完成但应用启动前调用 */
-  onInit?(ctx: PluginContext): Promise<void> | void;
-  /** 在应用启动后调用（可开始对外服务） */
-  onStart?(ctx: PluginContext): Promise<void> | void;
-  /** 优雅停机时调用 */
-  onStop?(ctx: PluginContext): Promise<void> | void;
-}
-
-export interface PluginHealth {
-  /** 返回健康状态与可选的依赖检查详情 */
-  checkHealth?(ctx: PluginContext): Promise<{ status: 'up' | 'down'; details?: any }> | { status: 'up' | 'down'; details?: any };
-}
-
-export interface PluginConfigSpec<T extends object = any> {
-  /** 插件级配置的 zod 校验 schema（可选） */
-  schema?: ZodSchema<T>;
-  /** 默认配置 */
-  defaults?: Partial<T>;
-}
-
-export interface XpertPlugin<TConfig extends object = any> extends PluginLifecycle, PluginHealth {
-  meta: PluginMeta;
-  config?: PluginConfigSpec<TConfig>;
-  /** 返回要挂载到主应用的 DynamicModule（可设为 global） */
-  register(ctx: PluginContext<TConfig>): DynamicModule;
-}
-
-export interface PluginContext<TConfig extends object = any> {
-  app: INestApplicationContext;      // Nest 运行时上下文（启动后注入）
-  logger: PluginLogger;              // SDK 提供的 Logger 包装
-  config: TConfig;                   // 校验合并后的最终配置
-  /** 访问容器中其他 Provider 的辅助方法 */
-  resolve<TInput = any, TResult = TInput>(token: any): TResult;
-}
-
-export interface PluginLogger {
-  child(meta: Record<string, any>): PluginLogger;
-  debug(msg: string, meta?: any): void;
-  log(msg: string, meta?: any): void;
-  warn(msg: string, meta?: any): void;
-  error(msg: string, meta?: any): void;
-}

package/src/lib/vectorstore/index.ts

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

package/src/lib/vectorstore/strategy.decorator.ts

@@ -1,6 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const VECTOR_STORE_STRATEGY = 'VECTOR_STORE_STRATEGY';
-
-export const VectorStoreStrategy = (provider: string) =>
-  SetMetadata(VECTOR_STORE_STRATEGY, provider);

package/src/lib/vectorstore/strategy.interface.ts

@@ -1,25 +0,0 @@
-import { EmbeddingsInterface } from '@langchain/core/embeddings'
-import { VectorStore } from '@langchain/core/vectorstores'
-
-/**
- * Interface for VectorStore strategy。
- * 
- * 
- */
-export interface IVectorStoreStrategy<TConfig extends {collectionName?: string}> {
-  /**
-   * Metadata about the strategy
-   */
-  readonly name: string;
-  readonly description?: string;
-
-  /**
-   * Validate configuration for VectorStore
-   */
-  validateConfig(config: TConfig): Promise<void>;
-
-  /**
-   * Create a VectorStore with given config
-   */
-  createStore(embeddings: EmbeddingsInterface, config: TConfig): Promise<VectorStore>;
-}

package/src/lib/vectorstore/strategy.registry.ts

@@ -1,17 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { DiscoveryService, Reflector } from '@nestjs/core';
-import { BaseStrategyRegistry } from '../strategy';
-import { VECTOR_STORE_STRATEGY } from './strategy.decorator';
-import { IVectorStoreStrategy } from './strategy.interface';
-
-@Injectable()
-export class VectorStoreRegistry<TConfig = any>
-  extends BaseStrategyRegistry<IVectorStoreStrategy<TConfig>> 
-{
-  constructor(
-    discoveryService: DiscoveryService,
-    reflector: Reflector
-  ) {
-    super(VECTOR_STORE_STRATEGY, discoveryService, reflector);
-  }
-}

package/src/lib/workflow/index.ts

@@ -1,2 +0,0 @@
-export * from './trigger/index'
-export * from './node/index'

package/src/lib/workflow/node/index.ts

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

package/src/lib/workflow/node/strategy.decorator.ts

@@ -1,9 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const WORKFLOW_NODE_STRATEGY = 'WORKFLOW_NODE_STRATEGY';
-
-/**
- * Decorator to mark a provider as a Workflow Node Strategy
- */
-export const WorkflowNodeStrategy = (provider: string) =>
-  SetMetadata(WORKFLOW_NODE_STRATEGY, provider);

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

@@ -1,49 +0,0 @@
-import { Runnable } from '@langchain/core/runnables'
-import { BaseChannel } from '@langchain/langgraph'
-import {
-  IEnvironment,
-  IWorkflowNode,
-  TWorkflowNodeMeta,
-  TXpertGraph,
-  TXpertParameter,
-  TXpertTeamNode
-} from '@metad/contracts'
-
-export type TWorkflowNodeParams<TConfig = any> = {
-  xpertId: string
-  agentKey?: string
-  node: TXpertTeamNode
-  config: TConfig
-}
-
-/**
- * Workflow Node Strategy interface
- */
-export interface IWorkflowNodeStrategy<TConfig = any, TResult = any> {
-  /**
-   * Metadata describing the node (type, label, description, config schema, etc.)
-   */
-  meta: TWorkflowNodeMeta
-
-  /**
-   * Create the node subgraph
-   */
-  create(payload: {
-    graph: TXpertGraph
-    node: TXpertTeamNode & { type: 'workflow' }
-    xpertId: string
-    environment: IEnvironment
-    isDraft: boolean
-  }): {
-    name?: string
-    graph: Runnable
-    ends: string[]
-    channel: {
-      name: string
-      annotation: BaseChannel
-    }
-    navigator?: (state, config) => Promise<any>
-  }
-
-  outputVariables(entity: IWorkflowNode): TXpertParameter[]
-}

package/src/lib/workflow/node/strategy.registry.ts

@@ -1,18 +0,0 @@
-import { Injectable } from '@nestjs/common';
-import { DiscoveryService, Reflector } from '@nestjs/core';
-import { BaseStrategyRegistry } from '../../strategy';
-import { WORKFLOW_NODE_STRATEGY } from './strategy.decorator';
-import { IWorkflowNodeStrategy } from './strategy.interface';
-
-/**
- * Registry for Workflow Node Strategies
- */
-@Injectable()
-export class WorkflowNodeRegistry<TConfig = any, TResult = any> extends BaseStrategyRegistry<IWorkflowNodeStrategy<TConfig, TResult>> {
-  constructor(
-    discoveryService: DiscoveryService,
-    reflector: Reflector
-  ) {
-    super(WORKFLOW_NODE_STRATEGY, discoveryService, reflector);
-  }
-}

package/src/lib/workflow/trigger/index.ts

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

package/src/lib/workflow/trigger/strategy.decorator.ts

@@ -1,6 +0,0 @@
-import { SetMetadata } from '@nestjs/common';
-
-export const WORKFLOW_TRIGGER_STRATEGY = 'WORKFLOW_TRIGGER_STRATEGY';
-
-export const WorkflowTriggerStrategy = (provider: string) =>
-  SetMetadata(WORKFLOW_TRIGGER_STRATEGY, provider);

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

@@ -1,27 +0,0 @@
-import { TWorkflowTriggerMeta, TXpertTeamNode } from '@metad/contracts'
-
-export type TWorkflowTriggerParams<T> = {
-  xpertId: string
-  agentKey?: string
-  node?: TXpertTeamNode
-  config: T
-}
-
-export interface IWorkflowTriggerStrategy<T> {
-  meta: TWorkflowTriggerMeta
-
-  validate(payload: TWorkflowTriggerParams<T>): Promise<any[]>
-
-  /**
-   * Initialize the trigger when publish xpert workflow
-   * 
-   * @param payload 
-   * @param callback 
-   */
-  publish(payload: TWorkflowTriggerParams<T>, callback: (payload: any) => void): Promise<any> | void
-
-  /**
-   * Stop the trigger
-   */
-  stop(payload: TWorkflowTriggerParams<T>): void;
-}

package/src/lib/workflow/trigger/strategy.registry.ts

@@ -1,17 +0,0 @@
-import { Injectable } from '@nestjs/common'
-import { DiscoveryService, Reflector } from '@nestjs/core'
-import { BaseStrategyRegistry } from '../../strategy'
-import { WORKFLOW_TRIGGER_STRATEGY } from './strategy.decorator'
-import { IWorkflowTriggerStrategy } from './strategy.interface'
-
-@Injectable()
-export class WorkflowTriggerRegistry<T = any> extends BaseStrategyRegistry<IWorkflowTriggerStrategy<T>> {
-
-	constructor(
-		discoveryService: DiscoveryService,
-		reflector: Reflector
-	) {
-		super(WORKFLOW_TRIGGER_STRATEGY, discoveryService, reflector);
-	}
-
-}

package/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "module": "commonjs",
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "noImplicitOverride": true,
-    "noPropertyAccessFromIndexSignature": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true
-  },
-  "files": [],
-  "include": [],
-  "references": [
-    {
-      "path": "./tsconfig.lib.json"
-    },
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ]
-}

package/tsconfig.lib.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "declaration": true,
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
-}

package/tsconfig.spec.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "outDir": "../../dist/out-tsc",
-    "module": "commonjs",
-    "types": ["jest", "node"]
-  },
-  "include": ["jest.config.ts", "src/**/*.test.ts", "src/**/*.spec.ts", "src/**/*.d.ts"]
-}