@xpert-ai/plugin-sdk 3.6.7 → 3.7.1

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

@@ -0,0 +1,16 @@
+/**
+ * Who provided this strategy instance:
+ * - "core": main app providers
+ * - "plugin": runtime loaded plugin providers
+ */
+export type StrategySourceKind = 'core' | 'plugin';
+export interface StrategyEntry<S> {
+    instance: S;
+    /**
+     * Unique id for conflict detection & removal.
+     * For core providers you can use wrapper.id or class name.
+     * For plugin providers use `${org}:${pluginId}@${version}:${className}`
+     */
+    sourceId: string;
+    sourceKind: StrategySourceKind;
+}

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const DataSourceStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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

@@ -155,9 +155,21 @@ export interface ColumnDef {
      */
     isKey: boolean;
     /**
-     * Is required column
+     * Is required column (NOT NULL)
      */
     required?: boolean;
+    /**
+     * Is unique column
+     */
+    unique?: boolean;
+    /**
+     * Auto increment (for number type)
+     */
+    autoIncrement?: boolean;
+    /**
+     * Default value
+     */
+    defaultValue?: string;
     /**
      * length of type for column: varchar, decimal ...
      */
@@ -166,6 +178,14 @@ export interface ColumnDef {
      * fraction of type for decimal
      */
     fraction?: number;
+    /**
+     * Enum values (for ENUM type)
+     */
+    enumValues?: string[];
+    /**
+     * Set values (for SET type)
+     */
+    setValues?: string[];
 }
 export interface CreationTable {
     catalog?: string;
@@ -242,6 +262,14 @@ export declare abstract class BaseSQLQueryRunner<T extends SQLAdapterOptions = S
     get port(): string | number;
     abstract createCatalog?(catalog: string): Promise<void>;
     ping(): Promise<void>;
+    /**
+     * Default implementation for table operations
+     */
+    tableOp(action: DBTableAction, params: DBTableOperationParams, options?: QueryOptions): Promise<any>;
+    /**
+     * Generic type mapping (subclasses can override)
+     */
+    protected mapColumnType(type: string, isKey: boolean, length?: number): string;
 }
 export interface File {
     /** Name of the form field associated with this file. */

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const IntegrationStrategyKey: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const ImageUnderstandingStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const KnowledgeStrategyKey: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const RetrieverStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const DocumentSourceStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const TextSplitterStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const DocumentTransformerStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/src/lib/strategy.d.ts

@@ -1,12 +1,38 @@
 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;
     protected reflector: Reflector;
-    protected strategies: Map<string, S>;
+    private readonly logger;
+    protected readonly bus: StrategyBus;
+    protected strategies: Map<string, Map<string, S>>;
+    protected pluginStrategies: Map<string, Set<string>>;
     constructor(strategyKey: string, discoveryService: DiscoveryService, reflector: Reflector);
     onModuleInit(): void;
-    get(type: string): S;
-    list(): S[];
+    upsert(instance: any): void;
+    /**
+     * Remove all strategies registered by the given plugin for the given organization.
+     */
+    remove(organizationId: string, pluginName: string): void;
+    /**
+     * Resolve organization id, falling back to request context org or global scope.
+     */
+    protected resolveOrganization(organizationId?: string): string;
+    /**
+     * Get strategy by type from the given organization including global strategies as fallback.
+     *
+     * @param type
+     * @param organizationId
+     * @returns
+     */
+    get(type: string, organizationId?: string): S;
+    /**
+     * List all strategies for the given organization including global strategies, or only global strategies if global org is specified.
+     *
+     * @param organizationId
+     * @returns
+     */
+    list(organizationId?: string): S[];
 }

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const ToolsetStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/src/lib/types.d.ts

@@ -1,6 +1,10 @@
 import { PluginMeta } from '@metad/contracts';
 import type { DynamicModule, INestApplicationContext } from '@nestjs/common';
 import type { ZodSchema } from 'zod';
+export declare const ORGANIZATION_METADATA_KEY = "xpert:organizationId";
+export declare const PLUGIN_METADATA_KEY = "xpert:pluginName";
+export declare const GLOBAL_ORGANIZATION_SCOPE = "global";
+export declare const STRATEGY_META_KEY = "XPERT_STRATEGY_META_KEY";
 export interface PluginLifecycle {
     /** Called after module registration but before application startup */
     onInit?(ctx: PluginContext): Promise<void> | void;

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) => import("@nestjs/common").CustomDecorator<string>;
+export declare const VectorStoreStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/src/lib/workflow/commands/index.d.ts

@@ -0,0 +1 @@
+export * from './wrap-workflow-node-execution.command';

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

@@ -0,0 +1,26 @@
+import { IXpertAgentExecution, JSONValue } from '@metad/contracts';
+import { Command } from '@nestjs/cqrs';
+import { Subscriber } from 'rxjs';
+/**
+ * Wrap Workflow Node Execution Command
+ */
+export declare class WrapWorkflowNodeExecutionCommand<T = any> extends Command<T> {
+    readonly fuc: (execution: Partial<IXpertAgentExecution>) => Promise<{
+        output?: string | JSONValue;
+        state: T;
+    }>;
+    readonly params: {
+        execution: Partial<IXpertAgentExecution>;
+        subscriber?: Subscriber<MessageEvent>;
+        catchError?: (error: Error) => Promise<void>;
+    };
+    static readonly type = "[Workflow] Wrap Workflow Node Execution";
+    constructor(fuc: (execution: Partial<IXpertAgentExecution>) => Promise<{
+        output?: string | JSONValue;
+        state: T;
+    }>, params: {
+        execution: Partial<IXpertAgentExecution>;
+        subscriber?: Subscriber<MessageEvent>;
+        catchError?: (error: Error) => Promise<void>;
+    });
+}

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

@@ -1,2 +1,3 @@
 export * from './trigger/index';
 export * from './node/index';
+export * from './commands/index';

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

@@ -2,4 +2,4 @@ export declare const WORKFLOW_NODE_STRATEGY = "WORKFLOW_NODE_STRATEGY";
 /**
  * Decorator to mark a provider as a Workflow Node Strategy
  */
-export declare const WorkflowNodeStrategy: (provider: string) => import("@nestjs/common").CustomDecorator<string>;
+export declare const WorkflowNodeStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

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

@@ -1,2 +1,2 @@
 export declare const WORKFLOW_TRIGGER_STRATEGY = "WORKFLOW_TRIGGER_STRATEGY";
-export declare const WorkflowTriggerStrategy: (provider: string) => import("@nestjs/common").CustomDecorator<string>;
+export declare const WorkflowTriggerStrategy: (provider: string) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;