@framers/agentos 0.1.0

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

@@ -0,0 +1,123 @@
+/**
+ * @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;
+    /**
+     * @inheritdoc
+     * Initializes the `AgentFactory` by loading agent configurations and mapping agent types
+     * to their respective class constructors.
+     * @throws {AgentFactoryError} If `agentConfigs` or `agentClassMap` is null/undefined.
+     */
+    initialize(agentConfigs: Record<string, AgentConfig>, agentClassMap: Record<string, AgentClassConstructor<any>>): Promise<void>;
+    /**
+     * @inheritdoc
+     * Dynamically registers an agent type and its constructor with the factory.
+     * This allows for adding new agent implementations at runtime or via a plugin system.
+     * @throws {AgentFactoryError} If `agentType` or `constructor` is invalid, or if an agent type is already registered and overwrite is not intended.
+     */
+    registerAgentClass(agentType: string, constructor: AgentClassConstructor<any>): Promise<void>;
+    /**
+     * @inheritdoc
+     * Retrieves (and typically creates and initializes) an agent instance by its ID.
+     * It resolves the agent's primary LLM provider using the `AIModelProviderManager` from `dependencies`.
+     * @throws {AgentFactoryError} If critical errors occur during instantiation, such as missing configuration,
+     * unregistered class, or failure to resolve the LLM provider.
+     */
+    getAgent(agentId: string, dependencies: AgentDependencies): Promise<IAgent | undefined>;
+    /**
+     * @inheritdoc
+     * Lists all available 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

@@ -0,0 +1 @@
+{"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;;;;;OAKG;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;;;;;OAKG;IACU,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1G;;;;;;OAMG;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

@@ -0,0 +1,232 @@
+/**
+ * @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');
+        }
+    }
+    /**
+     * @inheritdoc
+     * Initializes the `AgentFactory` by loading agent configurations and mapping agent types
+     * to their respective class constructors.
+     * @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.");
+        }
+    }
+    /**
+     * @inheritdoc
+     * Dynamically registers an agent type and its constructor with the factory.
+     * This allows for adding new agent implementations at runtime or via a plugin system.
+     * @throws {AgentFactoryError} If `agentType` or `constructor` is invalid, or if an agent type is already registered and overwrite is not intended.
+     */
+    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.`);
+    }
+    /**
+     * @inheritdoc
+     * Retrieves (and typically creates and initializes) an agent instance by its ID.
+     * It resolves the agent's primary LLM provider using the `AIModelProviderManager` from `dependencies`.
+     * @throws {AgentFactoryError} If critical errors occur during instantiation, such as missing configuration,
+     * unregistered class, or failure to resolve the LLM provider.
+     */
+    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;
+    }
+    /**
+     * @inheritdoc
+     * Lists all available 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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentFactory.js","sourceRoot":"","sources":["../../../src/core/agents/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAe,SAAS,EAAE,MAAM,aAAa,CAAC,CAAC,4BAA4B;AAElF;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAqB1C;;;;;;OAMG;IACH,YAAY,OAAe,EAAE,IAAY,EAAE,OAAgB,EAAE,eAAuB;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,IAAI,eAAe,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IAsBvB;;;OAGG;IACH;QAzBA;;;;WAIG;QACK,iBAAY,GAAgC,EAAE,CAAC;QAEvD;;;;WAIG;QACK,kBAAa,GAA+C,EAAE,CAAC;QAEvE;;;;WAIG;QACK,kBAAa,GAAY,KAAK,CAAC;QAOrC,0EAA0E;IAC5E,CAAC;IAED;;;;OAIG;IACK,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,iBAAiB,CACzB,mGAAmG,EACnG,yBAAyB,CAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,UAAU,CACrB,YAAyC,EACzC,aAAyD;QAEzD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,iHAAiH,CAAC,CAAC;YAChI,wCAAwC;YACxC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,MAAM,IAAI,iBAAiB,CAAC,0EAA0E,EAAE,iBAAiB,CAAC,CAAC;QAC/H,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,IAAI,iBAAiB,CAAC,sEAAsE,EAAE,kBAAkB,CAAC,CAAC;QAC5H,CAAC;QAED,yEAAyE;QACzE,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;QAE1D,IAAI,WAAW,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACxC,+IAA+I;QAC/I,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,qIAAqI,CAAC,CAAC;QACtJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,kBAAkB,CAAC,SAAiB,EAAE,WAAuC;QACxF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3E,MAAM,IAAI,iBAAiB,CAAC,gDAAgD,EAAE,6BAA6B,CAAC,CAAC;QAC/G,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;YACtD,MAAM,IAAI,iBAAiB,CAAC,+CAA+C,SAAS,iCAAiC,EAAE,8BAA8B,EAAE,SAAS,CAAC,CAAC;QACpK,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,6BAA6B,SAAS,wEAAwE,CAAC,CAAC;QAC/H,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;QAC5C,mFAAmF;IACrF,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,YAA+B;QACpE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,iBAAiB,CAAC,uCAAuC,EAAE,iBAAiB,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;YACjF,MAAM,IAAI,iBAAiB,CACzB,yFAAyF,EACzF,wBAAwB,EACxB,OAAO,CACR,CAAC;QACJ,CAAC;QACD,2CAA2C;QAC3C,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC;QAG7F,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,mDAAmD,OAAO,yBAAyB,CAAC,CAAC;YAClG,OAAO,SAAS,CAAC,CAAC,kDAAkD;QACtE,CAAC;QAED,mFAAmF;QACnF,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC;QAC3D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,iBAAiB,CACzB,oBAAoB,OAAO,mFAAmF,EAC9G,0BAA0B,EAC1B,OAAO,CACR,CAAC;QACJ,CAAC;QAED,MAAM,oBAAoB,GAAG,eAAe,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAC1E,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,MAAM,IAAI,iBAAiB,CACzB,2CAA2C,eAAe,gBAAgB,OAAO,gHAAgH,EACjM,sCAAsC,EACtC,OAAO,CACR,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,qEAAqE;QACrE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,4CAA4C;QACpG,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,iBAAiB,CACzB,oDAAoD,YAAY,6BAA6B,OAAO,0HAA0H,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAC5Q,gCAAgC,EAChC,OAAO,CACR,CAAC;QACJ,CAAC;QAED,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,4DAA4D;YAC5D,6EAA6E;YAC7E,aAAa,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACrG,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,sDAAsD,OAAO,YAAY,YAAY,OAAO,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;YAClI,MAAM,IAAI,iBAAiB,CACzB,gCAAgC,OAAO,cAAc,YAAY,kCAAkC,KAAK,CAAC,OAAO,EAAE,EAClH,+BAA+B,EAC/B,OAAO,EACP,KAAK,CACN,CAAC;QACJ,CAAC;QAED,8EAA8E;QAC9E,IAAI,OAAQ,aAAqB,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;YACtE,IAAI,CAAC;gBACF,aAAqB,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC5D,CAAC;YAAC,OAAO,QAAa,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,wBAAwB,OAAO,yCAAyC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;YACrH,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,sFAAsF;QACtF,IAAI,OAAO,aAAa,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC;YACnC,CAAC;YAAC,OAAO,SAAc,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,sDAAsD,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;gBACjH,MAAM,IAAI,iBAAiB,CACzB,UAAU,OAAO,qEAAqE,SAAS,CAAC,OAAO,EAAE,EACzG,iCAAiC,EACjC,OAAO,EACP,SAAS,CACV,CAAC;YACJ,CAAC;QACH,CAAC;QACD,mHAAmH;QACnH,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,yBAAyB;QACpC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,6EAA6E;QAC7E,8EAA8E;QAC9E,IAAI,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAChB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CACrF,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,qEAAqE,EAAE,KAAK,CAAC,CAAC;YAC5F,MAAM,IAAI,iBAAiB,CACvB,yEAAyE,KAAK,CAAC,OAAO,EAAE,EACxF,2BAA2B,EAC3B,SAAS,EACT,KAAK,CACR,CAAC;QACN,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,244 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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"}