donobu 2.16.0 → 2.17.0

package/dist/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/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/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/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/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/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/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/managers/EnvDataManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvDataManager.js","sourceRoot":"","sources":["../../src/managers/EnvDataManager.ts"],"names":[],"mappings":";;;AAAA,yFAAsF;AACtF,4CAA4C;AAG5C;;GAEG;AACH,MAAa,cAAc;IAWzB,YACmB,qBAA4C;QAA5C,0BAAqB,GAArB,qBAAqB,CAAuB;IAC5D,CAAC;IAEJ;;;;;;OAMG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAW,EAAE,KAAa;QACzD,6BAA6B;QAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAE1B,kCAAkC;QAClC,MAAM,iBAAiB,GACrB,MAAM,IAAI,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,CAAC;QAE7D,KAAK,MAAM,WAAW,IAAI,iBAAiB,EAAE,CAAC;YAC5C,MAAM,WAAW,CAAC,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,sBAAsB,CAAC,GAAW;QAC7C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAEtB,MAAM,iBAAiB,GACrB,MAAM,IAAI,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,CAAC;QAE7D,KAAK,MAAM,WAAW,IAAI,iBAAiB,EAAE,CAAC;YAC5C,MAAM,WAAW,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,mBAAmB,CAAC,GAAW;QAC1C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAEtB,MAAM,iBAAiB,GACrB,MAAM,IAAI,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,CAAC;QAE7D,KAAK,MAAM,WAAW,IAAI,iBAAiB,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBAEzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kBAAS,CAAC,IAAI,CACZ,2DAA2D,KAAK,EAAE,CACnE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB;QAC7B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,MAAM,iBAAiB,GACrB,MAAM,IAAI,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,CAAC;QAE7D,KAAK,MAAM,WAAW,IAAI,iBAAiB,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,kBAAkB,EAAE,CAAC;gBAEpD,0EAA0E;gBAC1E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;wBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kBAAS,CAAC,IAAI,CACZ,0DAA0D,KAAK,EAAE,CAClE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,GAAW;QAC7B,2BAA2B;QAC3B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,uDAA0B,CAAC,KAAK,EAAE,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC1E,CAAC;QAED,0BAA0B;QAC1B,IAAI,GAAG,CAAC,MAAM,GAAG,cAAc,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,IAAI,uDAA0B,CAClC,KAAK,EACL,GAAG,EACH,qCAAqC,cAAc,CAAC,cAAc,aAAa,CAChF,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,uDAA0B,CAClC,KAAK,EACL,GAAG,EACH,sEAAsE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,KAAa;QACjC,6BAA6B;QAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,uDAA0B,CAClC,OAAO,EACP,WAAW,EACX,mCAAmC,CACpC,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,gBAAgB,EAAE,CAAC;YACnD,MAAM,IAAI,uDAA0B,CAClC,OAAO,EACP,GAAG,KAAK,CAAC,MAAM,aAAa,EAC5B,qCAAqC,cAAc,CAAC,gBAAgB,aAAa,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;;AAtKH,wCAuKC;AAtKC;;GAEG;AACqB,6BAAc,GAAG,GAAG,CAAC;AAE7C;;GAEG;AACqB,+BAAgB,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM"}

package/dist/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/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/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/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/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/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/managers/PageInspector.d.ts

@@ -141,7 +141,6 @@ export declare class PageInspector {
      * const inspector = new PageInspector();
      * await inspector.attributeInteractableElements(page);
      * await inspector.annotateInteractableElements(page);
-     * // Visible numbered annotations now appear over all interactable elements
      */
     annotateInteractableElements(page: Page): Promise<void>;
     /**

package/dist/managers/PageInspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageInspector.d.ts","sourceRoot":"","sources":["../../src/managers/PageInspector.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,aAAa;aAYN,4BAA4B,EAAE,MAAM;aACpC,+BAA+B,EAAE,MAAM;IAZzD;;;;;OAKG;IACH,gBAAuB,WAAW,SAEhC;gBAGgB,4BAA4B,GAAE,MAAmC,EACjE,+BAA+B,GAAE,MAAiC;IAGpF;;;;;;;;;;;;;;;;;;;OAmBG;IACU,6BAA6B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoErE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,iCAAiC,CAC5C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,4BAA4B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmJpE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAkBjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgVzC,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ3B"}
+{"version":3,"file":"PageInspector.d.ts","sourceRoot":"","sources":["../../src/managers/PageInspector.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,aAAa;aAYN,4BAA4B,EAAE,MAAM;aACpC,+BAA+B,EAAE,MAAM;IAZzD;;;;;OAKG;IACH,gBAAuB,WAAW,SAEhC;gBAGgB,4BAA4B,GAAE,MAAmC,EACjE,+BAA+B,GAAE,MAAiC;IAGpF;;;;;;;;;;;;;;;;;;;OAmBG;IACU,6BAA6B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoErE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,iCAAiC,CAC5C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,4BAA4B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuJpE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAkBjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgVzC,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ3B"}

package/dist/managers/PageInspector.js

@@ -235,7 +235,6 @@ class PageInspector {
      * const inspector = new PageInspector();
      * await inspector.attributeInteractableElements(page);
      * await inspector.annotateInteractableElements(page);
-     * // Visible numbered annotations now appear over all interactable elements
      */
     async annotateInteractableElements(page) {
         try {
@@ -252,8 +251,11 @@ class PageInspector {
                         container.id = 'annotation-shadow-container';
                         // Position container so child elements can be absolutely placed
                         Object.assign(container.style, {
-                            position: 'fixed', // anchor to viewport
-                            inset: '0', // stretch across it
+                            position: 'absolute',
+                            top: '0',
+                            left: '0',
+                            width: '100%',
+                            height: '100%',
                             pointerEvents: 'none', // Let clicks pass through
                             zIndex: '2147483647', // win every z-index fight
                         });
@@ -275,29 +277,29 @@ class PageInspector {
                         // Add a <style> element inside the shadow root to reset and define annotation styles
                         const style = document.createElement('style');
                         style.textContent = `
-                    :host {
-                      all: initial; /* Reset styles in shadow root */
-                    }
-                    .annotation {
-                      position: absolute;
-                      z-index: 2147483647;
-                      background-color: black;
-                      color: white;
-                      width: 40px;
-                      height: 40px;
-                      border-radius: 50%;
-                      display: flex;
-                      align-items: center;
-                      justify-content: center;
-                      font-size: 14px;
-                      font-weight: bold;
-                      line-height: 20px;
-                      text-align: center;
-                      box-shadow: 0px 2px 4px rgba(0,0,0,0.2);
-                      border: 4px solid #FF4136;
-                      pointer-events: none;
-                    }
-                  `;
+                :host {
+                  all: initial; /* Reset styles in shadow root */
+                }
+                .annotation {
+                  position: absolute;
+                  z-index: 2147483647;
+                  background-color: black;
+                  color: white;
+                  width: 40px;
+                  height: 40px;
+                  border-radius: 50%;
+                  display: flex;
+                  align-items: center;
+                  justify-content: center;
+                  font-size: 14px;
+                  font-weight: bold;
+                  line-height: 20px;
+                  text-align: center;
+                  box-shadow: 0px 2px 4px rgba(0,0,0,0.2);
+                  border: 4px solid #FF4136;
+                  pointer-events: none;
+                }
+              `;
                         shadowRoot.appendChild(style);
                     }
                     // Retrieve the shadow root to place annotation elements
@@ -318,6 +320,7 @@ class PageInspector {
                     const positionAnnotation = (annotation, element) => {
                         const rect = element.getBoundingClientRect();
                         // Center the annotation on the element, adjusting for its size
+                        // Since container is absolute, we need to account for scroll position
                         const x = rect.left + rect.width / 2 - 20 + window.scrollX;
                         const y = rect.top + rect.height / 2 - 20 + window.scrollY;
                         annotation.style.left = `${x}px`;