donobu 2.52.0 → 3.0.0

package/README.md

@@ -1,121 +1,121 @@
-# Donobu
+# Donobu SDK
 
-This package allows people to create, edit, and run Playwright scripts using [Donobu](https://donobu.com).
+Create, run, and heal AI-assisted Playwright flows with a single dependency. The `donobu` package ships the Playwright fixture, Page.AI orchestration layer, CLI wrapper, failure triage, and plugin system to comprehensively test websites.
 
-Donobu extends the standard Playwright test fixture to include capabilities like:
+## Highlights
 
-- Adding prioritized failover for when standard one-shot selectors fail when clicking, inputting text, etc.
-- Performing selector-less visual/semantic assertions on a page.
-- Creating a browser cookie report for a page (`page.createCookieReport()`).
-- Running an accessibility test for a page (`page.runAccessibilityTest()`).
+- **Typed Playwright fixture** - `import { test } from 'donobu'` to extend Playwright with `page.ai` helpers, smart selectors, and persistence.
+- **Autonomous Page.AI** - run `page.ai.act()` with optional Zod schemas, cached tool-call replays, custom tool allow-lists, and env-var controls.
+- **Prebuilt tools** - call keyboard, mouse, accessibility, cookie, and analysis tools via friendly wrappers (`page.runAccessibilityTest`, etc).
+- **Failure triage & auto-heal** - `npx donobu test --auto-heal` captures screenshots, GPT reasoning, structured treatment plans, and can re-run fixes automatically.
 
-## Setup
+## Prerequisites
 
-1. `npm install donobu`
-2. `npx playwright install`
+- Node.js 18+ and npm 8+.
+- Playwright browsers (`npx playwright install`).
+- At least one LLM credential (OpenAI, Anthropic, Google Gemini, AWS Bedrock, or Donobu API).
 
-## Example
+## Installation
 
-```typescript
-/**
- * Be sure that Donobu is installed before running this script...
- *    'npm install donobu' or 'yarn add donobu'
- *
- * Also, be sure that Playwright's browsers are installed...
- *    'npx playwright install'
- *
- * Also, since this test is using tools that require the usage of an LLM, be
- * sure to have an appropriate LLM API key available as an environment variable
- * (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, etc).
- */
-import { test } from 'donobu';
-import { gptClientFixture } from 'donobu';
-
-const testTitle = 'Test for https://news.ycombinator.com';
-const testDetails = {
-  annotation: {
-    type: 'objective',
-    description: `Scroll down to find the search box and then do a search for "mac app for web testing".
-Assert that one of the top search results is for "Donobu".`,
-  },
-};
-test.extend({ gptClient: gptClientFixture() })(
-  testTitle,
-  testDetails,
-  async ({ page }) => {
-    // Initializing web navigation.
-    await page.goto('https://news.ycombinator.com');
-    // Scrolling down to find the search box which appears to be at the bottom of the page based on the preview image.
-    await page.scroll({
-      direction: 'DOWN',
-    });
-    // Inputting the search query "mac app for web testing" into the search box at the bottom of the page to fulfill the objective.
-    await page.inputText({
-      finalizeWithSubmit: true,
-      text: 'mac app for web testing',
-      selector: {
-        element: [
-          'form > :nth-child(1)',
-          'form > input:nth-of-type(1)',
-          'input',
-        ],
-        frame: null,
-      },
-    });
-    // Verifying that Donobu appears in the search results for "mac app for web testing" to fulfill the objective.
-    await page.assertPageText({
-      text: 'Show HN: Donobu – Mac App for Web Automation and Testing',
-    });
-  },
-);
+```bash
+npm install --save-dev donobu @playwright/test
+npx playwright install        # downloads browsers if needed
 ```
 
-[See additional examples in this repository](https://github.com/donobu-inc/playwright-flows).
+## Quick Start
 
-## Compound Self Healing
+1. **Author a test using the Donobu fixture**
 
-Donobu supports two layers of self healing.
+```ts
+import { test } from 'donobu';
 
-### Automatic Selector Failover
+test('Test for https://www.starbucks.com', async ({ page }) => {
+  await page.goto('https://www.starbucks.com');
+  await page.ai.act('Go to the featured menu page');
+  await page.ai.assertPage(
+    `Assert that the featured menu page has a seasonally appropriate vibe for ${new Date()}`,
+  );
+  await page.ai.act('Find a Starbucks store in Stowe, Vermont');
+  await page.ai.assertPage(
+    'Assert that a store in Stowe, Vermont is found and the map shows Mt. Mansfield close by.',
+  );
+});
+```
 
-When generating code using the [Donobu Application](https://www.donobu.com/download), the generated
-code will include a prioritized list of query selectors to attempt to use when interacting with a particular
-element in a website. Here is an example of a code snippet that uses prioritized selectors...
+2. **Run the test with Page.AI enabled**
 
-```
-await page.inputText({
-  finalizeWithSubmit: true,
-  text: 'mac app for web testing',
-  selector: {
-    element: [
-      'form > :nth-child(1)',
-      'form > input:nth-of-type(1)',
-      'input',
-    ],
-    frame: null,
-  },
-});
+```bash
+OPENAI_API_KEY=sk-*** npx donobu test
 ```
 
-In the above example, `['form > :nth-child(1)', 'form > input:nth-of-type(1)', 'input']`, is the prioritized
-selector queries. The first selector query will be attempted to be resolved and will have the text `mac app for web testing`
-inputted to it, if that fails, it tries the next query selector, and so on.
+`npx donobu test` proxies Playwright while wiring Donobu-specific env vars (triage directories, Page.AI cache clearing, auto-heal retries, etc.).
 
-### Automatic Testfile Updates
+### Page.AI API Surface
 
-When running code that was generated the [Donobu Application](https://www.donobu.com/download), the generated
-code can attempt to update itself if the test case itself flatly fails (e.g. automatic selector failover
-entirely fails due to the underlying website materially changing). In this case, Donobu will attempt to
-re-run the test using an AI agent to help it through, then update the test file as necessary. This method of
-self healing is optional, and opt-in.
+| Method                                       | Description                                                             | Key options                                                                                                                          |
+| -------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `await page.ai.act(instruction, opts?)`      | Launches an autonomous Donobu flow that can call browser tools and GPT. | `schema` (Zod) for structured output, `allowedTools`, `maxToolCalls` (default 25), `cache` (default `true`), `envVars`, `gptClient`. |
+| `await page.ai.assertPage(assertion, opts?)` | AI assertion against DOM text, screenshot, title, and URL.              | `retries`, `retryDelaySeconds`, `gptClient`.                                                                                         |
+| `await page.ai.extract(schema, opts?)`       | Produce JSON data shaped by a Zod schema using screenshot + history.    | `instruction`, `gptClient`.                                                                                                          |
 
-To use this feature, run the the test with the `SELF_HEAL_TESTS_ENABLED` environment variable set to `true`,
-and have an LLM API key set up (of which can also be done via an environment variable).
+- Every invocation is cached by URL+instruction+schema in `<spec directory>/donobu.json`. Call `await page._dnb.pageAi?.invalidate(...)` or run `npx donobu test --clear-ai-cache` to regenerate tool calls.
+- Provide a custom LLM by passing `gptClient` (a Donobu `GptClient` or any `LanguageModel` supported by `ai`’s Vercel SDK).
+- Use `envVars` to explicitly pass secret names the flow may read. Donobu also parses `$.env.SECRET_NAME` placeholders in the `objective` annotation to whitelist secrets.
 
-Here is an example terminal command:
+## Page.AI Caching, Env Vars, and Secrets
 
-```
-SELF_HEAL_TESTS_ENABLED=true \
-ANTHROPIC_API_KEY=your-api-key \
-npx playwright test your-test.ts
-```
+- Per-spec cache: Page.AI cache entries are saved next to the spec (`donobu.json`). Commit them to stabilise selectors or delete to regenerate.
+- CLI toggles: `--clear-ai-cache` (or `DONOBU_PAGE_AI_CLEAR_CACHE=1`) clears cache before each `page.ai.act`.
+- Whitelisting env vars: add `$.env.MY_SECRET` inside the objective or annotate tests manually:
+  ```ts
+  test('uses secret', async ({ page }, testInfo) => {
+    testInfo.annotations.push({ type: 'ENV', description: 'MY_SECRET' });
+    await page.ai.act('Log in using $.env.MY_SECRET credentials');
+  });
+  ```
+  Only listed env vars are exposed to the agent.
+
+## CLI Usage
+
+`npx donobu` mirrors Playwright subcommands and adds Donobu-specific tooling.
+
+| Command                                           | What it does                                                                                          |
+| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `npx donobu test [playwright args]`               | Runs Playwright tests with Donobu fixtures, triage, optional auto-heal, and Page.AI caching controls. |
+| `npx donobu test --auto-heal`                     | After failures, generate treatment plans and automatically retry tests whose plans recommend it.      |
+| `npx donobu test --no-triage`                     | Skip evidence gathering (faster but no treatment plans).                                              |
+| `npx donobu test --triage-output-dir ./artifacts` | Persist evidence outside `test-results/donobu-triage`.                                                |
+| `npx donobu test --clear-ai-cache`                | Clear Page.AI cache before every `act()` invocation for the run.                                      |
+| `npx donobu heal --plan path/to/plan.json`        | Re-run a previously generated treatment plan with matching Playwright args.                           |
+| `npx playwright-json-to-markdown report.json`     | Convert Playwright JSON reports into human-friendly Markdown.                                         |
+| `npx playwright-json-to-slack-json report.json`   | Produce Slack-ready payloads from Playwright reports.                                                 |
+
+### Failure Evidence & Auto-Heal
+
+- During `donobu test`, failure evidence (flow metadata, screenshots, DOM dumps, GPT summaries) is stored under `test-results/donobu-triage/<timestamp>-<runId>/`.
+- `triageTestFailure` builds a structured treatment plan containing failure reason, remediation steps, and automation directives. Plans are written next to the evidence (prefixed with `treatment-plan-`).
+- Passing `--auto-heal` lets Donobu run an autonomous flow that attempts to fix selectors/code. Successful fixes attach regenerated tests (`fixed-test.ts`) and annotate runs with `@self-healed`.
+
+## GPT Configuration
+
+Donobu selects a GPT backend in the following priority order:
+
+1. `BASE64_GPT_CONFIG` - Base64 JSON matching `GptConfigSchema`.
+2. `DONOBU_API_KEY` - use Donobu hosted models.
+3. Anthropic via AWS Bedrock (`AWS_BEDROCK_MODEL_NAME`, `AWS_REGION`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`).
+4. Anthropic direct (`ANTHROPIC_API_KEY`, optional `ANTHROPIC_MODEL_NAME`).
+5. Google Gemini (`GOOGLE_GENERATIVE_AI_API_KEY`, optional `GOOGLE_GENERATIVE_AI_MODEL_NAME`).
+6. OpenAI (`OPENAI_API_KEY`, optional `OPENAI_API_MODEL_NAME`).
+
+Additional runtime env vars:
+
+| Env var                                          | Purpose                                                          |
+| ------------------------------------------------ | ---------------------------------------------------------------- |
+| `DONOBU_PAGE_AI_CLEAR_CACHE`                     | Force cache invalidation for every `page.ai.act`.                |
+| `BASE_WORKING_DIR`                               | Override the platform-specific Donobu data directory.            |
+| `BROWSERBASE_API_KEY` / `BROWSERBASE_PROJECT_ID` | Run flows inside BrowserBase sessions instead of local Chromium. |
+
+## Additional Resources
+
+- Example flows and generated tests: <https://github.com/donobu-inc/playwright-flows>
+- Support: <https://donobu.com>

package/dist/assets/generated/version

@@ -1 +1 @@
-1427
+1428

package/dist/esm/assets/generated/version

@@ -1 +1 @@
-1427
+1428

package/dist/esm/exceptions/PageAiException.d.ts

@@ -4,7 +4,8 @@ import type { FlowMetadata } from '../main';
  * finishes to a state that is not {@link State.SUCCESS}.
  */
 export declare class PageAiException extends Error {
+    readonly originalInstruction: string;
     readonly metadata: FlowMetadata;
-    constructor(metadata: FlowMetadata);
+    constructor(originalInstruction: string, metadata: FlowMetadata);
 }
 //# sourceMappingURL=PageAiException.d.ts.map

package/dist/esm/exceptions/PageAiException.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageAiException.d.ts","sourceRoot":"","sources":["../../../src/exceptions/PageAiException.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aACL,QAAQ,EAAE,YAAY;gBAAtB,QAAQ,EAAE,YAAY;CAG1D"}
+{"version":3,"file":"PageAiException.d.ts","sourceRoot":"","sources":["../../../src/exceptions/PageAiException.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,mBAAmB,EAAE,MAAM;aAC3B,QAAQ,EAAE,YAAY;gBADtB,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,YAAY;CAczC"}

package/dist/esm/exceptions/PageAiException.js

@@ -6,8 +6,16 @@ exports.PageAiException = void 0;
  * finishes to a state that is not {@link State.SUCCESS}.
  */
 class PageAiException extends Error {
-    constructor(metadata) {
-        super(JSON.stringify(metadata.result, null, 2));
+    constructor(originalInstruction, metadata) {
+        const resultDetails = metadata.result
+            ? `Result payload:\n${JSON.stringify(metadata.result, null, 2)}`
+            : 'No result payload was returned.';
+        super([
+            `page.ai flow stopped in state ${metadata.state} (expected SUCCESS).`,
+            `Original instruction: ${originalInstruction}`,
+            resultDetails,
+        ].join('\n'));
+        this.originalInstruction = originalInstruction;
         this.metadata = metadata;
     }
 }

package/dist/esm/exceptions/PageAiException.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageAiException.js","sourceRoot":"","sources":["../../../src/exceptions/PageAiException.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAmC,QAAsB;QACvD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QADf,aAAQ,GAAR,QAAQ,CAAc;IAEzD,CAAC;CACF;AAJD,0CAIC"}
+{"version":3,"file":"PageAiException.js","sourceRoot":"","sources":["../../../src/exceptions/PageAiException.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxC,YACkB,mBAA2B,EAC3B,QAAsB;QAEtC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM;YACnC,CAAC,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YAChE,CAAC,CAAC,iCAAiC,CAAC;QAEtC,KAAK,CACH;YACE,iCAAiC,QAAQ,CAAC,KAAK,sBAAsB;YACrE,yBAAyB,mBAAmB,EAAE;YAC9C,aAAa;SACd,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QAbc,wBAAmB,GAAnB,mBAAmB,CAAQ;QAC3B,aAAQ,GAAR,QAAQ,CAAc;IAaxC,CAAC;CACF;AAjBD,0CAiBC"}

package/dist/esm/lib/DonobuExtendedPage.d.ts

@@ -8,82 +8,78 @@ import type { BrowserStorageState } from '../models/BrowserStorageState';
 import type { FlowMetadata } from '../models/FlowMetadata';
 import type { ToolCallResult } from '../models/ToolCallResult';
 import type { FlowsPersistence } from '../persistence/flows/FlowsPersistence';
-import type { AnalyzePageTextCoreParameters } from '../tools/AnalyzePageTextTool';
-import type { AssertPageTextCoreParameters } from '../tools/AssertPageTextTool';
-import type { AssertCoreSchema } from '../tools/AssertTool';
-import type { ChooseSelectOptionNonGptSchema } from '../tools/ChooseSelectOptionTool';
-import type { InputRandomizedEmailAddressNonGptSchema } from '../tools/InputRandomizedEmailAddressTool';
-import type { InputTextNonGptSchema } from '../tools/InputTextTool';
-import type { PressKeyNonGptSchema } from '../tools/PressKeyTool';
-import type { SelectorBasedSchema } from '../tools/ReplayableInteraction';
-import type { ScrollPageNonGptSchema } from '../tools/ScrollPageTool';
-import type { PageAi, PageAiOptions } from './PageAi';
+import type { CookieAnalyses } from '../tools/CreateBrowserCookieReportTool';
+import type { AccessibilityResults } from '../tools/RunAccessibilityTestTool';
+import type { PageAi, PageAiNoSchemaOptions, PageAiOptions, PageAiSchemaOptions } from './PageAi';
 import type { SmartSelector } from './SmartSelector';
-export type { PageAiOptions };
+export type { PageAiNoSchemaOptions, PageAiOptions, PageAiSchemaOptions };
 /**
  * Extends the Page object with additional test-related methods.
  */
 export interface DonobuExtendedPage extends Page {
-    /**
-     * Launches an autonomous Donobu flow that uses AI to satisfy a natural-language instruction.
-     * The flow may call Donobu tools and mirrors the metadata recorded for the surrounding test run.
-     *
-     * Provide a Zod schema when you want the flow to produce structured output; the AI's response is
-     * validated against the schema and is returned as the result.
-     *
-     * @template T The Zod object schema describing the expected shape of the AI result.
-     * @param instruction High-level description of what the autonomous flow should accomplish.
-     * @returns The parsed schema result when a schema is provided; otherwise, void.
-     * @throws PageAiException if the autonomous flow fails or reaches a terminal non-success state.
-     */
-    ai<Schema extends z.ZodObject | undefined = undefined>(instruction: string, options?: PageAiOptions<Schema>): Promise<Schema extends z.ZodObject ? z.infer<Schema> : void>;
-    /**
-     * Run an arbitrary Donobu tool by name.
-     */
-    run(toolName: string, toolParams?: any, gptClientOverride?: GptClient | LanguageModel): Promise<ToolCallResult>;
-    /**
-     * Run an analysis on the current webpage's full raw text. Note that since this runs an analysis on the raw text,
-     * rather than, the HTML of the page, the raw text may be a bit jumbled, have its styling lost, careful
-     * positioning lost, etc. This tool is useful if there happens to be a lot of text on a page, and it would be
-     * tedious to scroll through the entirety of the page in order to get enough context to run an analysis.
-     *
-     * If there is context relevant to running the analysis that would not be found in the webpage text itself,
-     * perhaps context given in another message, prompt, overall object, etc, then provide it in the
-     * "additionalRelevantContext" parameter.
-     */
-    analyzePageText(params: z.infer<typeof AnalyzePageTextCoreParameters>, gptClientOverride?: GptClient | LanguageModel): Promise<ToolCallResult>;
-    /**
-     * Assert that given text is visible in the current page.
-     */
-    assertPageText(params: z.infer<typeof AssertPageTextCoreParameters>, gptClientOverride?: GptClient | LanguageModel): Promise<ToolCallResult>;
-    /**
-     * Checks all of the pages in the current browser context and returns the one
-     * matching the given URL.
-     */
-    changeTab(url: string): Promise<DonobuExtendedPage>;
-    /**
-     * Choose <option> values for a particular <select> HTML element.
-     */
-    chooseSelectOption(params: z.infer<typeof ChooseSelectOptionNonGptSchema>): Promise<ToolCallResult>;
-    /**
-     * Click an element on a webpage.
-     */
-    clickElement(params: z.infer<typeof SelectorBasedSchema>): Promise<ToolCallResult>;
-    /**
-     * Perform an analysis of the cookies for the current web browsing session.
-     */
-    createCookieReport(gptClientOverride?: GptClient | LanguageModel): Promise<ToolCallResult>;
-    /**
-     * Return an object conforming to the given Zod schema. The object will be
-     * generated considering the following:
-     * - The given instruction (if any).
-     * - A screenshot of the current state of the page.
-     * - The history of actions taken on the page.
-     */
-    extract<T>(params: {
-        instruction?: string;
-        schema: z.ZodSchema<T>;
-    }, gptClientOverride?: GptClient | LanguageModel): Promise<T>;
+    ai: {
+        /**
+         * Launches an autonomous Donobu flow that uses AI to satisfy a natural-language instruction.
+         * The flow may call Donobu tools and mirrors the metadata recorded for the surrounding test run.
+         *
+         * Provide a Zod schema when you want the flow to produce structured output; the AI's response is
+         * validated against the schema and is returned as the result.
+         *
+         * @template Schema The Zod object schema describing the expected shape of the AI result.
+         * @param instruction High-level description of what the autonomous flow should accomplish.
+         * @returns The parsed schema result when a schema is provided; otherwise, void.
+         * @throws PageAiException if the autonomous flow fails or reaches a terminal non-success state.
+         */
+        act<Schema extends z.ZodObject>(instruction: string, options?: Omit<PageAiSchemaOptions<Schema>, 'gptClient'> & {
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<z.infer<Schema>>;
+        act(instruction: string, options?: Omit<PageAiNoSchemaOptions, 'gptClient'> & {
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<void>;
+        /**
+         * Assert that a given condition about the current page holds true (or throws).
+         *  The assertion is evaluated by AI using the context of the current page's...
+         * - Textual context
+         * - Viewport screenshot
+         * - URL
+         * - Title
+         */
+        assertPage(assertion: string, options?: {
+            retries?: number;
+            retryDelaySeconds?: number;
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<void>;
+        /**
+         * Return an object conforming to the given Zod schema. The object will be
+         * generated considering the following:
+         * - The given instruction (if any).
+         * - A screenshot of the current state of the page.
+         * - The history of key actions taken on the page.
+         */
+        extract<Schema extends z.ZodObject>(schema: Schema, options?: {
+            instruction?: string;
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<z.infer<Schema>>;
+        /**
+         * Run an analysis on the current webpage's full raw text. Note that since this runs an analysis
+         * on the raw text, rather than, the HTML of the page, the raw text may be a bit jumbled,
+         * have its styling lost, careful positioning lost, etc.
+         *
+         * If there is context relevant to running the analysis that would not be found in the webpage
+         * text itself, perhaps context given in another message, prompt, overall object, etc, then
+         * provide it in the "additionalContext" parameter.
+         */
+        analyzePageText(analysisToRun: string, options?: {
+            additionalContext?: string;
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<string>;
+        /**
+         * Perform an analysis of the cookies for the current web browsing session.
+         */
+        createCookieReport(options?: {
+            gptClient?: GptClient | Exclude<LanguageModel, string>;
+        }): Promise<CookieAnalyses>;
+    };
     /**
      * Builds a smart selector object that will automatically failover when performing
      * actions.
@@ -93,41 +89,20 @@ export interface DonobuExtendedPage extends Page {
         frame?: string;
     }): SmartSelector;
     /**
-     * Hover the mouse over a specified element on a webpage.
-     */
-    hoverOverElement(params: z.infer<typeof SelectorBasedSchema>): Promise<ToolCallResult>;
-    /**
-     * Create a new randomized email address based on a given email and inputs it to a specific input text field.
-     * For example if passed "foo@gmail.com", this tool will create "foo+SOMETHING_RANDOM@gmail.com", where
-     * SOMETHING_RANDOM is a random string of characters safe for use in an email address, and input it in the
-     * specified text field.
-     */
-    inputRandomizedEmailAddress(params: z.infer<typeof InputRandomizedEmailAddressNonGptSchema>): Promise<ToolCallResult>;
-    /**
-     * Input text to a webpage's text input box.
+     * Run an arbitrary Donobu tool by name.
      */
-    inputText(params: z.infer<typeof InputTextNonGptSchema>): Promise<ToolCallResult>;
+    run(toolName: string, toolParams?: any, options?: {
+        gptClient?: GptClient | Exclude<LanguageModel, string>;
+    }): Promise<ToolCallResult>;
     /**
-     * Press a single key. Note that if there is existing text in the element, it is appended rather than cleared.
-     *
-     * Generally, prefer using the 'inputText' tool instead as it automatically clears existing text
-     * and it allows the input of multiple characters at a time. The only advantage this tool has is
-     * that it allows the passing of control keys like "Tab", "Backspace", etc.
+     * Checks all of the pages in the current browser context and returns the one
+     * matching the given URL.
      */
-    pressKey(params: z.infer<typeof PressKeyNonGptSchema>): Promise<ToolCallResult>;
+    changeTab(url: string): Promise<DonobuExtendedPage>;
     /**
      * Run an web accessibility (i.e. axe-core) test on the current webpage.
      */
-    runAccessibilityTest(): Promise<ToolCallResult>;
-    /**
-     * Scroll the given element.
-     */
-    scroll(params: z.infer<typeof ScrollPageNonGptSchema>): Promise<ToolCallResult>;
-    /**
-     * Visually assert that a given condition (i.e. the 'assertionToTestFor' field) holds true, using a screenshot of
-     * the current webpage.
-     */
-    visuallyAssert(params: z.infer<typeof AssertCoreSchema>, gptClientOverride?: GptClient | LanguageModel): Promise<ToolCallResult>;
+    runAccessibilityTest(): Promise<AccessibilityResults>;
     _dnb: {
         donobuFlowMetadata: FlowMetadata;
         donobuStack: DonobuStack;

package/dist/esm/lib/DonobuExtendedPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DonobuExtendedPage.d.ts","sourceRoot":"","sources":["../../../src/lib/DonobuExtendedPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,0CAA0C,CAAC;AACxG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI;IAC9C;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,EACnD,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE;;OAEG;IACH,GAAG,CACD,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,GAAG,EAChB,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;;;;OASG;IACH,eAAe,CACb,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,EACrD,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;OAEG;IACH,cAAc,CACZ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,EACpD,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD;;OAEG;IACH,kBAAkB,CAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACrD,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;OAEG;IACH,kBAAkB,CAChB,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EACP,MAAM,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;KACxB,EACD,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,CAAC,CAAC,CAAC;IACd;;;OAGG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,aAAa,CAAC;IACjB;;OAEG;IACH,gBAAgB,CACd,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;OAKG;IACH,2BAA2B,CACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uCAAuC,CAAC,GAC9D,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;OAEG;IACH,SAAS,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CACN,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;OAEG;IACH,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD;;OAEG;IACH,MAAM,CACJ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC7C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B;;;OAGG;IACH,cAAc,CACZ,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,EACxC,iBAAiB,CAAC,EAAE,SAAS,GAAG,aAAa,GAC5C,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B,IAAI,EAAE;QACJ,kBAAkB,EAAE,YAAY,CAAC;QACjC,WAAW,EAAE,WAAW,CAAC;QACzB,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,WAAW,EAAE,gBAAgB,CAAC;QAC9B,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;QACjC,iBAAiB,CAAC,EAAE;YAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;SAC5B,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"DonobuExtendedPage.d.ts","sourceRoot":"","sources":["../../../src/lib/DonobuExtendedPage.ts"],"names":[],"mappings":"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"}

package/dist/esm/lib/PageAi.d.ts

@@ -17,11 +17,11 @@ import type { PageAiCache } from './pageAi/cache';
  * - {@link PageAiRunner} sets up the `DonobuFlow` and keeps the persistence
  *   layer in sync. It knows nothing about caches.
  * - {@link PageAi} glues together the runner with a pluggable cache so that
- *   consumers (e.g., Playwright fixtures) keep their simple `page.ai(...)`
+ *   consumers (e.g., Playwright fixtures) keep their simple `page.ai.act(...)`
  *   API while gaining better separation of concerns.
  *
  * The documentation in this file attempts to guide new contributors through
- * the lifecycle of a single `page.ai` call: resolve cache → run flow →
+ * the lifecycle of a single `page.ai.act(...)` call: resolve cache → run flow →
  * persist metadata → update cache.
  */
 type PageAiBaseOptions = {
@@ -29,11 +29,12 @@ type PageAiBaseOptions = {
     allowedTools?: string[];
     maxToolCalls?: number;
     envVars?: string[];
+    gptClient?: GptClient;
 };
-type PageAiSchemaOptions<Schema extends z.ZodObject> = PageAiBaseOptions & {
+export type PageAiSchemaOptions<Schema extends z.ZodObject> = PageAiBaseOptions & {
     schema: Schema;
 };
-type PageAiNoSchemaOptions = PageAiBaseOptions & {
+export type PageAiNoSchemaOptions = PageAiBaseOptions & {
     schema?: undefined;
 };
 export type PageAiOptions<Schema extends z.ZodObject | undefined = undefined> = Schema extends z.ZodObject ? PageAiSchemaOptions<Schema> : PageAiNoSchemaOptions;
@@ -48,6 +49,7 @@ type PageAiRunConfiguration<Schema extends z.ZodObject | undefined> = {
     envVarNames: string[];
     cachedToolCalls: ProposedToolCall[] | null;
     runMode: FlowMetadata['runMode'];
+    gptClient: GptClient | undefined;
 };
 type PageAiRunResult<Schema extends z.ZodObject | undefined> = {
     donobuFlow: DonobuFlow;
@@ -107,9 +109,11 @@ export declare class PageAi {
     static withFileCache(donobu: DonobuStack, gptClient: GptClient, cacheFilepath: string): PageAi;
     static withInMemoryCache(donobu: DonobuStack, gptClient: GptClient): PageAi;
     /**
-     * Public entry point invoked by `page.ai`. Handles cache lookup, delegates to
+     * Public entry point invoked by `page.ai.act`. Handles cache lookup, delegates to
      * the runner, and stores the result back into the cache when appropriate.
      */
+    ai<Schema extends z.ZodObject>(page: DonobuExtendedPage, instruction: string, options: PageAiSchemaOptions<Schema>): Promise<z.infer<Schema>>;
+    ai(page: DonobuExtendedPage, instruction: string, options?: PageAiNoSchemaOptions): Promise<void>;
     ai<Schema extends z.ZodObject | undefined = undefined>(page: DonobuExtendedPage, instruction: string, options?: PageAiOptions<Schema>): Promise<AiResult<Schema>>;
     /**
      * Invalidates cache entries matching the provided invocation parameters.
@@ -127,7 +131,7 @@ export declare class PageAi {
      */
     private buildDescriptor;
     /**
-     * Computes the cache key that uniquely identifies a `page.ai` invocation.
+     * Computes the cache key that uniquely identifies a `page.ai.act(...)` invocation.
      * Keep this logic in sync with any external cache generators (e.g. the code
      * generator) so that hits and invalidations behave the same everywhere.
      */

package/dist/esm/lib/PageAi.d.ts.map

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