agentic-qe 2.1.1 → 2.2.0

package/dist/core/di/AgentDependencies.d.ts

@@ -0,0 +1,127 @@
+/**
+ * AgentDependencies - Pre-configured dependencies for QE agents
+ *
+ * Provides factory functions and registration helpers for common
+ * agent dependencies including LLM providers, learning engines,
+ * and memory stores.
+ *
+ * @module core/di/AgentDependencies
+ * @version 1.0.0
+ */
+import { DIContainer, DependencyConfig } from './DIContainer';
+import { ExperienceSharingConfig } from '../../learning/ExperienceSharingProtocol';
+import { RLAlgorithmType } from '../../learning/algorithms';
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+/**
+ * Well-known dependency names
+ */
+export declare const DependencyNames: {
+    readonly LLM_PROVIDER: "llmProvider";
+    readonly LLM_FACTORY: "llmProviderFactory";
+    readonly CLAUDE_PROVIDER: "claudeProvider";
+    readonly RUVLLM_PROVIDER: "ruvllmProvider";
+    readonly LEARNING_ENGINE: "learningEngine";
+    readonly RL_ALGORITHM: "rlAlgorithm";
+    readonly EXPERIENCE_SHARING: "experienceSharing";
+    readonly MEMORY_STORE: "memoryStore";
+    readonly SWARM_MEMORY: "swarmMemory";
+    readonly LOGGER: "logger";
+    readonly EVENT_BUS: "eventBus";
+};
+/**
+ * Configuration for agent dependency setup
+ */
+export interface AgentDependencyConfig {
+    /** Agent ID for scoped dependencies */
+    agentId: string;
+    /** Enable LLM provider (default: true) */
+    enableLLM?: boolean;
+    /** Preferred LLM provider type */
+    llmProvider?: 'claude' | 'ruvllm' | 'hybrid';
+    /** Enable learning system (default: true) */
+    enableLearning?: boolean;
+    /** RL algorithm to use */
+    rlAlgorithm?: RLAlgorithmType;
+    /** Enable experience sharing (default: false) */
+    enableExperienceSharing?: boolean;
+    /** Experience sharing config */
+    experienceSharingConfig?: Partial<ExperienceSharingConfig>;
+    /** Custom memory store */
+    memoryStore?: SwarmMemoryManager;
+}
+/**
+ * Register standard agent dependencies in a container
+ */
+export declare function registerAgentDependencies(container: DIContainer, config: AgentDependencyConfig): Promise<void>;
+/**
+ * Create a pre-configured container for an agent
+ */
+export declare function createAgentContainer(config: AgentDependencyConfig, parent?: DIContainer): Promise<DIContainer>;
+/**
+ * Interface for DI-enabled agents
+ */
+export interface IDIAgent {
+    /** Get the DI container */
+    getDIContainer(): DIContainer;
+    /** Set the DI container */
+    setDIContainer(container: DIContainer): void;
+    /** Resolve a dependency */
+    resolveDependency<D>(name: string): Promise<D>;
+    /** Try to resolve a dependency */
+    tryResolveDependency<D>(name: string): Promise<D | undefined>;
+    /** Register a dependency */
+    registerDependency<D>(name: string, config: DependencyConfig<D>): void;
+    /** Register an instance */
+    registerDependencyInstance<D>(name: string, instance: D): void;
+}
+/**
+ * Dependency injection mixin for BaseAgent
+ *
+ * Adds DI capabilities to BaseAgent without modifying the class directly.
+ *
+ * Usage:
+ * ```typescript
+ * class MyAgent extends withDI(BaseAgent) {
+ *   async initialize() {
+ *     await super.initialize();
+ *     const llm = await this.resolveDependency<ILLMProvider>('llmProvider');
+ *   }
+ * }
+ * ```
+ */
+export declare function withDI<T extends new (...args: any[]) => any>(Base: T): {
+    new (...args: any[]): {
+        [x: string]: any;
+        /** @internal DI container - use getDIContainer() instead */
+        __diContainer?: DIContainer;
+        /**
+         * Get or create the DI container for this agent
+         */
+        getDIContainer(): DIContainer;
+        /**
+         * Set the DI container (for external configuration)
+         */
+        setDIContainer(container: DIContainer): void;
+        /**
+         * Resolve a dependency from the container
+         */
+        resolveDependency<D>(name: string): Promise<D>;
+        /**
+         * Try to resolve a dependency (returns undefined if not found)
+         */
+        tryResolveDependency<D>(name: string): Promise<D | undefined>;
+        /**
+         * Register a dependency in the container
+         */
+        registerDependency<D>(name: string, config: DependencyConfig<D>): void;
+        /**
+         * Register an instance directly
+         */
+        registerDependencyInstance<D>(name: string, instance: D): void;
+        /**
+         * Dispose the container on agent termination
+         */
+        terminate(): Promise<void>;
+    };
+} & T;
+//# sourceMappingURL=AgentDependencies.d.ts.map

package/dist/core/di/AgentDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDependencies.d.ts","sourceRoot":"","sources":["../../../src/core/di/AgentDependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAA6B,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAC9G,OAAO,EAAwC,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;CAmBlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,iDAAiD;IACjD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gCAAgC;IAChC,uBAAuB,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3D,0BAA0B;IAC1B,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AA4HD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAItB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,cAAc,IAAI,WAAW,CAAC;IAC9B,2BAA2B;IAC3B,cAAc,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7C,2BAA2B;IAC3B,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,kCAAkC;IAClC,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC9D,4BAA4B;IAC5B,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvE,2BAA2B;IAC3B,0BAA0B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;kBAAtB,GAAG,EAAE;;QAEhD,4DAA4D;wBAC5C,WAAW;QAE3B;;WAEG;0BACe,WAAW;QAO7B;;WAEG;kCACuB,WAAW,GAAG,IAAI;QAI5C;;WAEG;0BACqB,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;QAIpD;;WAEG;6BACwB,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;QAInE;;WAEG;2BACgB,CAAC,QAAQ,MAAM,UAAU,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;QAItE;;WAEG;mCACwB,CAAC,QAAQ,MAAM,YAAY,CAAC,GAAG,IAAI;QAI9D;;WAEG;qBACgB,OAAO,CAAC,IAAI,CAAC;;MAWnC"}

package/dist/core/di/AgentDependencies.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * AgentDependencies - Pre-configured dependencies for QE agents
+ *
+ * Provides factory functions and registration helpers for common
+ * agent dependencies including LLM providers, learning engines,
+ * and memory stores.
+ *
+ * @module core/di/AgentDependencies
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyNames = void 0;
+exports.registerAgentDependencies = registerAgentDependencies;
+exports.createAgentContainer = createAgentContainer;
+exports.withDI = withDI;
+const DIContainer_1 = require("./DIContainer");
+const providers_1 = require("../../providers");
+const LearningEngine_1 = require("../../learning/LearningEngine");
+const ExperienceSharingProtocol_1 = require("../../learning/ExperienceSharingProtocol");
+const algorithms_1 = require("../../learning/algorithms");
+const Logger_1 = require("../../utils/Logger");
+/**
+ * Well-known dependency names
+ */
+exports.DependencyNames = {
+    // LLM Providers
+    LLM_PROVIDER: 'llmProvider',
+    LLM_FACTORY: 'llmProviderFactory',
+    CLAUDE_PROVIDER: 'claudeProvider',
+    RUVLLM_PROVIDER: 'ruvllmProvider',
+    // Learning
+    LEARNING_ENGINE: 'learningEngine',
+    RL_ALGORITHM: 'rlAlgorithm',
+    EXPERIENCE_SHARING: 'experienceSharing',
+    // Memory
+    MEMORY_STORE: 'memoryStore',
+    SWARM_MEMORY: 'swarmMemory',
+    // Utilities
+    LOGGER: 'logger',
+    EVENT_BUS: 'eventBus'
+};
+/**
+ * Register standard agent dependencies in a container
+ */
+async function registerAgentDependencies(container, config) {
+    const logger = Logger_1.Logger.getInstance();
+    // Register logger
+    container.registerInstance(exports.DependencyNames.LOGGER, logger);
+    // Register LLM providers if enabled
+    if (config.enableLLM !== false) {
+        await registerLLMDependencies(container, config);
+    }
+    // Register learning dependencies if enabled
+    if (config.enableLearning !== false) {
+        await registerLearningDependencies(container, config);
+    }
+    // Register experience sharing if enabled
+    if (config.enableExperienceSharing) {
+        registerExperienceSharingDependency(container, config);
+    }
+    logger.info(`Agent dependencies registered for ${config.agentId}`, {
+        llm: config.enableLLM !== false,
+        learning: config.enableLearning !== false,
+        experienceSharing: config.enableExperienceSharing
+    });
+}
+/**
+ * Register LLM provider dependencies
+ */
+async function registerLLMDependencies(container, config) {
+    // Register LLM Provider Factory
+    container.register(exports.DependencyNames.LLM_FACTORY, {
+        factory: () => new providers_1.LLMProviderFactory({
+            defaultProvider: config.llmProvider === 'ruvllm' ? 'ruvllm' : 'claude',
+            enableFallback: true
+        }),
+        lifecycle: 'singleton',
+        initialize: async (factory) => factory.initialize(),
+        dispose: async (factory) => factory.shutdown()
+    });
+    // Register main LLM provider based on preference
+    container.register(exports.DependencyNames.LLM_PROVIDER, {
+        factory: async (c) => {
+            const factory = await c.resolve(exports.DependencyNames.LLM_FACTORY);
+            switch (config.llmProvider) {
+                case 'ruvllm':
+                    return factory.getProvider('ruvllm') ?? factory.selectBestProvider({ preferLocal: true });
+                case 'hybrid':
+                    return factory.createHybridRouter();
+                case 'claude':
+                default:
+                    return factory.getProvider('claude') ?? factory.selectBestProvider();
+            }
+        },
+        lifecycle: 'singleton',
+        dependencies: [exports.DependencyNames.LLM_FACTORY]
+    });
+    // Register individual providers for direct access
+    container.register(exports.DependencyNames.CLAUDE_PROVIDER, {
+        factory: () => new providers_1.ClaudeProvider(),
+        lifecycle: 'singleton',
+        initialize: async (p) => p.initialize(),
+        dispose: async (p) => p.shutdown()
+    });
+    container.register(exports.DependencyNames.RUVLLM_PROVIDER, {
+        factory: () => new providers_1.RuvllmProvider(),
+        lifecycle: 'singleton',
+        initialize: async (p) => {
+            try {
+                await p.initialize();
+            }
+            catch {
+                // ruvllm may not be available - that's OK
+            }
+        },
+        dispose: async (p) => p.shutdown()
+    });
+}
+/**
+ * Register learning system dependencies
+ */
+async function registerLearningDependencies(container, config) {
+    // Register RL algorithm
+    const algorithmType = config.rlAlgorithm ?? 'sarsa';
+    container.register(exports.DependencyNames.RL_ALGORITHM, {
+        factory: () => (0, algorithms_1.createRLAlgorithm)(algorithmType, {
+            learningRate: 0.1,
+            discountFactor: 0.95,
+            explorationRate: 0.3,
+            explorationDecay: 0.995,
+            minExplorationRate: 0.01,
+            useExperienceReplay: true,
+            replayBufferSize: 10000,
+            batchSize: 32
+        }),
+        lifecycle: 'scoped' // Each agent gets its own RL algorithm
+    });
+    // Register Learning Engine (requires memory store)
+    container.register(exports.DependencyNames.LEARNING_ENGINE, {
+        factory: async (c) => {
+            const memoryStore = config.memoryStore ?? await c.tryResolve(exports.DependencyNames.SWARM_MEMORY);
+            if (!memoryStore) {
+                throw new Error('Memory store required for learning engine');
+            }
+            return new LearningEngine_1.LearningEngine(config.agentId, memoryStore, {
+                enabled: true,
+                learningRate: 0.1,
+                discountFactor: 0.95,
+                explorationRate: 0.3,
+                algorithm: algorithmType
+            });
+        },
+        lifecycle: 'scoped',
+        initialize: async (engine) => engine.initialize()
+    });
+}
+/**
+ * Register experience sharing dependency
+ */
+function registerExperienceSharingDependency(container, config) {
+    container.register(exports.DependencyNames.EXPERIENCE_SHARING, {
+        factory: () => new ExperienceSharingProtocol_1.ExperienceSharingProtocol({
+            agentId: config.agentId,
+            ...config.experienceSharingConfig
+        }),
+        lifecycle: 'scoped',
+        initialize: async (protocol) => protocol.start(),
+        dispose: async (protocol) => protocol.stop()
+    });
+}
+/**
+ * Create a pre-configured container for an agent
+ */
+async function createAgentContainer(config, parent) {
+    const container = new DIContainer_1.DIContainer(parent);
+    await registerAgentDependencies(container, config);
+    return container;
+}
+/**
+ * Dependency injection mixin for BaseAgent
+ *
+ * Adds DI capabilities to BaseAgent without modifying the class directly.
+ *
+ * Usage:
+ * ```typescript
+ * class MyAgent extends withDI(BaseAgent) {
+ *   async initialize() {
+ *     await super.initialize();
+ *     const llm = await this.resolveDependency<ILLMProvider>('llmProvider');
+ *   }
+ * }
+ * ```
+ */
+function withDI(Base) {
+    return class DIAgent extends Base {
+        /**
+         * Get or create the DI container for this agent
+         */
+        getDIContainer() {
+            if (!this.__diContainer) {
+                this.__diContainer = new DIContainer_1.DIContainer();
+            }
+            return this.__diContainer;
+        }
+        /**
+         * Set the DI container (for external configuration)
+         */
+        setDIContainer(container) {
+            this.__diContainer = container;
+        }
+        /**
+         * Resolve a dependency from the container
+         */
+        async resolveDependency(name) {
+            return this.getDIContainer().resolve(name);
+        }
+        /**
+         * Try to resolve a dependency (returns undefined if not found)
+         */
+        async tryResolveDependency(name) {
+            return this.getDIContainer().tryResolve(name);
+        }
+        /**
+         * Register a dependency in the container
+         */
+        registerDependency(name, config) {
+            this.getDIContainer().register(name, config);
+        }
+        /**
+         * Register an instance directly
+         */
+        registerDependencyInstance(name, instance) {
+            this.getDIContainer().registerInstance(name, instance);
+        }
+        /**
+         * Dispose the container on agent termination
+         */
+        async terminate() {
+            if (this.__diContainer) {
+                await this.__diContainer.dispose();
+                this.__diContainer = undefined;
+            }
+            // Call parent terminate if it exists
+            if (super.terminate) {
+                await super.terminate();
+            }
+        }
+    };
+}
+//# sourceMappingURL=AgentDependencies.js.map

package/dist/core/di/AgentDependencies.js.map

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

package/dist/core/di/DIContainer.d.ts

@@ -0,0 +1,149 @@
+/**
+ * DIContainer - Dependency Injection Container for AQE Fleet
+ *
+ * Provides centralized dependency management for:
+ * - LLM providers (Claude, ruvllm, hybrid)
+ * - Learning engines and algorithms
+ * - Memory stores and pattern libraries
+ * - Experience sharing protocols
+ *
+ * Features:
+ * - Singleton and transient lifecycle management
+ * - Lazy initialization
+ * - Hierarchical scopes (agent-level, fleet-level)
+ * - Type-safe dependency resolution
+ *
+ * @module core/di/DIContainer
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+/**
+ * Dependency lifecycle types
+ */
+export type DependencyLifecycle = 'singleton' | 'transient' | 'scoped';
+/**
+ * Dependency registration configuration
+ */
+export interface DependencyConfig<T> {
+    /** Factory function to create instance */
+    factory: (container: DIContainer) => T | Promise<T>;
+    /** Lifecycle management */
+    lifecycle: DependencyLifecycle;
+    /** Optional initialization function */
+    initialize?: (instance: T) => Promise<void>;
+    /** Optional cleanup function */
+    dispose?: (instance: T) => Promise<void>;
+    /** Dependencies required before this one */
+    dependencies?: string[];
+}
+/**
+ * Container scope for hierarchical DI
+ */
+export interface DIScope {
+    id: string;
+    parent?: DIContainer;
+    instances: Map<string, any>;
+}
+/**
+ * DIContainer - Central dependency injection container
+ *
+ * Usage:
+ * ```typescript
+ * const container = new DIContainer();
+ *
+ * // Register dependencies
+ * container.register('llmProvider', {
+ *   factory: () => new ClaudeProvider(),
+ *   lifecycle: 'singleton',
+ *   initialize: async (p) => p.initialize()
+ * });
+ *
+ * // Resolve dependencies
+ * const llm = await container.resolve<ILLMProvider>('llmProvider');
+ * ```
+ */
+export declare class DIContainer extends EventEmitter {
+    private readonly logger;
+    private readonly dependencies;
+    private readonly scopes;
+    private readonly parent?;
+    private isDisposed;
+    constructor(parent?: DIContainer);
+    /**
+     * Register a dependency
+     */
+    register<T>(name: string, config: DependencyConfig<T>): this;
+    /**
+     * Register a singleton instance directly
+     */
+    registerInstance<T>(name: string, instance: T): this;
+    /**
+     * Register a factory function
+     */
+    registerFactory<T>(name: string, factory: (container: DIContainer) => T | Promise<T>, lifecycle?: DependencyLifecycle): this;
+    /**
+     * Resolve a dependency
+     */
+    resolve<T>(name: string, scope?: string): Promise<T>;
+    /**
+     * Try to resolve a dependency (returns undefined if not found)
+     */
+    tryResolve<T>(name: string, scope?: string): Promise<T | undefined>;
+    /**
+     * Check if a dependency is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Create a child scope
+     */
+    createScope(scopeId: string): DIContainer;
+    /**
+     * Dispose a scope and its instances
+     */
+    disposeScope(scopeId: string): Promise<void>;
+    /**
+     * Dispose all dependencies and clean up
+     */
+    dispose(): Promise<void>;
+    /**
+     * Get all registered dependency names
+     */
+    getRegisteredNames(): string[];
+    /**
+     * Resolve a registration
+     */
+    private resolveRegistration;
+    /**
+     * Resolve singleton instance
+     */
+    private resolveSingleton;
+    /**
+     * Resolve scoped instance
+     */
+    private resolveScoped;
+    /**
+     * Resolve transient instance (new instance each time)
+     */
+    private resolveTransient;
+    /**
+     * Create and initialize an instance
+     */
+    private createAndInitialize;
+    /**
+     * Get scoped instance
+     */
+    private getScopedInstance;
+}
+/**
+ * Get the global DI container
+ */
+export declare function getGlobalContainer(): DIContainer;
+/**
+ * Set the global DI container
+ */
+export declare function setGlobalContainer(container: DIContainer): void;
+/**
+ * Reset the global container (for testing)
+ */
+export declare function resetGlobalContainer(): Promise<void>;
+//# sourceMappingURL=DIContainer.d.ts.map

package/dist/core/di/DIContainer.d.ts.map

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