claude-flow 3.0.0-alpha.24 → 3.0.0-alpha.38

package/v3/@claude-flow/shared/dist/plugin-interface.d.ts

@@ -0,0 +1,544 @@
+/**
+ * V3 Plugin Interface
+ * Domain-Driven Design - Plugin-Based Architecture (ADR-004)
+ *
+ * Microkernel pattern for extensible Claude-Flow V3
+ * Enables modular extension points for agents, tasks, MCP tools, CLI commands, and memory backends
+ */
+import type { IEventBus } from './core/interfaces/event.interface.js';
+import type { IAgentConfig } from './core/interfaces/agent.interface.js';
+import type { MCPTool } from './types/mcp.types.js';
+/**
+ * Logger interface for plugin context
+ */
+export interface ILogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * Service container for dependency injection
+ */
+export interface ServiceContainer {
+    /**
+     * Register a service in the container
+     */
+    register<T>(name: string, service: T): void;
+    /**
+     * Get a service from the container
+     */
+    get<T>(name: string): T | undefined;
+    /**
+     * Check if a service is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered service names
+     */
+    getServiceNames(): string[];
+}
+/**
+ * Plugin configuration
+ */
+export interface PluginConfig {
+    /**
+     * Plugin-specific configuration
+     */
+    [key: string]: unknown;
+    /**
+     * Enable/disable features
+     */
+    features?: Record<string, boolean>;
+    /**
+     * Resource limits
+     */
+    resources?: {
+        maxMemoryMb?: number;
+        maxCpuPercent?: number;
+    };
+}
+/**
+ * Plugin context provided during initialization
+ * Contains services and resources available to plugins
+ */
+export interface PluginContext {
+    /**
+     * Plugin-specific configuration
+     */
+    config: PluginConfig;
+    /**
+     * Event bus for pub/sub communication
+     */
+    eventBus: IEventBus;
+    /**
+     * Logger instance
+     */
+    logger: ILogger;
+    /**
+     * Service container for dependency injection
+     */
+    services: ServiceContainer;
+}
+/**
+ * Agent type definition for plugin registration
+ */
+export interface AgentTypeDefinition {
+    /**
+     * Unique type identifier
+     */
+    type: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Description of agent capabilities
+     */
+    description: string;
+    /**
+     * Default configuration for this agent type
+     */
+    defaultConfig: Partial<IAgentConfig>;
+    /**
+     * Required capabilities for this agent type
+     */
+    requiredCapabilities?: string[];
+    /**
+     * Optional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Task type definition for plugin registration
+ */
+export interface TaskTypeDefinition {
+    /**
+     * Unique type identifier
+     */
+    type: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Description of task purpose
+     */
+    description: string;
+    /**
+     * Default priority (0-100)
+     */
+    defaultPriority: number;
+    /**
+     * Default timeout in milliseconds
+     */
+    defaultTimeout: number;
+    /**
+     * Required agent capabilities to execute this task
+     */
+    requiredCapabilities?: string[];
+    /**
+     * Task input schema (JSON Schema)
+     */
+    inputSchema?: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    /**
+     * Optional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * MCP tool definition for plugin registration
+ */
+export interface MCPToolDefinition extends MCPTool {
+    /**
+     * Plugin that registered this tool
+     */
+    pluginName?: string;
+    /**
+     * Tool version
+     */
+    version?: string;
+    /**
+     * Optional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * CLI command definition for plugin registration
+ */
+export interface CLICommandDefinition {
+    /**
+     * Command name
+     */
+    name: string;
+    /**
+     * Command description
+     */
+    description: string;
+    /**
+     * Command aliases
+     */
+    aliases?: string[];
+    /**
+     * Command options
+     */
+    options?: CLICommandOption[];
+    /**
+     * Command arguments
+     */
+    arguments?: CLICommandArgument[];
+    /**
+     * Command handler function
+     */
+    handler: (args: CLICommandArgs) => Promise<void> | void;
+    /**
+     * Optional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * CLI command option
+ */
+export interface CLICommandOption {
+    /**
+     * Option name (without dashes)
+     */
+    name: string;
+    /**
+     * Short flag (single character)
+     */
+    short?: string;
+    /**
+     * Option description
+     */
+    description: string;
+    /**
+     * Option type
+     */
+    type: 'string' | 'number' | 'boolean';
+    /**
+     * Default value
+     */
+    default?: string | number | boolean;
+    /**
+     * Is this option required?
+     */
+    required?: boolean;
+}
+/**
+ * CLI command argument
+ */
+export interface CLICommandArgument {
+    /**
+     * Argument name
+     */
+    name: string;
+    /**
+     * Argument description
+     */
+    description: string;
+    /**
+     * Is this argument required?
+     */
+    required?: boolean;
+    /**
+     * Default value
+     */
+    default?: string;
+    /**
+     * Allowed values (for validation)
+     */
+    choices?: string[];
+}
+/**
+ * CLI command parsed arguments
+ */
+export interface CLICommandArgs {
+    /**
+     * Positional arguments
+     */
+    _: string[];
+    /**
+     * Named options
+     */
+    [key: string]: unknown;
+}
+/**
+ * Memory backend factory for plugin registration
+ */
+export interface MemoryBackendFactory {
+    /**
+     * Backend name
+     */
+    name: string;
+    /**
+     * Backend description
+     */
+    description: string;
+    /**
+     * Create a new backend instance
+     */
+    create(config: MemoryBackendConfig): Promise<IMemoryBackend>;
+    /**
+     * Backend capabilities
+     */
+    capabilities: {
+        supportsVectorSearch: boolean;
+        supportsFullText: boolean;
+        supportsTransactions: boolean;
+        supportsPersistence: boolean;
+    };
+    /**
+     * Optional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory backend configuration
+ */
+export interface MemoryBackendConfig {
+    /**
+     * Storage path or connection string
+     */
+    path?: string;
+    /**
+     * Backend-specific options
+     */
+    options?: Record<string, unknown>;
+    /**
+     * Resource limits
+     */
+    limits?: {
+        maxMemoryMb?: number;
+        maxStorageMb?: number;
+    };
+}
+/**
+ * Memory backend interface
+ */
+export interface IMemoryBackend {
+    /**
+     * Initialize the backend
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the backend
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Store a memory entry
+     */
+    store(key: string, value: unknown, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Retrieve a memory entry
+     */
+    retrieve(key: string): Promise<unknown | null>;
+    /**
+     * Delete a memory entry
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Search memory entries
+     */
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    /**
+     * Clear all memory entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get backend statistics
+     */
+    getStats(): Promise<MemoryBackendStats>;
+}
+/**
+ * Memory search options
+ */
+export interface MemorySearchOptions {
+    /**
+     * Maximum number of results
+     */
+    limit?: number;
+    /**
+     * Result offset for pagination
+     */
+    offset?: number;
+    /**
+     * Minimum similarity score (0-1)
+     */
+    minScore?: number;
+    /**
+     * Filter by metadata
+     */
+    filter?: Record<string, unknown>;
+}
+/**
+ * Memory search result
+ */
+export interface MemorySearchResult {
+    /**
+     * Memory key
+     */
+    key: string;
+    /**
+     * Memory value
+     */
+    value: unknown;
+    /**
+     * Similarity score (0-1)
+     */
+    score: number;
+    /**
+     * Associated metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Memory backend statistics
+ */
+export interface MemoryBackendStats {
+    /**
+     * Total number of entries
+     */
+    entryCount: number;
+    /**
+     * Total storage size in bytes
+     */
+    sizeBytes: number;
+    /**
+     * Memory usage in bytes
+     */
+    memoryUsageBytes: number;
+    /**
+     * Backend-specific metrics
+     */
+    metrics?: Record<string, number>;
+}
+/**
+ * Core ClaudeFlowPlugin interface
+ * All plugins must implement this interface
+ */
+export interface ClaudeFlowPlugin {
+    /**
+     * Unique plugin name
+     */
+    readonly name: string;
+    /**
+     * Plugin version (semver)
+     */
+    readonly version: string;
+    /**
+     * Optional plugin dependencies
+     * List of plugin names that must be loaded before this plugin
+     */
+    readonly dependencies?: string[];
+    /**
+     * Plugin description
+     */
+    readonly description?: string;
+    /**
+     * Plugin author
+     */
+    readonly author?: string;
+    /**
+     * Initialize the plugin
+     * Called after all dependencies are loaded
+     */
+    initialize(context: PluginContext): Promise<void>;
+    /**
+     * Shutdown the plugin
+     * Called during system shutdown
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Register custom agent types (optional)
+     * @returns Array of agent type definitions
+     */
+    registerAgentTypes?(): AgentTypeDefinition[];
+    /**
+     * Register custom task types (optional)
+     * @returns Array of task type definitions
+     */
+    registerTaskTypes?(): TaskTypeDefinition[];
+    /**
+     * Register MCP tools (optional)
+     * @returns Array of MCP tool definitions
+     */
+    registerMCPTools?(): MCPToolDefinition[];
+    /**
+     * Register CLI commands (optional)
+     * @returns Array of CLI command definitions
+     */
+    registerCLICommands?(): CLICommandDefinition[];
+    /**
+     * Register memory backends (optional)
+     * @returns Array of memory backend factories
+     */
+    registerMemoryBackends?(): MemoryBackendFactory[];
+    /**
+     * Optional health check
+     * @returns true if plugin is healthy, false otherwise
+     */
+    healthCheck?(): Promise<boolean>;
+    /**
+     * Optional plugin metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Plugin lifecycle state
+ */
+export type PluginLifecycleState = 'uninitialized' | 'initializing' | 'initialized' | 'shutting-down' | 'shutdown' | 'error';
+/**
+ * Plugin info for registry tracking
+ */
+export interface PluginInfo {
+    /**
+     * Plugin instance
+     */
+    plugin: ClaudeFlowPlugin;
+    /**
+     * Current lifecycle state
+     */
+    state: PluginLifecycleState;
+    /**
+     * Initialization timestamp
+     */
+    initializedAt?: Date;
+    /**
+     * Shutdown timestamp
+     */
+    shutdownAt?: Date;
+    /**
+     * Plugin context
+     */
+    context?: PluginContext;
+    /**
+     * Error if state is 'error'
+     */
+    error?: Error;
+    /**
+     * Plugin metrics
+     */
+    metrics?: {
+        agentTypesRegistered: number;
+        taskTypesRegistered: number;
+        mcpToolsRegistered: number;
+        cliCommandsRegistered: number;
+        memoryBackendsRegistered: number;
+    };
+}
+/**
+ * Plugin error types
+ */
+export declare class PluginError extends Error {
+    readonly pluginName: string;
+    readonly code: PluginErrorCode;
+    readonly cause?: Error | undefined;
+    constructor(message: string, pluginName: string, code: PluginErrorCode, cause?: Error | undefined);
+}
+export type PluginErrorCode = 'INITIALIZATION_FAILED' | 'SHUTDOWN_FAILED' | 'DEPENDENCY_NOT_FOUND' | 'CIRCULAR_DEPENDENCY' | 'INVALID_PLUGIN' | 'DUPLICATE_PLUGIN' | 'HEALTH_CHECK_FAILED';
+//# sourceMappingURL=plugin-interface.d.ts.map

package/v3/@claude-flow/shared/dist/plugin-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interface.d.ts","sourceRoot":"","sources":["../src/plugin-interface.ts"],"names":[],"mappings":"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"}

package/v3/@claude-flow/shared/dist/plugin-interface.js

@@ -0,0 +1,23 @@
+/**
+ * V3 Plugin Interface
+ * Domain-Driven Design - Plugin-Based Architecture (ADR-004)
+ *
+ * Microkernel pattern for extensible Claude-Flow V3
+ * Enables modular extension points for agents, tasks, MCP tools, CLI commands, and memory backends
+ */
+/**
+ * Plugin error types
+ */
+export class PluginError extends Error {
+    pluginName;
+    code;
+    cause;
+    constructor(message, pluginName, code, cause) {
+        super(message);
+        this.pluginName = pluginName;
+        this.code = code;
+        this.cause = cause;
+        this.name = 'PluginError';
+    }
+}
+//# sourceMappingURL=plugin-interface.js.map

package/v3/@claude-flow/shared/dist/plugin-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-interface.js","sourceRoot":"","sources":["../src/plugin-interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0nBH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IACA;IACA;IAJlB,YACE,OAAe,EACC,UAAkB,EAClB,IAAqB,EACrB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAiB;QACrB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}