Skip to content

Conversation

@shubh24
Copy link

@shubh24 shubh24 commented Sep 19, 2025

Why

There was no documentation for the stagehand.history feature, which provides users with a chronological record of all Stagehand operations during an
automation session. This left users unaware of this useful debugging and monitoring capability.

What Changed

  • Added comprehensive documentation for stagehand.history to docs/configuration/observability.mdx
  • Included basic usage examples showing how to access and examine operation history

tkattkat and others added 10 commits September 10, 2025 13:40
# why

solves #1060 
patch regression of playwright arguments being removed from agent
execute response

# what changed

agent.execute now returns playwright arguments in its response 

# test plan

tested locally
…ms to docs (#1065)

# why

reflect project id changes in docs

# what changed

advanced configuration comments

# test plan

reviewed via mintlify on localhost
# why

Easier to use for Custom LLM Clients and keep users up to date with our
aisdk file

# what changed

added export of aisdk to lib/index.ts

# test plan

build local stagehand, import local AISdkClient, run Azure Stagehand
session
…onfigu… (#1073)

…ration settings

# why

Updated docs to match the new fingerprint params in the Browserbase docs
here:
https://docs.browserbase.com/guides/stealth-customization#customization-options

# what changed

Update browser configuration docs to reflect the docs changes. 

# test plan
# why

Updating docs to reflect aisdk can be imported directly

# what changed

The model page

# test plan

Reviewed page with mintlify dev locally
# why

# what changed

# test plan
# why

Currently, we do not support stagehand agent within the api

# what changed

When api is enabled, stagehand agent now routes through the api 

# test plan

Tested locally
# why

Currently, using playwright screenshot command is not available when the
execution environment is Stagehand. A customer has indicated they would
prefer to use Playwright's native screenshot command instead of CDP when
using Browserbase as CDP screenshot causes unexpected behavior for their
target site.

# what changed

- added a StagehandScreenshotOptions type with useCDP argument added
- extended page type to accept custom stagehand screeenshot options
- update screenshot proxy to default useCDP to true if the env is
browserbase and use playwright screenshot if false
- added eval for screenshot with and without cdp

# test plan
- tested and confirmed functionality with eval and external example
script (not committed)
@changeset-bot
Copy link

changeset-bot bot commented Sep 19, 2025

⚠️ No Changeset found

Latest commit: a8c5052

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Greptile Summary

This PR adds comprehensive documentation for the stagehand.history feature in the observability guide. The documentation explains how to access and examine the chronological record of Stagehand operations during automation sessions.

  • Adds new "Action History Tracking" section with clear usage examples
  • Provides both TypeScript and Python code samples
  • Documentation aligns with the actual HistoryEntry interface implementation
  • Includes practical examples showing how to iterate through and examine history entries

Confidence score: 4/5

  • This PR is safe to merge with minimal risk
  • Well-written documentation addition that accurately reflects the existing API. Only minor style improvement needed for Python naming convention
  • No files require special attention

1 file reviewed, 1 comment

Edit Code Review Bot Settings | Greptile

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants