donobu 1.0.0

package/dist/esm/test.js

@@ -0,0 +1,288 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+exports.getBrowserStorageState = getBrowserStorageState;
+exports.getBrowserStorageStateFixture = getBrowserStorageStateFixture;
+exports.getAnthropicClient = getAnthropicClient;
+exports.getAnthropicClientFixture = getAnthropicClientFixture;
+exports.getGoogleGeminiClient = getGoogleGeminiClient;
+exports.getGoogleGeminiClientFixture = getGoogleGeminiClientFixture;
+exports.getOpenAiClient = getOpenAiClient;
+exports.getOpenAiClientFixture = getOpenAiClientFixture;
+exports.getAnthropicAwsBedrockClient = getAnthropicAwsBedrockClient;
+exports.getAnthropicAwsBedrockClientFixture = getAnthropicAwsBedrockClientFixture;
+/**
+ * This code extends the Playwright Page object and test fixture with
+ * test-related Donobu methods.
+ */
+const crypto_1 = __importDefault(require("crypto"));
+const test_1 = require("@playwright/test");
+const DonobuFlowsManager_1 = require("./managers/DonobuFlowsManager");
+const FlowsPersistenceFactoryImpl_1 = require("./persistence/FlowsPersistenceFactoryImpl");
+const RequestContextHolder_1 = require("./managers/RequestContextHolder");
+const ToolManager_1 = require("./managers/ToolManager");
+const ToolTipper_1 = require("./managers/ToolTipper");
+const FlowMetadata_1 = require("./models/FlowMetadata");
+const PlaywrightUtils_1 = require("./utils/PlaywrightUtils");
+const MiscUtils_1 = require("./utils/MiscUtils");
+const DonobuDeploymentEnvironment_1 = require("./models/DonobuDeploymentEnvironment");
+const GptConfigsManager_1 = require("./managers/GptConfigsManager");
+const AgentsManager_1 = require("./managers/AgentsManager");
+const GptConfigsPersistenceSqlite_1 = require("./persistence/GptConfigsPersistenceSqlite");
+const DonobuSqliteDb_1 = require("./persistence/DonobuSqliteDb");
+const AgentsPersistenceSqlite_1 = require("./persistence/AgentsPersistenceSqlite");
+const GptClientFactory_1 = require("./clients/GptClientFactory");
+async function setupDonobu() {
+    const donobuVersion = MiscUtils_1.MiscUtils.DONOBU_VERSION;
+    const deploymentEnvironment = DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.LOCAL;
+    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_1.DonobuDeploymentEnvironment.LOCAL, new RequestContextHolder_1.RequestContextHolder());
+    const toolManager = new ToolManager_1.ToolManager(ToolManager_1.ToolManager.ALL_TOOLS);
+    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(deploymentEnvironment, gptConfigsManager, agentsManager, flowsPersistenceFactory, toolManager.tools);
+    const persistenceLayer = await flowsPersistenceFactory.createPersistenceLayer();
+    return {
+        donobuVersion,
+        deploymentEnvironment,
+        flowsPersistenceFactory,
+        toolManager,
+        flowsManager,
+        persistenceLayer,
+    };
+}
+async function getBrowserStorageState(flowIdOrName) {
+    return (await setupDonobu()).flowsManager.getBrowserStorageState(flowIdOrName);
+}
+function getBrowserStorageStateFixture(flowIdOrName) {
+    return async ({}, use) => {
+        const storage = await (await setupDonobu()).flowsManager.getBrowserStorageState(flowIdOrName);
+        await use(storage);
+    };
+}
+async function getAnthropicClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.ANTHROPIC_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the Anthropic API. Please provide one as an argument or set it using the ANTHROPIC_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'ANTHROPIC',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getAnthropicClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getAnthropicClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getGoogleGeminiClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the Google Gemini API. Please provide one as an argument or set it using the GOOGLE_GENERATIVE_AI_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'GOOGLE_GEMINI',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getGoogleGeminiClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getGoogleGeminiClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getOpenAiClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.OPENAI_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the OpenAI API. Please provide one as an argument or set it using the OPENAI_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'OPENAI',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getOpenAiClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getOpenAiClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getAnthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey) {
+    const divinedAccessKeyId = accessKeyId || process.env.AWS_ACCESS_KEY_ID;
+    const divinedSecretAccessKey = secretAccessKey || process.env.AWS_SECRET_ACCESS_KEY;
+    if (!divinedAccessKeyId || !divinedSecretAccessKey) {
+        throw new Error('AWS access key ID and secret access key are required to use the Anthropic AWS Bedrock API. Please provide them as arguments or set them using the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'ANTHROPIC_AWS_BEDROCK',
+        region: region,
+        modelName: modelName,
+        accessKeyId: divinedAccessKeyId,
+        secretAccessKey: divinedSecretAccessKey,
+    });
+}
+function getAnthropicAwsBedrockClientFixture(modelName, region, accessKeyId, secretAccessKey) {
+    return async ({}, use) => {
+        const client = await getAnthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey);
+        await use(client);
+    };
+}
+exports.test = test_1.test.extend({
+    // 1) Declare `gptClient` as an "option" fixture with a default of `undefined`.
+    gptClient: [
+        undefined, // default
+        { option: true }, // so that test.use({ gptClient: ... }) can override
+    ],
+    // Override the default page fixture
+    page: async ({ page, gptClient }, use, testInfo) => {
+        // Patch the page with "run", but do it lazily
+        const donobu = await setupDonobu();
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.accessibilityTestInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.clickableElementsTrackerInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.dialogPromptTrackerInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.smartSelectorGeneratorInitScript());
+        let isInitialized = false;
+        async function maybeInitDonobu() {
+            if (isInitialized) {
+                return;
+            }
+            const donobuTestFlowMetadata = {
+                id: crypto_1.default.randomUUID(),
+                name: testInfo.title,
+                createdWithDonobuVersion: donobu.donobuVersion,
+                initialBrowserState: null,
+                persistBrowserState: null,
+                gptConfigName: null,
+                hasGptConfigNameOverride: false,
+                customTools: null,
+                defaultToolTipDurationMilliseconds: 0,
+                runMode: FlowMetadata_1.RunMode.DETERMINISTIC,
+                isControlPanelEnabled: false,
+                deviceName: null,
+                remoteBrowserInstanceUrl: null,
+                callbackUrl: null,
+                headless: true,
+                targetWebsite: 'https://example.com',
+                overallObjective: null,
+                allowedTools: [],
+                resultJsonSchema: null,
+                result: null,
+                inputTokensUsed: 0,
+                completionTokensUsed: 0,
+                iterations: 0,
+                maxIterations: 0,
+                startedAt: new Date().getTime(),
+                completedAt: null,
+                state: FlowMetadata_1.State.RUNNING_ACTION,
+                nextState: null,
+            };
+            await donobu.persistenceLayer.saveMetadata(donobuTestFlowMetadata);
+            page._donobu = donobu;
+            page._donobuFlowMetadata = donobuTestFlowMetadata;
+            page._gptClient = gptClient ?? null;
+            isInitialized = true;
+        }
+        page.run = async (toolName, toolParams) => {
+            await maybeInitDonobu();
+            const clonedParams = toolParams
+                ? JSON.parse(JSON.stringify(toolParams))
+                : {};
+            clonedParams.rationale ||= '';
+            const toolCallContext = {
+                flowsManager: page._donobu.flowsManager,
+                persistence: page._donobu.persistenceLayer,
+                gptClient: page._gptClient,
+                toolTipper: new ToolTipper_1.ToolTipper(0),
+                proposedToolCalls: [],
+                invokedToolCalls: [],
+                page: page,
+                metadata: page._donobuFlowMetadata,
+                toolCallId: clonedParams.toolCallId ?? MiscUtils_1.MiscUtils.createAdHocToolCallId(),
+            };
+            const proposedToolCall = {
+                name: toolName,
+                parameters: clonedParams,
+                toolCallId: null,
+            };
+            return page._donobu.toolManager
+                .invokeTool(toolCallContext, proposedToolCall, false)
+                .then(async (result) => {
+                await page._donobu.persistenceLayer.saveMetadata(page._donobuFlowMetadata);
+                await page._donobu.persistenceLayer.saveToolCall(page._donobuFlowMetadata.id, result);
+                return result;
+            })
+                .then((result) => result.outcome);
+        };
+        page.analyzePageText = async (params) => {
+            return page.run('analyzePageText', params);
+        };
+        page.chooseSelectOption = async (params) => {
+            return page.run('chooseSelectOption', params);
+        };
+        page.clickElement = async (params) => {
+            return page.run('click', params);
+        };
+        page.createCookieReport = async () => {
+            return page.run('createCookieReport');
+        };
+        page.detectBrokenLinks = async () => {
+            return page.run('detectBrokenLinks');
+        };
+        page.hoverOverElement = async (params) => {
+            return page.run('hover', params);
+        };
+        page.inputRandomizedEmailAddress = async (params) => {
+            return page.run('inputRandomizedEmailAddress', params);
+        };
+        page.inputText = async (params) => {
+            return page.run('inputText', params);
+        };
+        page.pressKey = async (params) => {
+            return page.run('pressKey', params);
+        };
+        page.runAccessibilityTest = async () => {
+            return page.run('runAccessibilityTest');
+        };
+        page.scroll = async (params) => {
+            return page.run('scrollPage', params);
+        };
+        page.visuallyAssert = async (params) => {
+            return page.run('assert', params);
+        };
+        try {
+            // Let Playwright continue and give tests the patched page.
+            await use(page);
+        }
+        finally {
+            try {
+                if (page._donobuFlowMetadata) {
+                    page._donobuFlowMetadata.state = FlowMetadata_1.State.SUCCESS;
+                    page._donobuFlowMetadata.completedAt = new Date().getTime();
+                    await page._donobu.persistenceLayer.saveMetadata(page._donobuFlowMetadata);
+                }
+            }
+            catch (error) {
+                // Log but don't throw, to ensure cleanup continues.
+                console.error('Error during test cleanup:', error);
+            }
+        }
+    },
+});
+//# sourceMappingURL=test.js.map

package/dist/esm/test.js.map

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

package/dist/esm/testfixtures.d.ts

@@ -0,0 +1,66 @@
+import { TestFixture } from '@playwright/test';
+import type { Page } from '@playwright/test';
+import { DonobuFlowsManager } from './managers/DonobuFlowsManager';
+import { FlowsPersistenceFactory } from './persistence/FlowsPersistenceFactory';
+import { ToolManager } from './managers/ToolManager';
+import { FlowMetadata } from './models/FlowMetadata';
+import { BrowserStorageState } from './models/BrowserState';
+import { FlowsPersistence } from './persistence/FlowsPersistence';
+import { DonobuDeploymentEnvironment } from './models/DonobuDeploymentEnvironment';
+import { BrowserStateFlowReference } from './models/BrowserStateFlowReference';
+import { ToolCallResult } from './models/ToolCallResult';
+import { AnalyzePageTextToolCoreParameters } from './tools/AnalyzePageTextTool';
+import { AssertToolCoreParameters } from './tools/AssertTool';
+import { GptClient } from './clients/GptClient';
+import { SelectorBasedChooseSelectOptionToolParameters } from './tools/ChooseSelectOptionTool';
+import { InputRandomizedEmailAddressToolCoreParameters } from './tools/InputRandomizedEmailAddressTool';
+import { SelectorBasedInputTextToolParameters } from './tools/InputTextTool';
+import { SelectorBasedPressKeyToolParameters } from './tools/PressKeyTool';
+import { ScrollPageToolCoreParameters } from './tools/ScrollPageTool';
+import { SelectorBasedHoverOverElementToolParameters } from './tools/HoverOverElementTool';
+import { SelectorBasedClickToolParameters } from './tools/ClickTool';
+/**
+ * Extends the Page object with additional test-related methods.
+ */
+interface DonobuExtendedPage extends Page {
+    run(toolName: string, toolParams?: any): Promise<ToolCallResult>;
+    analyzePageText(params: AnalyzePageTextToolCoreParameters): Promise<ToolCallResult>;
+    chooseSelectOption(params: SelectorBasedChooseSelectOptionToolParameters): Promise<ToolCallResult>;
+    clickElement(params: SelectorBasedClickToolParameters): Promise<ToolCallResult>;
+    createCookieReport(): Promise<ToolCallResult>;
+    detectBrokenLinks(): Promise<ToolCallResult>;
+    hoverOverElement(params: SelectorBasedHoverOverElementToolParameters): Promise<ToolCallResult>;
+    inputRandomizedEmailAddress(params: InputRandomizedEmailAddressToolCoreParameters): Promise<ToolCallResult>;
+    inputText(params: SelectorBasedInputTextToolParameters): Promise<ToolCallResult>;
+    pressKey(params: SelectorBasedPressKeyToolParameters): Promise<ToolCallResult>;
+    runAccessibilityTest(): Promise<ToolCallResult>;
+    scroll(params: ScrollPageToolCoreParameters): Promise<ToolCallResult>;
+    visuallyAssert(params: AssertToolCoreParameters): Promise<ToolCallResult>;
+    _donobu: DonobuParams;
+    _donobuFlowMetadata: FlowMetadata;
+    _gptClient: GptClient | null;
+}
+type DonobuParams = {
+    donobuVersion: string;
+    deploymentEnvironment: DonobuDeploymentEnvironment;
+    flowsPersistenceFactory: FlowsPersistenceFactory;
+    toolManager: ToolManager;
+    flowsManager: DonobuFlowsManager;
+    persistenceLayer: FlowsPersistence;
+};
+export declare function getBrowserStorageState(flowIdOrName: BrowserStateFlowReference): Promise<BrowserStorageState>;
+export declare function getBrowserStorageStateFixture(flowIdOrName: BrowserStateFlowReference): TestFixture<BrowserStorageState, any>;
+export declare function getAnthropicClient(modelName: string, apiKey?: string): Promise<GptClient>;
+export declare function getAnthropicClientFixture(modelName: string, apiKey?: string): TestFixture<GptClient, any>;
+export declare function getGoogleGeminiClient(modelName: string, apiKey?: string): Promise<GptClient>;
+export declare function getGoogleGeminiClientFixture(modelName: string, apiKey?: string): TestFixture<GptClient, any>;
+export declare function getOpenAiClient(modelName: string, apiKey?: string): Promise<GptClient>;
+export declare function getOpenAiClientFixture(modelName: string, apiKey?: string): TestFixture<GptClient, any>;
+export declare function getAnthropicAwsBedrockClient(modelName: string, region: string, accessKeyId?: string, secretAccessKey?: string): Promise<GptClient>;
+export declare function getAnthropicAwsBedrockClientFixture(modelName: string, region: string, accessKeyId?: string, secretAccessKey?: string): TestFixture<GptClient, any>;
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    storageState?: BrowserStorageState | Promise<BrowserStorageState>;
+    gptClient?: GptClient;
+    page: DonobuExtendedPage;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export {};

package/dist/esm/testfixtures.js

@@ -0,0 +1,288 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+exports.getBrowserStorageState = getBrowserStorageState;
+exports.getBrowserStorageStateFixture = getBrowserStorageStateFixture;
+exports.getAnthropicClient = getAnthropicClient;
+exports.getAnthropicClientFixture = getAnthropicClientFixture;
+exports.getGoogleGeminiClient = getGoogleGeminiClient;
+exports.getGoogleGeminiClientFixture = getGoogleGeminiClientFixture;
+exports.getOpenAiClient = getOpenAiClient;
+exports.getOpenAiClientFixture = getOpenAiClientFixture;
+exports.getAnthropicAwsBedrockClient = getAnthropicAwsBedrockClient;
+exports.getAnthropicAwsBedrockClientFixture = getAnthropicAwsBedrockClientFixture;
+/**
+ * This code extends the Playwright Page object and test fixture with
+ * test-related Donobu methods.
+ */
+const crypto_1 = __importDefault(require("crypto"));
+const test_1 = require("@playwright/test");
+const DonobuFlowsManager_1 = require("./managers/DonobuFlowsManager");
+const FlowsPersistenceFactoryImpl_1 = require("./persistence/FlowsPersistenceFactoryImpl");
+const RequestContextHolder_1 = require("./managers/RequestContextHolder");
+const ToolManager_1 = require("./managers/ToolManager");
+const ToolTipper_1 = require("./managers/ToolTipper");
+const FlowMetadata_1 = require("./models/FlowMetadata");
+const PlaywrightUtils_1 = require("./utils/PlaywrightUtils");
+const MiscUtils_1 = require("./utils/MiscUtils");
+const DonobuDeploymentEnvironment_1 = require("./models/DonobuDeploymentEnvironment");
+const GptConfigsManager_1 = require("./managers/GptConfigsManager");
+const AgentsManager_1 = require("./managers/AgentsManager");
+const GptConfigsPersistenceSqlite_1 = require("./persistence/GptConfigsPersistenceSqlite");
+const DonobuSqliteDb_1 = require("./persistence/DonobuSqliteDb");
+const AgentsPersistenceSqlite_1 = require("./persistence/AgentsPersistenceSqlite");
+const GptClientFactory_1 = require("./clients/GptClientFactory");
+async function setupDonobu() {
+    const donobuVersion = MiscUtils_1.MiscUtils.DONOBU_VERSION;
+    const deploymentEnvironment = DonobuDeploymentEnvironment_1.DonobuDeploymentEnvironment.LOCAL;
+    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_1.DonobuDeploymentEnvironment.LOCAL, new RequestContextHolder_1.RequestContextHolder());
+    const toolManager = new ToolManager_1.ToolManager(ToolManager_1.ToolManager.ALL_TOOLS);
+    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(deploymentEnvironment, gptConfigsManager, agentsManager, flowsPersistenceFactory, toolManager.tools);
+    const persistenceLayer = await flowsPersistenceFactory.createPersistenceLayer();
+    return {
+        donobuVersion,
+        deploymentEnvironment,
+        flowsPersistenceFactory,
+        toolManager,
+        flowsManager,
+        persistenceLayer,
+    };
+}
+async function getBrowserStorageState(flowIdOrName) {
+    return (await setupDonobu()).flowsManager.getBrowserStorageState(flowIdOrName);
+}
+function getBrowserStorageStateFixture(flowIdOrName) {
+    return async ({}, use) => {
+        const storage = await (await setupDonobu()).flowsManager.getBrowserStorageState(flowIdOrName);
+        await use(storage);
+    };
+}
+async function getAnthropicClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.ANTHROPIC_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the Anthropic API. Please provide one as an argument or set it using the ANTHROPIC_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'ANTHROPIC',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getAnthropicClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getAnthropicClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getGoogleGeminiClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the Google Gemini API. Please provide one as an argument or set it using the GOOGLE_GENERATIVE_AI_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'GOOGLE_GEMINI',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getGoogleGeminiClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getGoogleGeminiClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getOpenAiClient(modelName, apiKey) {
+    const divinedApiKey = apiKey || process.env.OPENAI_API_KEY;
+    if (!divinedApiKey) {
+        throw new Error('An API key is required to use the OpenAI API. Please provide one as an argument or set it using the OPENAI_API_KEY environment variable.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'OPENAI',
+        apiKey: divinedApiKey,
+        modelName: modelName,
+    });
+}
+function getOpenAiClientFixture(modelName, apiKey) {
+    return async ({}, use) => {
+        const client = await getOpenAiClient(modelName, apiKey);
+        await use(client);
+    };
+}
+async function getAnthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey) {
+    const divinedAccessKeyId = accessKeyId || process.env.AWS_ACCESS_KEY_ID;
+    const divinedSecretAccessKey = secretAccessKey || process.env.AWS_SECRET_ACCESS_KEY;
+    if (!divinedAccessKeyId || !divinedSecretAccessKey) {
+        throw new Error('AWS access key ID and secret access key are required to use the Anthropic AWS Bedrock API. Please provide them as arguments or set them using the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.');
+    }
+    return GptClientFactory_1.GptClientFactory.createFromGptConfig({
+        type: 'ANTHROPIC_AWS_BEDROCK',
+        region: region,
+        modelName: modelName,
+        accessKeyId: divinedAccessKeyId,
+        secretAccessKey: divinedSecretAccessKey,
+    });
+}
+function getAnthropicAwsBedrockClientFixture(modelName, region, accessKeyId, secretAccessKey) {
+    return async ({}, use) => {
+        const client = await getAnthropicAwsBedrockClient(modelName, region, accessKeyId, secretAccessKey);
+        await use(client);
+    };
+}
+exports.test = test_1.test.extend({
+    // 1) Declare `gptClient` as an "option" fixture with a default of `undefined`.
+    gptClient: [
+        undefined, // default
+        { option: true }, // so that test.use({ gptClient: ... }) can override
+    ],
+    // Override the default page fixture
+    page: async ({ page, gptClient }, use, testInfo) => {
+        // Patch the page with "run", but do it lazily
+        const donobu = await setupDonobu();
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.accessibilityTestInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.clickableElementsTrackerInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.dialogPromptTrackerInitScript());
+        await page
+            .context()
+            .addInitScript(PlaywrightUtils_1.PlaywrightUtils.smartSelectorGeneratorInitScript());
+        let isInitialized = false;
+        async function maybeInitDonobu() {
+            if (isInitialized) {
+                return;
+            }
+            const donobuTestFlowMetadata = {
+                id: crypto_1.default.randomUUID(),
+                name: testInfo.title,
+                createdWithDonobuVersion: donobu.donobuVersion,
+                initialBrowserState: null,
+                persistBrowserState: null,
+                gptConfigName: null,
+                hasGptConfigNameOverride: false,
+                customTools: null,
+                defaultToolTipDurationMilliseconds: 0,
+                runMode: FlowMetadata_1.RunMode.DETERMINISTIC,
+                isControlPanelEnabled: false,
+                deviceName: null,
+                remoteBrowserInstanceUrl: null,
+                callbackUrl: null,
+                headless: true,
+                targetWebsite: 'https://example.com',
+                overallObjective: null,
+                allowedTools: [],
+                resultJsonSchema: null,
+                result: null,
+                inputTokensUsed: 0,
+                completionTokensUsed: 0,
+                iterations: 0,
+                maxIterations: 0,
+                startedAt: new Date().getTime(),
+                completedAt: null,
+                state: FlowMetadata_1.State.RUNNING_ACTION,
+                nextState: null,
+            };
+            await donobu.persistenceLayer.saveMetadata(donobuTestFlowMetadata);
+            page._donobu = donobu;
+            page._donobuFlowMetadata = donobuTestFlowMetadata;
+            page._gptClient = gptClient ?? null;
+            isInitialized = true;
+        }
+        page.run = async (toolName, toolParams) => {
+            await maybeInitDonobu();
+            const clonedParams = toolParams
+                ? JSON.parse(JSON.stringify(toolParams))
+                : {};
+            clonedParams.rationale ||= '';
+            const toolCallContext = {
+                flowsManager: page._donobu.flowsManager,
+                persistence: page._donobu.persistenceLayer,
+                gptClient: page._gptClient,
+                toolTipper: new ToolTipper_1.ToolTipper(0),
+                proposedToolCalls: [],
+                invokedToolCalls: [],
+                page: page,
+                metadata: page._donobuFlowMetadata,
+                toolCallId: clonedParams.toolCallId ?? MiscUtils_1.MiscUtils.createAdHocToolCallId(),
+            };
+            const proposedToolCall = {
+                name: toolName,
+                parameters: clonedParams,
+                toolCallId: null,
+            };
+            return page._donobu.toolManager
+                .invokeTool(toolCallContext, proposedToolCall, false)
+                .then(async (result) => {
+                await page._donobu.persistenceLayer.saveMetadata(page._donobuFlowMetadata);
+                await page._donobu.persistenceLayer.saveToolCall(page._donobuFlowMetadata.id, result);
+                return result;
+            })
+                .then((result) => result.outcome);
+        };
+        page.analyzePageText = async (params) => {
+            return page.run('analyzePageText', params);
+        };
+        page.chooseSelectOption = async (params) => {
+            return page.run('chooseSelectOption', params);
+        };
+        page.clickElement = async (params) => {
+            return page.run('click', params);
+        };
+        page.createCookieReport = async () => {
+            return page.run('createCookieReport');
+        };
+        page.detectBrokenLinks = async () => {
+            return page.run('detectBrokenLinks');
+        };
+        page.hoverOverElement = async (params) => {
+            return page.run('hover', params);
+        };
+        page.inputRandomizedEmailAddress = async (params) => {
+            return page.run('inputRandomizedEmailAddress', params);
+        };
+        page.inputText = async (params) => {
+            return page.run('inputText', params);
+        };
+        page.pressKey = async (params) => {
+            return page.run('pressKey', params);
+        };
+        page.runAccessibilityTest = async () => {
+            return page.run('runAccessibilityTest');
+        };
+        page.scroll = async (params) => {
+            return page.run('scrollPage', params);
+        };
+        page.visuallyAssert = async (params) => {
+            return page.run('assert', params);
+        };
+        try {
+            // Let Playwright continue and give tests the patched page.
+            await use(page);
+        }
+        finally {
+            try {
+                if (page._donobuFlowMetadata) {
+                    page._donobuFlowMetadata.state = FlowMetadata_1.State.SUCCESS;
+                    page._donobuFlowMetadata.completedAt = new Date().getTime();
+                    await page._donobu.persistenceLayer.saveMetadata(page._donobuFlowMetadata);
+                }
+            }
+            catch (error) {
+                // Log but don't throw, to ensure cleanup continues.
+                console.error('Error during test cleanup:', error);
+            }
+        }
+    },
+});
+//# sourceMappingURL=testfixtures.js.map