@framers/agentos 0.1.126 → 0.1.128

package/dist/core/agents/AgentFactory.d.ts

@@ -1,119 +0,0 @@
-/**
- * @fileoverview Implements the `IAgentFactory` interface, providing a robust
- * mechanism for creating and managing agent instances within AgentOS.
- * This factory is responsible for:
- * - Loading and storing agent configurations (`AgentConfig`).
- * - Mapping agent type identifiers (from `AgentConfig.type`) to their corresponding
- * agent class constructors (`AgentClassConstructor`).
- * - Instantiating agents by their unique IDs, ensuring all necessary dependencies
- * (like `IPromptEngine`, `AIModelProviderManager`, `IUtilityAI`, and the `IAgentFactory` itself)
- * are correctly injected.
- * - Handling the initialization lifecycle of newly created agents.
- * - Allowing dynamic registration of new agent types.
- *
- * This centralized approach to agent creation promotes modularity, testability,
- * and simplifies the process of extending the system with new agent types.
- * @module backend/agentos/core/agents/AgentFactory
- */
-import { IAgentFactory, AgentDependencies, AgentClassConstructor } from './IAgentFactory';
-import { IAgent } from './IAgent';
-import { AgentConfig } from './AgentCore';
-/**
- * Custom error class for issues specific to agent instantiation or configuration
- * within the `AgentFactory`. This helps in distinguishing factory-related errors
- * from other system errors.
- * @class AgentFactoryError
- * @extends {Error}
- */
-export declare class AgentFactoryError extends Error {
-    /**
-     * A specific error code related to AgentFactory operations.
-     * @type {string}
-     */
-    readonly code: string;
-    /**
-     * The ID of the agent involved in the error, if applicable.
-     * @type {string | undefined}
-     * @optional
-     */
-    readonly agentId?: string;
-    /**
-     * The underlying error that caused this factory error, if any.
-     * @type {Error | undefined}
-     * @optional
-     */
-    readonly underlyingError?: Error;
-    /**
-     * Creates an instance of `AgentFactoryError`.
-     * @param {string} message - The human-readable error message.
-     * @param {string} code - A unique code for the error type (e.g., 'CONFIG_NOT_FOUND', 'CLASS_NOT_REGISTERED', 'INSTANTIATION_FAILED').
-     * @param {string} [agentId] - Optional. The ID of the agent associated with this error.
-     * @param {Error} [underlyingError] - Optional. The original error that was caught and wrapped.
-     */
-    constructor(message: string, code: string, agentId?: string, underlyingError?: Error);
-}
-/**
- * A concrete implementation of `IAgentFactory`.
- * This class is responsible for instantiating `IAgent` implementations based on
- * loaded `AgentConfig` data and a map of registered agent classes. It ensures
- * that agents are created with all their required dependencies.
- *
- * @class AgentFactory
- * @implements {IAgentFactory}
- */
-export declare class AgentFactory implements IAgentFactory {
-    /**
-     * Stores agent configurations, keyed by their unique agent ID.
-     * @private
-     * @type {Record<string, AgentConfig>}
-     */
-    private agentConfigs;
-    /**
-     * Maps agent type identifiers (strings) to their corresponding class constructors.
-     * @private
-     * @type {Record<string, AgentClassConstructor<any>>}
-     */
-    private agentClassMap;
-    /**
-     * Flag indicating whether the factory has been successfully initialized.
-     * @private
-     * @type {boolean}
-     */
-    private isInitialized;
-    /**
-     * Constructs an `AgentFactory`.
-     * Initialization (loading configs and classes) is performed via the `initialize` method.
-     */
-    constructor();
-    /**
-     * Ensures that the factory has been initialized before any operational methods are called.
-     * @private
-     * @throws {AgentFactoryError} If the factory is not initialized.
-     */
-    private ensureInitialized;
-    /**
-     * Initializes the factory with agent configurations and agent class mappings.
-     *
-     * @throws {AgentFactoryError} If `agentConfigs` or `agentClassMap` is null/undefined.
-     */
-    initialize(agentConfigs: Record<string, AgentConfig>, agentClassMap: Record<string, AgentClassConstructor<any>>): Promise<void>;
-    /**
-     * Dynamically registers an agent type and its constructor with the factory.
-     *
-     * @throws {AgentFactoryError} If `agentType` or `constructor` is invalid.
-     */
-    registerAgentClass(agentType: string, constructor: AgentClassConstructor<any>): Promise<void>;
-    /**
-     * Retrieves and initializes an agent instance by its ID.
-     *
-     * @throws {AgentFactoryError} If critical errors occur during instantiation.
-     */
-    getAgent(agentId: string, dependencies: AgentDependencies): Promise<IAgent | undefined>;
-    /**
-     * Lists all agent configurations known to the factory.
-     *
-     * Returns deep copies of the configurations to prevent external modification.
-     */
-    listAvailableAgentConfigs(): Promise<Readonly<AgentConfig[]>>;
-}
-//# sourceMappingURL=AgentFactory.d.ts.map

package/dist/core/agents/AgentFactory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../../../src/core/agents/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,SAAgB,eAAe,CAAC,EAAE,KAAK,CAAC;IAExC;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,KAAK;CAYrF;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAmC;IAEvD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAkD;IAEvE;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAkB;IAEvC;;;OAGG;;IAKH;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;OAIG;IACU,UAAU,CACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,GACxD,OAAO,CAAC,IAAI,CAAC;IA8BhB;;;;OAIG;IACU,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1G;;;;OAIG;IACU,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkGpG;;;;OAIG;IACU,yBAAyB,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;CAkB3E"}

package/dist/core/agents/AgentFactory.js

@@ -1,228 +0,0 @@
-/**
- * @fileoverview Implements the `IAgentFactory` interface, providing a robust
- * mechanism for creating and managing agent instances within AgentOS.
- * This factory is responsible for:
- * - Loading and storing agent configurations (`AgentConfig`).
- * - Mapping agent type identifiers (from `AgentConfig.type`) to their corresponding
- * agent class constructors (`AgentClassConstructor`).
- * - Instantiating agents by their unique IDs, ensuring all necessary dependencies
- * (like `IPromptEngine`, `AIModelProviderManager`, `IUtilityAI`, and the `IAgentFactory` itself)
- * are correctly injected.
- * - Handling the initialization lifecycle of newly created agents.
- * - Allowing dynamic registration of new agent types.
- *
- * This centralized approach to agent creation promotes modularity, testability,
- * and simplifies the process of extending the system with new agent types.
- * @module backend/agentos/core/agents/AgentFactory
- */
-import { AgentType } from './AgentCore.js'; // AgentConfig and AgentType
-/**
- * Custom error class for issues specific to agent instantiation or configuration
- * within the `AgentFactory`. This helps in distinguishing factory-related errors
- * from other system errors.
- * @class AgentFactoryError
- * @extends {Error}
- */
-export class AgentFactoryError extends Error {
-    /**
-     * Creates an instance of `AgentFactoryError`.
-     * @param {string} message - The human-readable error message.
-     * @param {string} code - A unique code for the error type (e.g., 'CONFIG_NOT_FOUND', 'CLASS_NOT_REGISTERED', 'INSTANTIATION_FAILED').
-     * @param {string} [agentId] - Optional. The ID of the agent associated with this error.
-     * @param {Error} [underlyingError] - Optional. The original error that was caught and wrapped.
-     */
-    constructor(message, code, agentId, underlyingError) {
-        super(message);
-        this.name = "AgentFactoryError";
-        this.code = code;
-        this.agentId = agentId;
-        this.underlyingError = underlyingError;
-        if (underlyingError && underlyingError.stack) {
-            this.stack = `${this.message}\nCaused by: ${underlyingError.stack}`;
-        }
-        Object.setPrototypeOf(this, AgentFactoryError.prototype);
-    }
-}
-/**
- * A concrete implementation of `IAgentFactory`.
- * This class is responsible for instantiating `IAgent` implementations based on
- * loaded `AgentConfig` data and a map of registered agent classes. It ensures
- * that agents are created with all their required dependencies.
- *
- * @class AgentFactory
- * @implements {IAgentFactory}
- */
-export class AgentFactory {
-    /**
-     * Constructs an `AgentFactory`.
-     * Initialization (loading configs and classes) is performed via the `initialize` method.
-     */
-    constructor() {
-        /**
-         * Stores agent configurations, keyed by their unique agent ID.
-         * @private
-         * @type {Record<string, AgentConfig>}
-         */
-        this.agentConfigs = {};
-        /**
-         * Maps agent type identifiers (strings) to their corresponding class constructors.
-         * @private
-         * @type {Record<string, AgentClassConstructor<any>>}
-         */
-        this.agentClassMap = {};
-        /**
-         * Flag indicating whether the factory has been successfully initialized.
-         * @private
-         * @type {boolean}
-         */
-        this.isInitialized = false;
-        // console.log("AgentFactory instance created. Awaiting initialization.");
-    }
-    /**
-     * Ensures that the factory has been initialized before any operational methods are called.
-     * @private
-     * @throws {AgentFactoryError} If the factory is not initialized.
-     */
-    ensureInitialized() {
-        if (!this.isInitialized) {
-            throw new AgentFactoryError("AgentFactory is not initialized. Call initialize() with agent configurations and class map first.", 'FACTORY_NOT_INITIALIZED');
-        }
-    }
-    /**
-     * Initializes the factory with agent configurations and agent class mappings.
-     *
-     * @throws {AgentFactoryError} If `agentConfigs` or `agentClassMap` is null/undefined.
-     */
-    async initialize(agentConfigs, agentClassMap) {
-        if (this.isInitialized) {
-            console.warn("AgentFactory is already initialized. Re-initializing will overwrite existing configurations and class mappings.");
-            // Resetting state for re-initialization
-            this.agentConfigs = {};
-            this.agentClassMap = {};
-        }
-        if (!agentConfigs) {
-            throw new AgentFactoryError("Agent configurations (agentConfigs) must be provided for initialization.", 'INIT_NO_CONFIGS');
-        }
-        if (!agentClassMap) {
-            throw new AgentFactoryError("Agent class map (agentClassMap) must be provided for initialization.", 'INIT_NO_CLASSMAP');
-        }
-        // Store copies to prevent external modification of the provided objects.
-        this.agentConfigs = { ...agentConfigs };
-        this.agentClassMap = { ...agentClassMap };
-        this.isInitialized = true;
-        const configCount = Object.keys(this.agentConfigs).length;
-        const classCount = Object.keys(this.agentClassMap).length;
-        if (configCount > 0 || classCount > 0) {
-            //   console.log(`AgentFactory initialized successfully with ${configCount} agent configurations and ${classCount} registered agent classes.`);
-        }
-        else {
-            console.warn("AgentFactory initialized, but no agent configurations or agent classes were provided. The factory may not be able to create agents.");
-        }
-    }
-    /**
-     * Dynamically registers an agent type and its constructor with the factory.
-     *
-     * @throws {AgentFactoryError} If `agentType` or `constructor` is invalid.
-     */
-    async registerAgentClass(agentType, constructor) {
-        this.ensureInitialized();
-        if (!agentType || typeof agentType !== 'string' || agentType.trim() === '') {
-            throw new AgentFactoryError("Invalid agentType: Must be a non-empty string.", 'REGISTER_INVALID_AGENT_TYPE');
-        }
-        if (!constructor || typeof constructor !== 'function') {
-            throw new AgentFactoryError(`Invalid constructor provided for agentType '${agentType}'. Must be a class constructor.`, 'REGISTER_INVALID_CONSTRUCTOR', agentType);
-        }
-        if (this.agentClassMap[agentType]) {
-            console.warn(`AgentFactory: Agent type '${agentType}' is already registered. The existing constructor will be overwritten.`);
-        }
-        this.agentClassMap[agentType] = constructor;
-        // console.log(`AgentFactory: Agent type '${agentType}' registered successfully.`);
-    }
-    /**
-     * Retrieves and initializes an agent instance by its ID.
-     *
-     * @throws {AgentFactoryError} If critical errors occur during instantiation.
-     */
-    async getAgent(agentId, dependencies) {
-        this.ensureInitialized();
-        if (!agentId) {
-            throw new AgentFactoryError("agentId must be provided to getAgent.", 'GET_AGENT_NO_ID');
-        }
-        if (!dependencies || !dependencies.promptEngine || !dependencies.providerManager) {
-            throw new AgentFactoryError("Missing critical dependencies (promptEngine, providerManager) required to create agent.", 'GET_AGENT_MISSING_DEPS', agentId);
-        }
-        // Destructure all dependencies for clarity
-        const { promptEngine, providerManager, utilityAI, agentFactory: selfFactory } = dependencies;
-        const config = this.agentConfigs[agentId];
-        if (!config) {
-            console.warn(`AgentFactory: No AgentConfig found for agentId '${agentId}'. Cannot create agent.`);
-            return undefined; // Gracefully return undefined if config not found
-        }
-        // Determine the agent's primary LLM provider using modelTargetInfo from its config
-        const providerIdToUse = config.modelTargetInfo?.providerId;
-        if (!providerIdToUse) {
-            throw new AgentFactoryError(`AgentConfig for '${agentId}' is missing 'modelTargetInfo.providerId'. Cannot determine primary LLM provider.`, 'GET_AGENT_NO_PROVIDER_ID', agentId);
-        }
-        const agentPrimaryProvider = providerManager.getProvider(providerIdToUse);
-        if (!agentPrimaryProvider) {
-            throw new AgentFactoryError(`Could not resolve primary LLM provider '${providerIdToUse}' for agent '${agentId}' using the provided AIModelProviderManager. Ensure the provider is configured and initialized in the manager.`, 'GET_AGENT_PROVIDER_RESOLUTION_FAILED', agentId);
-        }
-        // Determine the AgentClass constructor to use.
-        // `config.type` (e.g., AgentType.POOL) is the key for agentClassMap.
-        const agentTypeKey = config.type || AgentType.STANDARD; // Default to STANDARD if type not specified
-        const AgentClass = this.agentClassMap[agentTypeKey];
-        if (!AgentClass) {
-            throw new AgentFactoryError(`No implementing class registered for agent type '${agentTypeKey}' (referenced by agentId '${agentId}'). Agent cannot be created. Ensure the class is registered with the factory using registerAgentClass(). Known types: [${Object.keys(this.agentClassMap).join(', ')}].`, 'GET_AGENT_CLASS_NOT_REGISTERED', agentId);
-        }
-        let agentInstance;
-        try {
-            // Instantiate the agent, passing all resolved dependencies.
-            // Note: `selfFactory` (which is `dependencies.agentFactory`) is passed here.
-            agentInstance = new AgentClass(config, promptEngine, agentPrimaryProvider, utilityAI, selfFactory);
-        }
-        catch (error) {
-            console.error(`AgentFactory: Error during instantiation of agent '${agentId}' (type '${agentTypeKey}'): ${error.message}`, error);
-            throw new AgentFactoryError(`Failed to instantiate agent '${agentId}' of type '${agentTypeKey}'. Constructor threw an error: ${error.message}`, 'GET_AGENT_CONSTRUCTION_FAILED', agentId, error);
-        }
-        // Give the agent a chance to capture the dependency bundle if it supports it.
-        if (typeof agentInstance.setAgentDependencies === 'function') {
-            try {
-                agentInstance.setAgentDependencies(dependencies);
-            }
-            catch (depError) {
-                console.warn(`AgentFactory: Agent '${agentId}' threw while receiving dependencies: ${depError.message}`, depError);
-            }
-        }
-        // Call the agent's own initialize method, if it exists and is a function.
-        // This allows the agent to perform any specific asynchronous setup post-construction.
-        if (typeof agentInstance.initialize === 'function') {
-            try {
-                await agentInstance.initialize();
-            }
-            catch (initError) {
-                console.error(`AgentFactory: Error during agent.initialize() for '${agentId}': ${initError.message}`, initError);
-                throw new AgentFactoryError(`Agent '${agentId}' was instantiated but failed during its own initialize() method: ${initError.message}`, 'GET_AGENT_INITIALIZATION_FAILED', agentId, initError);
-            }
-        }
-        // console.log(`AgentFactory: Successfully created and initialized agent '${agentId}' of type '${agentTypeKey}'.`);
-        return agentInstance;
-    }
-    /**
-     * Lists all agent configurations known to the factory.
-     *
-     * Returns deep copies of the configurations to prevent external modification.
-     */
-    async listAvailableAgentConfigs() {
-        this.ensureInitialized();
-        // Return deep copies to ensure immutability of the factory's internal state.
-        // JSON.parse(JSON.stringify(...)) is a common way to deep copy plain objects.
-        try {
-            return Object.freeze(Object.values(this.agentConfigs).map(config => JSON.parse(JSON.stringify(config))));
-        }
-        catch (error) {
-            console.error("AgentFactory: Failed to deep copy agent configurations for listing.", error);
-            throw new AgentFactoryError(`Failed to list available agent configurations due to a cloning error: ${error.message}`, 'LIST_CONFIGS_CLONE_FAILED', undefined, error);
-        }
-    }
-}
-//# sourceMappingURL=AgentFactory.js.map

package/dist/core/agents/AgentFactory.js.map

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

package/dist/core/agents/AgentPoolAgent.d.ts

@@ -1,244 +0,0 @@
-/**
- * @fileoverview Implements the `AgentPoolAgent`, a specialized type of `AgentCore`
- * that functions as a manager or orchestrator for a collection of other "sub-agents".
- * This agent embodies strategies like routing requests to the most suitable sub-agent,
- * synthesizing responses from multiple sub-agents (mixture of experts), or delegating
- * tasks directly.
- *
- * The `AgentPoolAgent` uses an `IAgentFactory` to instantiate its sub-agents based on
- * IDs provided in its `AgentPoolConfig`. Its behavior is primarily dictated by the
- * `AgentPoolStrategy` defined in its configuration.
- *
- * Key functionalities:
- * - Loads and initializes a set of sub-agents.
- * - Implements various strategies for sub-agent interaction and output generation.
- * - Can maintain a "unified persona" for user-facing interactions, even if sub-agents
- * have distinct characteristics.
- * - Utilizes its own LLM provider and prompt engine for meta-tasks like routing
- * decisions or synthesizing sub-agent outputs.
- * @module backend/agentos/core/agents/AgentPoolAgent
- */
-import { AgentCore, AgentConfig, AgentType } from './AgentCore';
-import { IAgent, AgentOutput } from './IAgent';
-import { AgentPoolConfig } from './AgentPoolConfig';
-import { ConversationContext } from '../conversation/ConversationContext';
-import { IProvider } from '../llm/providers/IProvider';
-import { IPromptEngine } from '../llm/IPromptEngine';
-import { Tool } from './tools/Tool';
-import { IUtilityAI } from '../ai_utilities/IUtilityAI';
-import { IAgentFactory, AgentDependencies } from './IAgentFactory';
-/**
- * Configuration specific to an `AgentPoolAgent`.
- * It extends the base `AgentConfig` and mandates that the `type` is `AgentType.POOL`,
- * and that `agentPoolOptions` (defined by `AgentPoolConfig`) are provided.
- * @interface AgentPoolAgentConfig
- * @extends {AgentConfig}
- */
-export interface AgentPoolAgentConfig extends AgentConfig {
-    /**
-     * Specifies the type of this agent, which must be `AgentType.POOL`.
-     * @type {AgentType.POOL}
-     */
-    type: AgentType.POOL;
-    /**
-     * Configuration settings specific to the agent pool's operation,
-     * including sub-agent IDs and interaction strategy.
-     * @type {AgentPoolConfig}
-     */
-    agentPoolOptions: AgentPoolConfig;
-}
-/**
- * A concrete agent implementation that acts as an intelligent coordinator or router
- * for a collection of sub-agents. It encapsulates the logic for selecting,
- * dispatching tasks to, and synthesizing results from its managed sub-agents,
- * all based on a configured `AgentPoolStrategy`.
- *
- * @class AgentPoolAgent
- * @extends {AgentCore}
- * @implements {IAgent}
- */
-export declare class AgentPoolAgent extends AgentCore implements IAgent {
-    /**
-     * The specific configuration for this agent pool's operations.
-     * @private
-     * @type {AgentPoolConfig}
-     */
-    private readonly poolConfig;
-    /**
-     * A map storing the instantiated sub-agent instances, keyed by their agent IDs.
-     * @private
-     * @type {Map<string, IAgent>}
-     */
-    private subAgents;
-    /**
-     * Snapshot of the dependencies originally supplied by the orchestrator/factory.
-     * Needed so the pool can instantiate sub-agents with the same services.
-     */
-    private agentDependencies?;
-    /**
-     * Stores tools that are available to the pool agent itself. These might be
-     * different from tools available to individual sub-agents.
-     * @private
-     * @type {Tool[]}
-     */
-    private availablePoolTools;
-    /**
-     * Constructs an `AgentPoolAgent` instance.
-     *
-     * @param {AgentPoolAgentConfig} config - The configuration for this agent pool.
-     * Must specify `type` as `AgentType.POOL` and include `agentPoolOptions`.
-     * @param {IPromptEngine} promptEngine - An instance of the `IPromptEngine`.
-     * @param {IProvider} llmProvider - The primary AI model provider for the pool agent's
-     * own meta-tasks (e.g., routing, synthesis).
-     * @param {IUtilityAI | undefined} utilityAI - Optional. An instance of an `IUtilityAI` service.
-     * @param {IAgentFactory} agentFactory - The `IAgentFactory` instance, which is **required**
-     * for the `AgentPoolAgent` to load and instantiate its sub-agents.
-     * @throws {AgentCoreError} If the configuration is invalid (e.g., missing `agentPoolOptions`)
-     * or if the `agentFactory` dependency is not provided.
-     */
-    constructor(config: AgentPoolAgentConfig, promptEngine: IPromptEngine, llmProvider: IProvider, utilityAI: IUtilityAI | undefined, agentFactory: IAgentFactory);
-    /**
-     * Allows the orchestrator/factory to provide the dependency bundle that was used
-     * to construct this pool agent so it can reuse them when instantiating sub-agents.
-     */
-    setAgentDependencies(dependencies: AgentDependencies): void;
-    /**
-     * Initializes the `AgentPoolAgent`. This involves:
-     * 1. Calling the base class `initialize` method.
-     * 2. Using the injected `IAgentFactory` to load and initialize all sub-agents
-     * specified in `this.poolConfig.subAgentIds`.
-     *
-     * @override
-     * @param {Record<string, any>} [configOverrides] - Optional configuration overrides applied during initialization.
-     * @returns {Promise<void>}
-     * @throws {AgentCoreError} If the `agentFactory` is missing or if any sub-agent fails to load or initialize.
-     */
-    initialize(configOverrides?: Record<string, any>): Promise<void>;
-    /**
-     * Resets the `AgentPoolAgent`'s internal state and propagates the reset call
-     * to all its managed sub-agents.
-     * @override
-     */
-    reset(): void;
-    /**
-     * Overrides the `processTurn` method from `AgentCore` to implement the specific
-     * orchestration logic of the `AgentPoolAgent` based on its configured strategy.
-     * This method will route tasks to, or synthesize results from, its sub-agents.
-     *
-     * @override
-     * @param {string | null} userInput - The latest input from the user.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @param {Tool[]} [availableTools] - Tools available to the pool agent itself (these might also
-     * be passed down to sub-agents depending on the strategy and sub-agent capabilities).
-     * @returns {Promise<AgentOutput>} The agent's response and actions, which could be a direct
-     * response, a synthesized response from sub-agents, or tool calls.
-     * @throws {AgentCoreError} If an unhandled error occurs within the chosen strategy.
-     */
-    processTurn(userInput: string | null, conversationContext: ConversationContext, availableTools?: Tool[]): Promise<AgentOutput>;
-    /**
-     * Implements the `UNIFIED_PERSONA_ROUTING` strategy.
-     * This involves using an LLM (the pool agent's own) to select the most appropriate sub-agent
-     * based on the user input and sub-agent descriptions. The selected sub-agent's output
-     * is then rephrased by the pool agent to maintain a consistent unified persona.
-     *
-     * @private
-     * @param {string | null} userInput - The user's input.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @returns {Promise<AgentOutput>} The synthesized and persona-aligned output.
-     */
-    private handleUnifiedPersonaRouting;
-    /**
-     * Implements the `MIXTURE_OF_EXPERTS_SYNTHESIS` strategy.
-     * Consults multiple (or all) sub-agents and then uses the pool's LLM to synthesize
-     * their contributions into a single, coherent response.
-     *
-     * @private
-     * @param {string | null} userInput - The user's input.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @returns {Promise<AgentOutput>} The synthesized output from the mixture of experts.
-     */
-    private handleMixtureOfExpertsSynthesis;
-    /**
-     * Implements the `DIRECT_DELEGATION` strategy.
-     * Selects a single sub-agent (e.g., based on simple routing logic or configuration)
-     * and directly forwards its response without significant modification by the pool agent.
-     *
-     * @private
-     * @param {string | null} userInput - The user's input.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @returns {Promise<AgentOutput>} The output from the delegated sub-agent.
-     */
-    private handleDirectDelegation;
-    /**
-     * Implements the `EXPLORATORY_GENERATION` strategy. (Placeholder - complex to fully implement here)
-     * Spawns sub-agents to explore different approaches for a problem, then evaluates
-     * and synthesizes their outputs. This is a more advanced strategy.
-     *
-     * @private
-     * @param {string | null} userInput - The user's input.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @returns {Promise<AgentOutput>} The synthesized result of the exploratory generation.
-     */
-    private handleExploratoryGeneration;
-    /**
-     * Generates a prompt for the pool agent's internal LLM to perform routing to a sub-agent.
-     * The prompt includes descriptions of available sub-agents and the user's query.
-     *
-     * @private
-     * @param {string | null} userInput - The user's current input.
-     * @param {ConversationContext} conversationContext - For history and broader context.
-     * @param {IAgent[]} subAgents - The list of available sub-agents to choose from.
-     * @returns {Partial<PromptComponents>} The components for constructing the routing prompt.
-     */
-    private generateRoutingPrompt;
-    /**
-     * Parses the LLM's response when it was tasked with routing, expecting just an agent ID or "NONE".
-     *
-     * @private
-     * @param {ModelCompletionResponse} llmResponse - The response from the routing LLM call.
-     * @param {string[]} validAgentIds - An array of valid sub-agent IDs for validation.
-     * @returns {string | null} The chosen agent ID, or `null` if parsing fails or "NONE" is returned.
-     */
-    private parseLLMResponseForRouting;
-    /**
-     * Generates a prompt for the pool agent's internal LLM to synthesize outputs from multiple expert sub-agents.
-     *
-     * @private
-     * @param {string | null} originalUserInput - The initial user input that led to expert consultation.
-     * @param {ConversationContext} conversationContext - For overall context.
-     * @param {Array<{ agentId: string; agentName: string; agentDescription: string; output: AgentOutput; }>} expertResults - The outputs from consulted sub-agents.
-     * @returns {Partial<PromptComponents>} The components for constructing the synthesis prompt.
-     */
-    private generateSynthesisPrompt;
-    /**
-     * A helper method to potentially rephrase or wrap a sub-agent's output to align
-     * with the pool's unified persona, if one is configured. Also finalizes metadata.
-     *
-     * @private
-     * @param {AgentOutput} subAgentOutput - The output from the sub-agent.
-     * @param {IAgent} sourceAgent - The sub-agent that produced the output.
-     * @param {ConversationContext} conversationContext - For context if rephrasing LLM call is needed.
-     * @param {string} internalActionDescription - Description of the pool's internal action (e.g., "Routed to expert").
-     * @param {boolean} [isDirectDelegation=false] - If true, rephrasing might be lighter or skipped.
-     * @returns {Promise<AgentOutput>} The finalized (potentially rephrased) `AgentOutput`.
-     */
-    private synthesizeAndFinalizeOutput;
-    /**
-     * Overrides `handleToolResult` from `AgentCore`.
-     * This method is called when a tool initiated by the `AgentPoolAgent` itself completes.
-     * (Tools initiated by sub-agents are handled by their respective `handleToolResult` methods,
-     * and the orchestrator delivers the result to that sub-agent).
-     *
-     * The `AgentPoolAgent` might use tools for its meta-tasks, like a "SubAgentSelectionTool"
-     * or a "ContentAnalysisTool" to help in routing or synthesis.
-     *
-     * @override
-     * @param {string} toolCallId - The ID of the tool call this result pertains to.
-     * @param {any} toolOutput - The output from the tool execution.
-     * @param {string} toolName - The name of the tool that was called.
-     * @param {ConversationContext} conversationContext - The current conversation context.
-     * @returns {Promise<AgentOutput>} The pool agent's subsequent output after processing its own tool's result.
-     */
-    handleToolResult(toolCallId: string, toolOutput: any, toolName: string, conversationContext: ConversationContext): Promise<AgentOutput>;
-}
-//# sourceMappingURL=AgentPoolAgent.d.ts.map

package/dist/core/agents/AgentPoolAgent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentPoolAgent.d.ts","sourceRoot":"","sources":["../../../src/core/agents/AgentPoolAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,SAAS,EAA2B,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGnE;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;IAErB;;;;OAIG;IACH,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,SAAU,YAAW,MAAM;IAC7D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAE7C;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAkC;IAEnD;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAE9C;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAAc;IAExC;;;;;;;;;;;;;OAaG;gBAED,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,aAAa,EAC3B,WAAW,EAAE,SAAS,EACtB,SAAS,EAAE,UAAU,GAAG,SAAS,EACjC,YAAY,EAAE,aAAa;IAuB7B;;;OAGG;IACI,oBAAoB,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI;IAIlE;;;;;;;;;;OAUG;IACU,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6D7E;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAcpB;;;;;;;;;;;;;OAaG;IACU,WAAW,CACtB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,mBAAmB,EAAE,mBAAmB,EACxC,cAAc,CAAC,EAAE,IAAI,EAAE,GACtB,OAAO,CAAC,WAAW,CAAC;IA4DvB;;;;;;;;;;OAUG;YACW,2BAA2B;IA4DzC;;;;;;;;;OASG;YACW,+BAA+B;IA+E7C;;;;;;;;;OASG;YACW,sBAAsB;IAwDpC;;;;;;;;;OASG;YACW,2BAA2B;IAoBzC;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAwBlC;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA+C/B;;;;;;;;;;;OAWG;YACW,2BAA2B;IAoFzC;;;;;;;;;;;;;;;OAeG;IACU,gBAAgB,CAC3B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,GAAG,EACf,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,mBAAmB,GACvC,OAAO,CAAC,WAAW,CAAC;CAyDxB"}