donobu 2.16.0 → 2.17.1

package/dist/esm/managers/DonobuStack.d.ts

@@ -1,12 +1,14 @@
 import Database from 'better-sqlite3';
 import { DonobuDeploymentEnvironment } from '../models/DonobuDeploymentEnvironment';
+import { AgentsPersistence } from '../persistence/agents/AgentsPersistence';
+import { FlowsPersistenceFactory } from '../persistence/flows/FlowsPersistenceFactory';
+import { GptConfigsPersistence } from '../persistence/gptconfigs/GptConfigsPersistence';
 import { AgentsManager } from './AgentsManager';
 import { DonobuFlowsManager } from './DonobuFlowsManager';
 import { GptConfigsManager } from './GptConfigsManager';
 import { RequestContextHolder } from './RequestContextHolder';
-import { GptConfigsPersistence } from '../persistence/GptConfigsPersistence';
-import { AgentsPersistence } from '../persistence/AgentsPersistence';
-import { FlowsPersistenceFactory } from '../persistence/FlowsPersistenceFactory';
+import { EnvDataManager } from './EnvDataManager';
+import { EnvPersistenceVolatile } from '../persistence/env/EnvPersistenceVolatile';
 export type DonobuStack = {
     sqliteDb: Database.Database;
     gptConfigsPersistence: GptConfigsPersistence;
@@ -15,6 +17,18 @@ export type DonobuStack = {
     agentsManager: AgentsManager;
     flowsPersistenceFactory: FlowsPersistenceFactory;
     flowsManager: DonobuFlowsManager;
+    envDataManager: EnvDataManager;
 };
-export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, requestContextHolder: RequestContextHolder): Promise<DonobuStack>;
+/**
+ * Create a new Donobu application stack.
+ *
+ * NOTE: The reason why we have the oddball {@link envPersistenceVolatile}
+ *       parameter is because that can be used to hold a snapshot of the
+ *       real NodeJS process's environment variables, of which, we generally
+ *       should not do in hosted environments. However, if we are running
+ *       within the context of being a library used for runningPlaywright tests,
+ *       then having this snapshot is relevant so that tests can use normal
+ *       environment variables.
+ */
+export declare function setupDonobuStack(donobuDeploymentEnvironment: DonobuDeploymentEnvironment, requestContextHolder: RequestContextHolder, envPersistenceVolatile?: EnvPersistenceVolatile): Promise<DonobuStack>;
 //# sourceMappingURL=DonobuStack.d.ts.map

package/dist/esm/managers/DonobuStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuStack.d.ts","sourceRoot":"","sources":["../../../src/managers/DonobuStack.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAKpF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,YAAY,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,2BAA2B,EAAE,2BAA2B,EACxD,oBAAoB,EAAE,oBAAoB,GACzC,OAAO,CAAC,WAAW,CAAC,CAgCtB"}
+{"version":3,"file":"DonobuStack.d.ts","sourceRoot":"","sources":["../../../src/managers/DonobuStack.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAEvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,YAAY,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,2BAA2B,EAAE,2BAA2B,EACxD,oBAAoB,EAAE,oBAAoB,EAC1C,sBAAsB,CAAC,EAAE,sBAAsB,GAC9C,OAAO,CAAC,WAAW,CAAC,CAwCtB"}

package/dist/esm/managers/DonobuStack.js

@@ -1,21 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupDonobuStack = setupDonobuStack;
-const AgentsPersistenceSqlite_1 = require("../persistence/AgentsPersistenceSqlite");
+const AgentsPersistenceSqlite_1 = require("../persistence/agents/AgentsPersistenceSqlite");
 const DonobuSqliteDb_1 = require("../persistence/DonobuSqliteDb");
-const FlowsPersistenceFactoryImpl_1 = require("../persistence/FlowsPersistenceFactoryImpl");
-const GptConfigsPersistenceSqlite_1 = require("../persistence/GptConfigsPersistenceSqlite");
+const FlowsPersistenceFactoryImpl_1 = require("../persistence/flows/FlowsPersistenceFactoryImpl");
+const GptConfigsPersistenceSqlite_1 = require("../persistence/gptconfigs/GptConfigsPersistenceSqlite");
+const EnvPersistenceFactoryImpl_1 = require("../persistence/env/EnvPersistenceFactoryImpl");
 const AgentsManager_1 = require("./AgentsManager");
 const DonobuFlowsManager_1 = require("./DonobuFlowsManager");
 const GptConfigsManager_1 = require("./GptConfigsManager");
-async function setupDonobuStack(donobuDeploymentEnvironment, requestContextHolder) {
+const EnvDataManager_1 = require("./EnvDataManager");
+/**
+ * Create a new Donobu application stack.
+ *
+ * NOTE: The reason why we have the oddball {@link envPersistenceVolatile}
+ *       parameter is because that can be used to hold a snapshot of the
+ *       real NodeJS process's environment variables, of which, we generally
+ *       should not do in hosted environments. However, if we are running
+ *       within the context of being a library used for runningPlaywright tests,
+ *       then having this snapshot is relevant so that tests can use normal
+ *       environment variables.
+ */
+async function setupDonobuStack(donobuDeploymentEnvironment, requestContextHolder, envPersistenceVolatile) {
     const sqliteDb = (0, DonobuSqliteDb_1.getDonobuSqliteDatabase)();
     const gptConfigsPersistence = await GptConfigsPersistenceSqlite_1.GptConfigsPersistenceSqlite.create(sqliteDb);
     const gptConfigsManager = await GptConfigsManager_1.GptConfigsManager.create(gptConfigsPersistence);
     const agentsPersistence = await AgentsPersistenceSqlite_1.AgentsPersistenceSqlite.create(sqliteDb);
     const agentsManager = await AgentsManager_1.AgentsManager.create(agentsPersistence, gptConfigsManager);
     const flowsPersistenceFactory = await FlowsPersistenceFactoryImpl_1.FlowsPersistenceFactoryImpl.fromEnvironment(donobuDeploymentEnvironment, requestContextHolder);
-    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(donobuDeploymentEnvironment, gptConfigsManager, agentsManager, flowsPersistenceFactory);
+    const envPersistenceFactory = await EnvPersistenceFactoryImpl_1.EnvPersistenceFactoryImpl.fromEnvironment(donobuDeploymentEnvironment, requestContextHolder, envPersistenceVolatile ?? null);
+    const environmentDataManager = new EnvDataManager_1.EnvDataManager(envPersistenceFactory);
+    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(donobuDeploymentEnvironment, gptConfigsManager, agentsManager, flowsPersistenceFactory, environmentDataManager);
     return {
         sqliteDb,
         gptConfigsPersistence,
@@ -24,6 +39,7 @@ async function setupDonobuStack(donobuDeploymentEnvironment, requestContextHolde
         agentsManager,
         flowsPersistenceFactory,
         flowsManager,
+        envDataManager: environmentDataManager,
     };
 }
 //# sourceMappingURL=DonobuStack.js.map

package/dist/esm/managers/DonobuStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuStack.js","sourceRoot":"","sources":["../../../src/managers/DonobuStack.ts"],"names":[],"mappings":";;AAwBA,4CAmCC;AAzDD,oFAAiF;AACjF,kEAAwE;AACxE,4FAAyF;AACzF,4FAAyF;AACzF,mDAAgD;AAChD,6DAA0D;AAC1D,2DAAwD;AAgBjD,KAAK,UAAU,gBAAgB,CACpC,2BAAwD,EACxD,oBAA0C;IAE1C,MAAM,QAAQ,GAAG,IAAA,wCAAuB,GAAE,CAAC;IAC3C,MAAM,qBAAqB,GACzB,MAAM,yDAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,MAAM,qCAAiB,CAAC,MAAM,CACtD,qBAAqB,CACtB,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,iDAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,6BAAa,CAAC,MAAM,CAC9C,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IACF,MAAM,uBAAuB,GAC3B,MAAM,yDAA2B,CAAC,eAAe,CAC/C,2BAA2B,EAC3B,oBAAoB,CACrB,CAAC;IACJ,MAAM,YAAY,GAAG,IAAI,uCAAkB,CACzC,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,uBAAuB,CACxB,CAAC;IACF,OAAO;QACL,QAAQ;QACR,qBAAqB;QACrB,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,uBAAuB;QACvB,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"DonobuStack.js","sourceRoot":"","sources":["../../../src/managers/DonobuStack.ts"],"names":[],"mappings":";;AAuCA,4CA4CC;AAjFD,2FAAwF;AAExF,kEAAwE;AACxE,kGAA+F;AAE/F,uGAAoG;AAEpG,4FAAyF;AACzF,mDAAgD;AAChD,6DAA0D;AAC1D,2DAAwD;AAExD,qDAAkD;AAclD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,gBAAgB,CACpC,2BAAwD,EACxD,oBAA0C,EAC1C,sBAA+C;IAE/C,MAAM,QAAQ,GAAG,IAAA,wCAAuB,GAAE,CAAC;IAC3C,MAAM,qBAAqB,GACzB,MAAM,yDAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,MAAM,qCAAiB,CAAC,MAAM,CACtD,qBAAqB,CACtB,CAAC;IACF,MAAM,iBAAiB,GAAG,MAAM,iDAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,MAAM,6BAAa,CAAC,MAAM,CAC9C,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IACF,MAAM,uBAAuB,GAC3B,MAAM,yDAA2B,CAAC,eAAe,CAC/C,2BAA2B,EAC3B,oBAAoB,CACrB,CAAC;IACJ,MAAM,qBAAqB,GAAG,MAAM,qDAAyB,CAAC,eAAe,CAC3E,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,IAAI,IAAI,CAC/B,CAAC;IACF,MAAM,sBAAsB,GAAG,IAAI,+BAAc,CAAC,qBAAqB,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,IAAI,uCAAkB,CACzC,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,sBAAsB,CACvB,CAAC;IACF,OAAO;QACL,QAAQ;QACR,qBAAqB;QACrB,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,uBAAuB;QACvB,YAAY;QACZ,cAAc,EAAE,sBAAsB;KACvC,CAAC;AACJ,CAAC"}

package/dist/esm/managers/EnvDataManager.d.ts

@@ -0,0 +1,58 @@
+import { EnvPersistenceFactory } from '../persistence/env/EnvPersistenceFactory';
+/**
+ * Manager class for handling environment data operations within business logic constraints.
+ */
+export declare class EnvDataManager {
+    private readonly envPersistenceFactory;
+    /**
+     * Maximum length allowed for an environment data key.
+     */
+    private static readonly MAX_KEY_LENGTH;
+    /**
+     * Maximum length allowed for environment data value
+     */
+    private static readonly MAX_VALUE_LENGTH;
+    constructor(envPersistenceFactory: EnvPersistenceFactory);
+    /**
+     * Stores an environment datum with validation.
+     *
+     * @param key The key for the environment datum
+     * @param value The value to store
+     * @throws InvalidParamValueException if the key or value is invalid
+     */
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    /**
+     * Deletes an environment datum by key.
+     *
+     * @param key The key of the datum to delete
+     */
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    /**
+     * Retrieves an environment datum by key.
+     *
+     * @param key The key of the datum to retrieve
+     * @returns The environment datum value or undefined if not found
+     */
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    /**
+     * Retrieves all environment data.
+     *
+     * @returns A record of all environment data where keys are datum keys and values are datum values
+     */
+    getEnvironmentData(): Promise<Record<string, string>>;
+    /**
+     * Validates an environment data key against business rules.
+     *
+     * @param key The key to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    private validateKey;
+    /**
+     * Validates an environment data value against business rules.
+     *
+     * @param value The value to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    private validateValue;
+}
+//# sourceMappingURL=EnvDataManager.d.ts.map

package/dist/esm/managers/EnvDataManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvDataManager.d.ts","sourceRoot":"","sources":["../../../src/managers/EnvDataManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF;;GAEG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAXxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAE7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAGpC,qBAAqB,EAAE,qBAAqB;IAG/D;;;;;;OAMG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;;;OAIG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;;;;OAKG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB1E;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyBlE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/esm/managers/EnvDataManager.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvDataManager = void 0;
+const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
+const Logger_1 = require("../utils/Logger");
+/**
+ * Manager class for handling environment data operations within business logic constraints.
+ */
+class EnvDataManager {
+    constructor(envPersistenceFactory) {
+        this.envPersistenceFactory = envPersistenceFactory;
+    }
+    /**
+     * Stores an environment datum with validation.
+     *
+     * @param key The key for the environment datum
+     * @param value The value to store
+     * @throws InvalidParamValueException if the key or value is invalid
+     */
+    async setEnvironmentDatum(key, value) {
+        // Validate the key and value
+        this.validateKey(key);
+        this.validateValue(value);
+        // Store in all persistence layers
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            await persistence.setEnvironmentDatum(key, value);
+        }
+    }
+    /**
+     * Deletes an environment datum by key.
+     *
+     * @param key The key of the datum to delete
+     */
+    async deleteEnvironmentDatum(key) {
+        this.validateKey(key);
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            await persistence.deleteEnvironmentDatum(key);
+        }
+    }
+    /**
+     * Retrieves an environment datum by key.
+     *
+     * @param key The key of the datum to retrieve
+     * @returns The environment datum value or undefined if not found
+     */
+    async getEnvironmentDatum(key) {
+        this.validateKey(key);
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            try {
+                const value = await persistence.getEnvironmentDatum(key);
+                if (value !== undefined) {
+                    return value;
+                }
+            }
+            catch (error) {
+                Logger_1.appLogger.warn(`Failed to get environment datum from persistence layer: ${error}`);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Retrieves all environment data.
+     *
+     * @returns A record of all environment data where keys are datum keys and values are datum values
+     */
+    async getEnvironmentData() {
+        const result = {};
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            try {
+                const data = await persistence.getEnvironmentData();
+                // Merge data, giving preference to values from earlier persistence layers
+                for (const [key, value] of Object.entries(data)) {
+                    if (!(key in result)) {
+                        result[key] = value;
+                    }
+                }
+            }
+            catch (error) {
+                Logger_1.appLogger.warn(`Failed to get environment data from persistence layer: ${error}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * Validates an environment data key against business rules.
+     *
+     * @param key The key to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    validateKey(key) {
+        // Check if key is provided
+        if (!key || key.trim().length === 0) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, 'key cannot be empty');
+        }
+        // Check length constraint
+        if (key.length > EnvDataManager.MAX_KEY_LENGTH) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, `exceeds maximum allowed length of ${EnvDataManager.MAX_KEY_LENGTH} characters`);
+        }
+        // Check for invalid characters
+        if (/[\s\\\/\:\*\?\"\<\>\|]/.test(key)) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, 'key contains invalid characters (space or one of \\ / : * ? " < > |)');
+        }
+    }
+    /**
+     * Validates an environment data value against business rules.
+     *
+     * @param value The value to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    validateValue(value) {
+        // Check if value is provided
+        if (value === undefined || value === null) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('value', 'undefined', 'value cannot be undefined or null');
+        }
+        // Check length constraint
+        if (value.length > EnvDataManager.MAX_VALUE_LENGTH) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('value', `${value.length} characters`, `exceeds maximum allowed length of ${EnvDataManager.MAX_VALUE_LENGTH} characters`);
+        }
+    }
+}
+exports.EnvDataManager = EnvDataManager;
+/**
+ * Maximum length allowed for an environment data key.
+ */
+EnvDataManager.MAX_KEY_LENGTH = 128;
+/**
+ * Maximum length allowed for environment data value
+ */
+EnvDataManager.MAX_VALUE_LENGTH = 1024 * 1024; // 1MB
+//# sourceMappingURL=EnvDataManager.js.map

package/dist/esm/managers/EnvDataManager.js.map

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

package/dist/esm/managers/EnvironmentDataManager.d.ts

@@ -0,0 +1,58 @@
+import { EnvPersistenceFactory } from '../persistence/env/EnvPersistenceFactory';
+/**
+ * Manager class for handling environment data operations with business logic constraints.
+ */
+export declare class EnvironmentDataManager {
+    private readonly envPersistenceFactory;
+    /**
+     * Maximum length allowed for an environment data key.
+     */
+    private static readonly MAX_KEY_LENGTH;
+    /**
+     * Maximum length allowed for environment data value
+     */
+    private static readonly MAX_VALUE_LENGTH;
+    constructor(envPersistenceFactory: EnvPersistenceFactory);
+    /**
+     * Stores an environment datum with validation.
+     *
+     * @param key The key for the environment datum
+     * @param value The value to store
+     * @throws InvalidParamValueException if the key or value is invalid
+     */
+    setEnvironmentDatum(key: string, value: string): Promise<void>;
+    /**
+     * Deletes an environment datum by key.
+     *
+     * @param key The key of the datum to delete
+     */
+    deleteEnvironmentDatum(key: string): Promise<void>;
+    /**
+     * Retrieves an environment datum by key.
+     *
+     * @param key The key of the datum to retrieve
+     * @returns The environment datum value or undefined if not found
+     */
+    getEnvironmentDatum(key: string): Promise<string | undefined>;
+    /**
+     * Retrieves all environment data.
+     *
+     * @returns A record of all environment data where keys are datum keys and values are datum values
+     */
+    getEnvironmentData(): Promise<Record<string, string>>;
+    /**
+     * Validates an environment data key against business rules.
+     *
+     * @param key The key to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    private validateKey;
+    /**
+     * Validates an environment data value against business rules.
+     *
+     * @param value The value to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    private validateValue;
+}
+//# sourceMappingURL=EnvironmentDataManager.d.ts.map

package/dist/esm/managers/EnvironmentDataManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentDataManager.d.ts","sourceRoot":"","sources":["../../../src/managers/EnvironmentDataManager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAEjF;;GAEG;AACH,qBAAa,sBAAsB;IAY/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAXxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAE7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAGpC,qBAAqB,EAAE,qBAAqB;IAG/D;;;;;;OAMG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3E;;;;OAIG;IACU,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;;;;OAKG;IACU,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB1E;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyBlE;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/esm/managers/EnvironmentDataManager.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentDataManager = void 0;
+const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
+const Logger_1 = require("../utils/Logger");
+/**
+ * Manager class for handling environment data operations with business logic constraints.
+ */
+class EnvironmentDataManager {
+    constructor(envPersistenceFactory) {
+        this.envPersistenceFactory = envPersistenceFactory;
+    }
+    /**
+     * Stores an environment datum with validation.
+     *
+     * @param key The key for the environment datum
+     * @param value The value to store
+     * @throws InvalidParamValueException if the key or value is invalid
+     */
+    async setEnvironmentDatum(key, value) {
+        // Validate the key and value
+        this.validateKey(key);
+        this.validateValue(value);
+        // Store in all persistence layers
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            await persistence.setEnvironmentDatum(key, value);
+        }
+    }
+    /**
+     * Deletes an environment datum by key.
+     *
+     * @param key The key of the datum to delete
+     */
+    async deleteEnvironmentDatum(key) {
+        this.validateKey(key);
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            await persistence.deleteEnvironmentDatum(key);
+        }
+    }
+    /**
+     * Retrieves an environment datum by key.
+     *
+     * @param key The key of the datum to retrieve
+     * @returns The environment datum value or undefined if not found
+     */
+    async getEnvironmentDatum(key) {
+        this.validateKey(key);
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            try {
+                const value = await persistence.getEnvironmentDatum(key);
+                if (value !== undefined) {
+                    return value;
+                }
+            }
+            catch (error) {
+                Logger_1.appLogger.warn(`Failed to get environment datum from persistence layer: ${error}`);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Retrieves all environment data.
+     *
+     * @returns A record of all environment data where keys are datum keys and values are datum values
+     */
+    async getEnvironmentData() {
+        const result = {};
+        const persistenceLayers = await this.envPersistenceFactory.createPersistenceLayers();
+        for (const persistence of persistenceLayers) {
+            try {
+                const data = await persistence.getEnvironmentData();
+                // Merge data, giving preference to values from earlier persistence layers
+                for (const [key, value] of Object.entries(data)) {
+                    if (!(key in result)) {
+                        result[key] = value;
+                    }
+                }
+            }
+            catch (error) {
+                Logger_1.appLogger.warn(`Failed to get environment data from persistence layer: ${error}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * Validates an environment data key against business rules.
+     *
+     * @param key The key to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    validateKey(key) {
+        // Check if key is provided
+        if (!key || key.trim().length === 0) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, 'key cannot be empty');
+        }
+        // Check length constraint
+        if (key.length > EnvironmentDataManager.MAX_KEY_LENGTH) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, `exceeds maximum allowed length of ${EnvironmentDataManager.MAX_KEY_LENGTH} characters`);
+        }
+        // Check for invalid characters
+        if (/[\s\\\/\:\*\?\"\<\>\|]/.test(key)) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('key', key, 'key contains invalid characters (space or one of \\ / : * ? " < > |)');
+        }
+    }
+    /**
+     * Validates an environment data value against business rules.
+     *
+     * @param value The value to validate
+     * @throws InvalidParamValueException if validation fails
+     */
+    validateValue(value) {
+        // Check if value is provided
+        if (value === undefined || value === null) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('value', 'undefined', 'value cannot be undefined or null');
+        }
+        // Check length constraint
+        if (value.length > EnvironmentDataManager.MAX_VALUE_LENGTH) {
+            throw new InvalidParamValueException_1.InvalidParamValueException('value', `${value.length} characters`, `exceeds maximum allowed length of ${EnvironmentDataManager.MAX_VALUE_LENGTH} characters`);
+        }
+    }
+}
+exports.EnvironmentDataManager = EnvironmentDataManager;
+/**
+ * Maximum length allowed for an environment data key.
+ */
+EnvironmentDataManager.MAX_KEY_LENGTH = 128;
+/**
+ * Maximum length allowed for environment data value
+ */
+EnvironmentDataManager.MAX_VALUE_LENGTH = 1024 * 1024; // 1MB
+//# sourceMappingURL=EnvironmentDataManager.js.map

package/dist/esm/managers/EnvironmentDataManager.js.map

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

package/dist/esm/managers/GptConfigsManager.d.ts

@@ -1,5 +1,5 @@
 import { GptConfig } from '../models/GptConfig';
-import { GptConfigsPersistence } from '../persistence/GptConfigsPersistence';
+import { GptConfigsPersistence } from '../persistence/gptconfigs/GptConfigsPersistence';
 /**
  * This class manages GPT configs and is responsible for validation around
  * that context.

package/dist/esm/managers/GptConfigsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GptConfigsManager.d.ts","sourceRoot":"","sources":["../../../src/managers/GptConfigsManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAM7E;;;GAGG;AACH,qBAAa,iBAAiB;IACR,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAhD,OAAO;WAEa,MAAM,CACxB,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;OAIG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlD;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAItD;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,sBAAsB;IAepC;;;OAGG;YACW,+BAA+B;CA4H9C"}
+{"version":3,"file":"GptConfigsManager.d.ts","sourceRoot":"","sources":["../../../src/managers/GptConfigsManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAMxF;;;GAGG;AACH,qBAAa,iBAAiB;IACR,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAhD,OAAO;WAEa,MAAM,CACxB,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;OAIG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACU,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlD;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAItD;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;OAEG;YACW,sBAAsB;IAepC;;;OAGG;YACW,+BAA+B;CA4H9C"}

package/dist/esm/managers/InteractionVisualizer.d.ts

@@ -1,37 +1,15 @@
 import { Page, Locator } from 'playwright';
-/**
- * Class for visualizing interactions in a webpage with a virtual mouse and messages.
- */
 export declare class InteractionVisualizer {
     readonly defaultMessageDurationMillis: number;
-    private static readonly VIRTUAL_MOUSE_SVG;
+    private static readonly SVG_MOUSE;
     private static readonly CSS;
-    private static readonly MESSAGE_CONTAINER_ID;
-    private static readonly VIRTUAL_MOUSE_ID;
-    private static readonly registeredContexts;
-    private currentMousePosition;
-    /**
-     * Creates an instance of InteractionVisualizer.
-     * @param defaultMessageDurationMillis - Default duration for displaying messages in milliseconds.
-     */
+    private static readonly CONTAINER_ID;
+    private cursorPos;
     constructor(defaultMessageDurationMillis: number);
-    /**
-     * Moves the virtual mouse to the element with a smooth animation and
-     * optionally displays a message at element.
-     */
-    pointAt(page: Page, element: Locator, message?: string, durationMillis?: number): Promise<void>;
-    /**
-     * Moves the virtual mouse to the target position with a smooth animation.
-     */
-    private moveVirtualMouse;
-    /**
-     * Creates a message adjacent to the element, inside a shadow root to avoid CSS collisions.
-     */
-    private displayMessageNearElement;
-    /**
-     * Ensures routes are registered for the given browser context.
-     * @param browserContext - The browser context to register routes on.
-     */
-    private static ensureRoutesRegistered;
+    /** Move the virtual cursor to the centre of the locator and optionally show a message. */
+    pointAt(page: Page, locator: Locator, message?: string, duration?: number): Promise<void>;
+    private ensureContainer;
+    private moveCursor;
+    private showMessage;
 }
 //# sourceMappingURL=InteractionVisualizer.d.ts.map

package/dist/esm/managers/InteractionVisualizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InteractionVisualizer.d.ts","sourceRoot":"","sources":["../../../src/managers/InteractionVisualizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAkB,MAAM,YAAY,CAAC;AAK3D;;GAEG;AACH,qBAAa,qBAAqB;aAeG,4BAA4B,EAAE,MAAM;IAdvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAEvC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAmD;IAC9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CACR;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAiC;IAC3E,OAAO,CAAC,oBAAoB,CAAkB;IAE9C;;;OAGG;gBACgC,4BAA4B,EAAE,MAAM;IAEvE;;;OAGG;IACU,OAAO,CAClB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,GAAE,MAA0C,GACzD,OAAO,CAAC,IAAI,CAAC;IA4DhB;;OAEG;YACW,gBAAgB;IA8F9B;;OAEG;YACW,yBAAyB;IAgDvC;;;OAGG;mBACkB,sBAAsB;CAkC5C"}
+{"version":3,"file":"InteractionVisualizer.d.ts","sourceRoot":"","sources":["../../../src/managers/InteractionVisualizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,qBAAqB;aA6BG,4BAA4B,EAAE,MAAM;IAxBvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAW3B;IAEN,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAM3B;IAEA,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAuB;IAC3D,OAAO,CAAC,SAAS,CAA4C;gBAE1B,4BAA4B,EAAE,MAAM;IAMvE,0FAA0F;IAC7E,OAAO,CAClB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,SAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC;YAsBF,eAAe;YA8Bf,UAAU;YAkDV,WAAW;CA8C1B"}