@cogitator-ai/browser 0.1.6 → 0.2.0

package/README.md

@@ -1,11 +1,11 @@
 # @cogitator-ai/browser
 
-Browser automation tools for Cogitator AI agents. Playwright-based with 32 tools across 5 modules, vision mode, stealth system, structured data extraction, and network control.
+Browser automation tools for Cogitator AI agents. Playwright-based with 33 tools across 5 modules, vision mode, stealth system, structured data extraction, and network control.
 
 ## Features
 
-- **32 Browser Tools** across 5 modules (navigation, interaction, extraction, vision, network)
-- **BrowserSession** -- managed browser lifecycle with tabs, cookies, proxy
+- **33 Browser Tools** across 5 modules (navigation, interaction, extraction, vision, network)
+- **BrowserSession** -- managed browser lifecycle with tabs (including popups), cookies, proxy, persistent profiles, and a tab limit
 - **Stealth Mode** -- fingerprint evasion, human-like typing/mouse, UA rotation
 - **Vision Mode** -- screenshot + accessibility tree for vision LLM navigation
 - **Smart Extraction** -- tables, structured data, links, clean text
@@ -62,7 +62,7 @@ await session.close();
 | Tool                    | Description                                                                       |
 | ----------------------- | --------------------------------------------------------------------------------- |
 | `browser_click`         | Click an element by CSS selector. Supports button, clickCount, position           |
-| `browser_type`          | Type text into an input. Stealth mode adds human-like keystroke delays            |
+| `browser_type`          | Type text into an input. Stealth mode replaces the value with human-like keys     |
 | `browser_select_option` | Select from a `<select>` element by value, label, or index                        |
 | `browser_hover`         | Hover over an element                                                             |
 | `browser_scroll`        | Scroll the page or a specific element in any direction                            |
@@ -75,32 +75,33 @@ await session.close();
 
 | Tool                         | Description                                                        |
 | ---------------------------- | ------------------------------------------------------------------ |
-| `browser_get_text`           | Extract text from the page or a specific element                   |
+| `browser_get_text`           | Extract rendered text from the page or the first matching element  |
 | `browser_get_html`           | Get inner or outer HTML of the page or an element                  |
 | `browser_get_attribute`      | Get the value of a DOM attribute                                   |
 | `browser_get_links`          | Extract all links with text, href, and title                       |
 | `browser_query_selector_all` | Query all matching elements with tag, text, attributes, visibility |
-| `browser_extract_table`      | Extract structured data from HTML tables (headers + rows)          |
-| `browser_extract_structured` | Extract clean readable text, stripping scripts/styles/SVG          |
+| `browser_extract_table`      | Extract headers + rows from a table (or the first table inside)    |
+| `browser_extract_structured` | Extract rendered text, without scripts/styles/hidden elements      |
 
 ### Vision (4 tools)
 
 | Tool                           | Description                                                                             |
 | ------------------------------ | --------------------------------------------------------------------------------------- |
-| `browser_screenshot`           | Screenshot the page or element. Returns base64 PNG/JPEG                                 |
+| `browser_screenshot`           | Screenshot the page or element. Returns base64 PNG/JPEG with `mimeType` and dimensions  |
 | `browser_screenshot_element`   | Screenshot a specific element with bounding box coordinates                             |
 | `browser_find_by_description`  | Find elements by natural language using the accessibility tree                          |
 | `browser_click_by_description` | Click an element by natural language description (tries role, text, label, placeholder) |
 
-### Network (5 tools)
+### Network (6 tools)
 
-| Tool                        | Description                                                          |
-| --------------------------- | -------------------------------------------------------------------- |
-| `browser_intercept_request` | Intercept HTTP requests -- block, modify, or continue by URL pattern |
-| `browser_wait_for_response` | Wait for an HTTP response matching a URL pattern                     |
-| `browser_block_resources`   | Block resource types (image, stylesheet, font, media, script)        |
-| `browser_capture_har`       | Start/stop HAR traffic capture. Returns all captured entries on stop |
-| `browser_get_api_calls`     | Get captured XHR/fetch calls, filtered by URL pattern or method      |
+| Tool                         | Description                                                                           |
+| ---------------------------- | ------------------------------------------------------------------------------------- |
+| `browser_intercept_request`  | Block, modify, or continue requests matching a glob or `/regex/flags` in all tabs     |
+| `browser_remove_interceptor` | Remove one interceptor by ID, or all of them                                          |
+| `browser_wait_for_response`  | Wait for a response whose URL contains a substring or matches `/regex/flags`          |
+| `browser_block_resources`    | Block resource types (image, stylesheet, font, media, script) in all tabs             |
+| `browser_capture_har`        | Start/stop traffic capture of all tabs; on stop returns entries and can write HAR 1.2 |
+| `browser_get_api_calls`      | XHR/fetch calls recorded since session start, filtered by URL or method; `clear`      |
 
 ## Stealth Mode
 
@@ -123,18 +124,21 @@ const session = new BrowserSession({
 });
 ```
 
+Options you omit fall back to the defaults above (all `true`), so `stealth: { humanLikeMouse: false }` keeps every other feature enabled.
+
 What stealth mode does:
 
-- Sets `navigator.webdriver` to `false`
+- Sets `navigator.webdriver` to `false` (patched on `Navigator.prototype`, not as an own property)
 - Spoofs `navigator.plugins` with realistic Chrome plugins
-- Sets `navigator.languages` to `['en-US', 'en']`
+- Sets `navigator.languages` from `locale` (e.g. `de-DE` -> `['de-DE', 'de']`, default `['en-US', 'en']`)
+- Aligns `navigator.platform` and `navigator.userAgentData.platform` with the user agent in use
 - Randomizes canvas fingerprint (1-bit pixel noise)
 - Spoofs WebGL vendor/renderer (Intel Iris)
 - Injects `window.chrome` runtime stubs
 - Overrides `Permissions.query` for notifications
-- Rotates User-Agent strings per browser type
+- Rotates desktop User-Agent strings per browser type
 - Adds human-like typing delays (50-150ms per character)
-- Uses bezier curve mouse movement for clicks
+- Moves the mouse along bezier curves for `browser_click`, `browser_click_by_description`, `browser_hover`, and wheels in small steps for `browser_scroll`
 
 ## Vision Mode
 
@@ -166,21 +170,25 @@ await session.start();
 
 const tools = [...createNavigationTools(session), ...createNetworkTools(session)];
 
-// Agent can intercept requests:
+// Agent can intercept requests (glob or /regex/flags), in every tab:
 // browser_intercept_request({ urlPattern: "**/ads/**", action: "block" })
+// browser_intercept_request({ urlPattern: "/\\.(png|jpe?g)$/i", action: "block" })
+// browser_remove_interceptor({ interceptorId: "interceptor_1" })
 
 // Block resource types to speed up loading:
 // browser_block_resources({ types: ["image", "font", "stylesheet"] })
 
-// Monitor API calls made by the page:
-// browser_get_api_calls({ urlPattern: "/api/", method: "POST" })
+// Monitor API calls made by the page since the session started:
+// browser_get_api_calls({ urlPattern: "/api/", method: "POST", clear: true })
 
-// Capture HAR traffic:
+// Capture traffic and save a HAR 1.2 file (path must be inside the working directory):
 // browser_capture_har({ action: "start" })
 // ... navigate and interact ...
 // browser_capture_har({ action: "stop", path: "./traffic.har" })
 ```
 
+Interceptors are registered on the browser context, so they also apply to tabs opened later. `continue` and `modify` hand the request to the next matching interceptor (`route.fallback`), so blocking rules keep working when several interceptors overlap. `modify.headers` are merged into the original request headers. API call history keeps the latest 1000 calls; HAR capture keeps up to 5000 entries and stores bodies only for textual responses up to 1 MB.
+
 ## BrowserSession API
 
 ### Constructor
@@ -202,9 +210,11 @@ interface BrowserSessionConfig {
   locale?: string; // browser locale (e.g., 'en-US')
   timezone?: string; // timezone ID (e.g., 'America/New_York')
   geolocation?: { latitude: number; longitude: number };
-  cookies?: BrowserCookie[]; // pre-load cookies
+  persistentContext?: string; // user data dir; profile (cookies, storage) survives restarts
+  cookies?: BrowserCookie[]; // pre-load cookies (domain cookies default to path '/')
   timeout?: number; // navigation timeout, default: 30000ms
   actionTimeout?: number; // action timeout, default: 10000ms
+  pool?: { maxPages: number }; // maximum number of open tabs for newTab()
 }
 ```
 
@@ -212,14 +222,23 @@ interface BrowserSessionConfig {
 
 ```typescript
 await session.start(); // launch browser, create context and first page
+await session.ensureStarted(); // start once; concurrent callers share one launch
 await session.close(); // close browser and cleanup
+
+const unsubscribe = session.onStart((context) => {
+  // runs after every successful start (immediately if already started)
+});
 ```
 
+If the browser or context closes unexpectedly, the session resets itself and the next `ensureStarted()` (called by every tool from `browserTools`) relaunches it. A failed start closes anything it launched.
+
 ### Properties
 
 ```typescript
 session.page; // active Playwright Page
-session.tabs; // all open Page[]
+session.tabs; // all open Page[] (includes popups and target=_blank pages)
+session.activeTabIndex; // index of the active tab
+session.started; // whether a context is running
 session.browser; // Playwright Browser instance
 session.context; // Playwright BrowserContext
 session.config; // current config
@@ -230,7 +249,7 @@ session.stealthConfig; // resolved StealthConfig or null
 ### Tab Management
 
 ```typescript
-const page = await session.newTab('https://example.com'); // open new tab
+const page = await session.newTab('https://example.com'); // open new tab (respects pool.maxPages)
 session.switchTab(1); // switch to tab by index
 await session.closeTab(0); // close tab by index
 ```
@@ -249,7 +268,7 @@ await session.loadCookies('./cookies.json');
 Load only the tool modules you need:
 
 ```typescript
-// all 32 tools
+// all 33 tools
 const tools = browserTools(session);
 
 // only navigation + extraction (14 tools)
@@ -292,7 +311,7 @@ const locator = await smartSelect(page, 'Submit');
 // findFormField tries name, placeholder, aria-label, label text
 const input = await findFormField(page, 'Email');
 
-// getReadableText strips scripts/styles and returns clean text
+// getReadableText returns rendered text (no scripts, styles, or hidden elements)
 const text = await getReadableText(page);
 
 // getAccessibilityTree returns simplified a11y tree
@@ -307,6 +326,7 @@ Use stealth primitives directly outside of BrowserSession:
 import {
   humanLikeType,
   humanLikeClick,
+  humanLikeHover,
   humanLikeScroll,
   getRandomUserAgent,
   getAllUserAgents,
@@ -317,11 +337,17 @@ import {
 
 // human-like input on any Playwright page
 await humanLikeType(page, '#search', 'cogitator ai');
-await humanLikeClick(page, '.submit-btn');
-await humanLikeScroll(page, 'down', 500);
+await humanLikeClick(page, '.submit-btn'); // selector or Locator
+await humanLikeClick(page, page.getByRole('button', { name: 'Buy' }), { clickCount: 2 });
+await humanLikeHover(page, '#menu');
+await humanLikeScroll(page, 'down', 500); // up | down | left | right
 
-// get a random UA for a browser type
+// get a random desktop UA for a browser type
 const ua = getRandomUserAgent('chromium');
+
+// evasion scripts consistent with that user agent and locale
+const scripts = getEvasionScripts({ userAgent: ua, locale: 'de-DE' });
+await applyStealthToContext(context, { blockWebDriver: true }, { userAgent: ua, locale: 'de-DE' });
 ```
 
 ## License

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { BrowserSession } from './session.js';
+export type { BrowserStartListener } from './session.js';
 export { browserTools } from './tools/index.js';
-export { createNavigationTools, createNavigateTool, createGoBackTool, createGoForwardTool, createReloadTool, createWaitForNavigationTool, createGetCurrentUrlTool, createWaitForSelectorTool, createInteractionTools, createClickTool, createTypeTool, createSelectOptionTool, createHoverTool, createScrollTool, createPressKeyTool, createDragAndDropTool, createFillFormTool, createUploadFileTool, createExtractionTools, createGetTextTool, createGetHtmlTool, createGetAttributeTool, createGetLinksTool, createQuerySelectorAllTool, createExtractTableTool, createExtractStructuredTool, createVisionTools, createScreenshotTool, createScreenshotElementTool, createFindByDescriptionTool, createClickByDescriptionTool, createNetworkTools, createInterceptRequestTool, createWaitForResponseTool, createBlockResourcesTool, createCaptureHarTool, createGetApiCallsTool, } from './tools/index.js';
-export { navigateSchema, goBackSchema, goForwardSchema, reloadSchema, waitForNavigationSchema, getCurrentUrlSchema, waitForSelectorSchema, clickSchema, typeSchema, selectOptionSchema, hoverSchema, scrollSchema, pressKeySchema, dragAndDropSchema, fillFormSchema, uploadFileSchema, getTextSchema, getHtmlSchema, getAttributeSchema, getLinksSchema, querySelectorAllSchema, extractTableSchema, extractStructuredSchema, screenshotSchema, screenshotElementSchema, findByDescriptionSchema, clickByDescriptionSchema, interceptRequestSchema, waitForResponseSchema, blockResourcesSchema, captureHarSchema, getApiCallsSchema, } from './utils/schemas.js';
-export type { NavigateInput, GoBackInput, GoForwardInput, ReloadInput, WaitForNavigationInput, GetCurrentUrlInput, WaitForSelectorInput, ClickInput, TypeInput, SelectOptionInput, HoverInput, ScrollInput, PressKeyInput, DragAndDropInput, FillFormInput, UploadFileInput, GetTextInput, GetHtmlInput, GetAttributeInput, GetLinksInput, QuerySelectorAllInput, ExtractTableInput, ExtractStructuredInput, ScreenshotInput, ScreenshotElementInput, FindByDescriptionInput, ClickByDescriptionInput, InterceptRequestInput, WaitForResponseInput, BlockResourcesInput, CaptureHarInput, GetApiCallsInput, } from './utils/schemas.js';
-export { applyStealthToContext, getStealthLaunchOptions, getEvasionScripts, humanLikeType, humanLikeClick, humanLikeScroll, getRandomUserAgent, getAllUserAgents, } from './stealth/index.js';
-export type { EvasionScriptsOptions, HumanLikeClickOptions } from './stealth/index.js';
+export { createNavigationTools, createNavigateTool, createGoBackTool, createGoForwardTool, createReloadTool, createWaitForNavigationTool, createGetCurrentUrlTool, createWaitForSelectorTool, createInteractionTools, createClickTool, createTypeTool, createSelectOptionTool, createHoverTool, createScrollTool, createPressKeyTool, createDragAndDropTool, createFillFormTool, createUploadFileTool, createExtractionTools, createGetTextTool, createGetHtmlTool, createGetAttributeTool, createGetLinksTool, createQuerySelectorAllTool, createExtractTableTool, createExtractStructuredTool, createVisionTools, createScreenshotTool, createScreenshotElementTool, createFindByDescriptionTool, createClickByDescriptionTool, createNetworkTools, createInterceptRequestTool, createRemoveInterceptorTool, createWaitForResponseTool, createBlockResourcesTool, createCaptureHarTool, createGetApiCallsTool, } from './tools/index.js';
+export { navigateSchema, goBackSchema, goForwardSchema, reloadSchema, waitForNavigationSchema, getCurrentUrlSchema, waitForSelectorSchema, clickSchema, typeSchema, selectOptionSchema, hoverSchema, scrollSchema, pressKeySchema, dragAndDropSchema, fillFormSchema, uploadFileSchema, getTextSchema, getHtmlSchema, getAttributeSchema, getLinksSchema, querySelectorAllSchema, extractTableSchema, extractStructuredSchema, screenshotSchema, screenshotElementSchema, findByDescriptionSchema, clickByDescriptionSchema, interceptRequestSchema, removeInterceptorSchema, waitForResponseSchema, blockResourcesSchema, captureHarSchema, getApiCallsSchema, } from './utils/schemas.js';
+export type { NavigateInput, GoBackInput, GoForwardInput, ReloadInput, WaitForNavigationInput, GetCurrentUrlInput, WaitForSelectorInput, ClickInput, TypeInput, SelectOptionInput, HoverInput, ScrollInput, PressKeyInput, DragAndDropInput, FillFormInput, UploadFileInput, GetTextInput, GetHtmlInput, GetAttributeInput, GetLinksInput, QuerySelectorAllInput, ExtractTableInput, ExtractStructuredInput, ScreenshotInput, ScreenshotElementInput, FindByDescriptionInput, ClickByDescriptionInput, InterceptRequestInput, RemoveInterceptorInput, WaitForResponseInput, BlockResourcesInput, CaptureHarInput, GetApiCallsInput, } from './utils/schemas.js';
+export { applyStealthToContext, getStealthLaunchOptions, getEvasionScripts, humanLikeType, humanLikeClick, humanLikeHover, humanLikeScroll, getRandomUserAgent, getAllUserAgents, } from './stealth/index.js';
+export type { EvasionScriptsOptions, HumanLikeClickOptions, HumanLikeHoverOptions, StealthContextOptions, } from './stealth/index.js';
 export { smartSelect, findFormField } from './utils/selectors.js';
 export { getReadableText, getAccessibilityTree, elementToInfo } from './utils/page-helpers.js';
 export type { AccessibilityNode } from './utils/page-helpers.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,8 +1,8 @@
 export { BrowserSession } from './session.js';
 export { browserTools } from './tools/index.js';
-export { createNavigationTools, createNavigateTool, createGoBackTool, createGoForwardTool, createReloadTool, createWaitForNavigationTool, createGetCurrentUrlTool, createWaitForSelectorTool, createInteractionTools, createClickTool, createTypeTool, createSelectOptionTool, createHoverTool, createScrollTool, createPressKeyTool, createDragAndDropTool, createFillFormTool, createUploadFileTool, createExtractionTools, createGetTextTool, createGetHtmlTool, createGetAttributeTool, createGetLinksTool, createQuerySelectorAllTool, createExtractTableTool, createExtractStructuredTool, createVisionTools, createScreenshotTool, createScreenshotElementTool, createFindByDescriptionTool, createClickByDescriptionTool, createNetworkTools, createInterceptRequestTool, createWaitForResponseTool, createBlockResourcesTool, createCaptureHarTool, createGetApiCallsTool, } from './tools/index.js';
-export { navigateSchema, goBackSchema, goForwardSchema, reloadSchema, waitForNavigationSchema, getCurrentUrlSchema, waitForSelectorSchema, clickSchema, typeSchema, selectOptionSchema, hoverSchema, scrollSchema, pressKeySchema, dragAndDropSchema, fillFormSchema, uploadFileSchema, getTextSchema, getHtmlSchema, getAttributeSchema, getLinksSchema, querySelectorAllSchema, extractTableSchema, extractStructuredSchema, screenshotSchema, screenshotElementSchema, findByDescriptionSchema, clickByDescriptionSchema, interceptRequestSchema, waitForResponseSchema, blockResourcesSchema, captureHarSchema, getApiCallsSchema, } from './utils/schemas.js';
-export { applyStealthToContext, getStealthLaunchOptions, getEvasionScripts, humanLikeType, humanLikeClick, humanLikeScroll, getRandomUserAgent, getAllUserAgents, } from './stealth/index.js';
+export { createNavigationTools, createNavigateTool, createGoBackTool, createGoForwardTool, createReloadTool, createWaitForNavigationTool, createGetCurrentUrlTool, createWaitForSelectorTool, createInteractionTools, createClickTool, createTypeTool, createSelectOptionTool, createHoverTool, createScrollTool, createPressKeyTool, createDragAndDropTool, createFillFormTool, createUploadFileTool, createExtractionTools, createGetTextTool, createGetHtmlTool, createGetAttributeTool, createGetLinksTool, createQuerySelectorAllTool, createExtractTableTool, createExtractStructuredTool, createVisionTools, createScreenshotTool, createScreenshotElementTool, createFindByDescriptionTool, createClickByDescriptionTool, createNetworkTools, createInterceptRequestTool, createRemoveInterceptorTool, createWaitForResponseTool, createBlockResourcesTool, createCaptureHarTool, createGetApiCallsTool, } from './tools/index.js';
+export { navigateSchema, goBackSchema, goForwardSchema, reloadSchema, waitForNavigationSchema, getCurrentUrlSchema, waitForSelectorSchema, clickSchema, typeSchema, selectOptionSchema, hoverSchema, scrollSchema, pressKeySchema, dragAndDropSchema, fillFormSchema, uploadFileSchema, getTextSchema, getHtmlSchema, getAttributeSchema, getLinksSchema, querySelectorAllSchema, extractTableSchema, extractStructuredSchema, screenshotSchema, screenshotElementSchema, findByDescriptionSchema, clickByDescriptionSchema, interceptRequestSchema, removeInterceptorSchema, waitForResponseSchema, blockResourcesSchema, captureHarSchema, getApiCallsSchema, } from './utils/schemas.js';
+export { applyStealthToContext, getStealthLaunchOptions, getEvasionScripts, humanLikeType, humanLikeClick, humanLikeHover, humanLikeScroll, getRandomUserAgent, getAllUserAgents, } from './stealth/index.js';
 export { smartSelect, findFormField } from './utils/selectors.js';
 export { getReadableText, getAccessibilityTree, elementToInfo } from './utils/page-helpers.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAqCzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAsCzB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AASnB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/session.d.ts

@@ -5,21 +5,27 @@ declare global {
         readonly asyncDispose: unique symbol;
     }
 }
+export type BrowserStartListener = (context: BrowserContext) => void;
 export declare class BrowserSession {
     private _config;
     private _browser;
     private _context;
     private _pages;
     private _activePageIndex;
+    private _starting;
+    private _startListeners;
     constructor(config?: BrowserSessionConfig);
     get config(): BrowserSessionConfig;
+    get started(): boolean;
     get stealthEnabled(): boolean;
     get stealthConfig(): StealthConfig | null;
     ensureStarted(): Promise<void>;
     get page(): Page;
     get tabs(): Page[];
+    get activeTabIndex(): number;
     get browser(): Browser | null;
     get context(): BrowserContext | null;
+    onStart(listener: BrowserStartListener): () => void;
     start(): Promise<void>;
     newTab(url?: string): Promise<Page>;
     switchTab(index: number): void;
@@ -30,6 +36,11 @@ export declare class BrowserSession {
     loadCookies(filePath: string): Promise<void>;
     close(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
+    private _launch;
+    private _reset;
+    private _trackPage;
+    private _untrackPage;
+    private _assertTabIndex;
     private _pruneClosedPages;
     private _resolveProxy;
 }

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EAEb,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,iBAAiB;QACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,MAAM,CAAC;KACtC;CACF;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAGQ;IACvB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,CAAC,EAAE,oBAAoB;IAWzC,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAIxC;IAEK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,IAAI,IAAI,IAAI,IAAI,CAYf;IAED,IAAI,IAAI,IAAI,IAAI,EAAE,CAGjB;IAED,IAAI,OAAO,IAAI,OAAO,GAAG,IAAI,CAE5B;IAED,IAAI,OAAO,IAAI,cAAc,GAAG,IAAI,CAEnC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDtB,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAOtC,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;CAUtB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EAGd,IAAI,EACL,MAAM,YAAY,CAAC;AAGpB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,iBAAiB;QACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,MAAM,CAAC;KACtC;CACF;AAgBD,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAerE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAGQ;IACvB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,eAAe,CAAmC;gBAE9C,MAAM,CAAC,EAAE,oBAAoB;IAezC,IAAI,MAAM,IAAI,oBAAoB,CAEjC;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAIxC;IAEK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IASpC,IAAI,IAAI,IAAI,IAAI,CAMf;IAED,IAAI,IAAI,IAAI,IAAI,EAAE,CAGjB;IAED,IAAI,cAAc,IAAI,MAAM,CAG3B;IAED,IAAI,OAAO,IAAI,OAAO,GAAG,IAAI,CAE5B;IAED,IAAI,OAAO,IAAI,cAAc,GAAG,IAAI,CAEnC;IAED,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAQ7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevC,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAOtC,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBtB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;YAI9B,OAAO;IAkFrB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,aAAa;CAUtB"}