Skip to content

Latest commit

 

History

History
288 lines (177 loc) · 41.7 KB

File metadata and controls

288 lines (177 loc) · 41.7 KB

@mastra/agent-browser

0.4.0

Minor Changes

Patch Changes

0.4.0-alpha.0

Minor Changes

Patch Changes

0.3.4

Patch Changes

0.3.4-alpha.0

Patch Changes

  • Security remediation for the 2026-06-17 "easy-day-js" supply-chain incident. Patch bump to publish clean versions and move the latest dist-tag forward, superseding the compromised versions that declared the malicious easy-day-js dependency. (#18056)

  • Updated dependencies [77a2351]:

    • @mastra/core@1.43.1-alpha.0

0.3.2

Patch Changes

0.3.1

Patch Changes

0.3.1-alpha.0

Patch Changes

  • Fixed browser state reporting to identify when the agent or user closed the browser or changed the active URL. (#17631)

  • Updated dependencies [2bccba4, 2bccba4, f2ab060, 5d302c8]:

    • @mastra/core@1.42.0-alpha.1

0.3.0

Minor Changes

  • Add waitUntil support to browser_click, browser_press, and browser_select. When provided, the tool waits for the page to reach the given load state (load, domcontentloaded, or networkidle) after the action completes, preventing the next browser_snapshot from capturing stale DOM when the interaction triggers navigation. The parameter is optional and behaviour is unchanged when omitted. (#17426)

    Usage example:

    await browser_click({ ref: '@e1', waitUntil: 'domcontentloaded', timeout: 5000 });

    Fixes #17397.

  • Added extensibility hooks for custom browser providers (e.g. Firecrawl Browser Sandbox). (#15724)

    • New createThreadManager config option to inject a custom thread manager factory
    • Exported AgentBrowserThreadManager class and related types (AgentBrowserSession, AgentBrowserThreadManagerConfig, CreateAgentBrowserThreadManager)
    • Changed several internal members from private to protected to support subclassing

Patch Changes

0.3.0-alpha.1

Minor Changes

  • Add waitUntil support to browser_click, browser_press, and browser_select. When provided, the tool waits for the page to reach the given load state (load, domcontentloaded, or networkidle) after the action completes, preventing the next browser_snapshot from capturing stale DOM when the interaction triggers navigation. The parameter is optional and behaviour is unchanged when omitted. (#17426)

    Usage example:

    await browser_click({ ref: '@e1', waitUntil: 'domcontentloaded', timeout: 5000 });

    Fixes #17397.

Patch Changes

0.3.0-alpha.0

Minor Changes

  • Added extensibility hooks for custom browser providers (e.g. Firecrawl Browser Sandbox). (#15724)
    • New createThreadManager config option to inject a custom thread manager factory
    • Exported AgentBrowserThreadManager class and related types (AgentBrowserSession, AgentBrowserThreadManagerConfig, CreateAgentBrowserThreadManager)
    • Changed several internal members from private to protected to support subclassing

Patch Changes

0.2.2

Patch Changes

0.2.2-alpha.0

Patch Changes

  • Added screenshot tool to @mastra/stagehand (stagehand_screenshot) and @mastra/agent-browser (browser_screenshot). Captures a PNG screenshot and returns image content for vision-capable models. (#16074)

    Added excludeTools config option to opt out of specific tools:

    const browser = new StagehandBrowser({
      excludeTools: ['stagehand_screenshot'],
    });
  • Updated dependencies [b59316f, 55f1e2d, d48a705]:

    • @mastra/core@1.33.0-alpha.12

0.2.1

Patch Changes

  • Standardize headless default to true across all browser providers. Each provider now resolves headless once in its constructor and passes it to the thread manager via the base class getter, removing duplicate fallback logic. (#15696)

  • Fixed browser_evaluate so expression scripts now return their computed value instead of undefined (for example, document.querySelectorAll('a').length). (#15689)

  • Updated dependencies [733bf53, 5405b3b, 45e29cb, 750b4d3, c321127, a07bcef, 696694e, b084a80, 82b7a96, df97812, 8bbe360, f6b8ba8, a07bcef]:

    • @mastra/core@1.28.0

0.2.1-alpha.1

Patch Changes

  • Standardize headless default to true across all browser providers. Each provider now resolves headless once in its constructor and passes it to the thread manager via the base class getter, removing duplicate fallback logic. (#15696)

  • Updated dependencies [750b4d3]:

    • @mastra/core@1.28.0-alpha.1

0.2.1-alpha.0

Patch Changes

0.2.0

Minor Changes

  • Added storageState option and exportStorageState() method for lightweight auth persistence (cookies and localStorage). Also kills orphaned Chrome child processes on close to prevent zombies. (#15194)

Patch Changes

0.2.0-alpha.0

Minor Changes

  • Added storageState option and exportStorageState() method for lightweight auth persistence (cookies and localStorage). Also kills orphaned Chrome child processes on close to prevent zombies. (#15194)

Patch Changes

0.1.0

Minor Changes

  • Add browser automation support with screencast streaming, input injection, and thread isolation (#14938)

    New Features:

    • Browser tools for web automation (navigate, click, type, scroll, extract, etc.)
    • Real-time screencast streaming via WebSocket
    • Mouse and keyboard input injection
    • Thread-scoped browser isolation (scope: 'thread')
    • State persistence and restoration across sessions
    • Support for cloud providers (Browserbase, Browser-Use, Browserless)

    Configuration:

    import { AgentBrowser } from '@mastra/agent-browser';
    
    const browser = new AgentBrowser({
      headless: true,
      scope: 'thread', // Each thread gets isolated browser
      viewport: { width: 1280, height: 720 },
    });
    
    const agent = mastra.getAgent('my-agent', { browser });

Patch Changes

0.1.0-alpha.0

Minor Changes

  • Add browser automation support with screencast streaming, input injection, and thread isolation (#14938)

    New Features:

    • Browser tools for web automation (navigate, click, type, scroll, extract, etc.)
    • Real-time screencast streaming via WebSocket
    • Mouse and keyboard input injection
    • Thread-scoped browser isolation (scope: 'thread')
    • State persistence and restoration across sessions
    • Support for cloud providers (Browserbase, Browser-Use, Browserless)

    Configuration:

    import { AgentBrowser } from '@mastra/agent-browser';
    
    const browser = new AgentBrowser({
      headless: true,
      scope: 'thread', // Each thread gets isolated browser
      viewport: { width: 1280, height: 720 },
    });
    
    const agent = mastra.getAgent('my-agent', { browser });

Patch Changes