stagehand tool

[filip-michalsky]

Integration of Stagehand Python SDK with CrewAI

https://pypi.org/project/stagehand-py/

[lucasgomide]

@filip-michalsky could you share a video showing this tool working?

[filip-michalsky]

@filip-michalsky could you share a video showing this tool working?

Hey @lucasgomide - absolutely!

Here is a video of the Stagehand tool powering atomic browsing commands for CrewAI web research agent:

https://screen.studio/share/1HTuXVvs

please let me know if you have any other questions for this PR?

[lucasgomide]

Good job! I liked that..

I drop a few comments, let me know what you think

[filip-michalsky]

@lucasgomide the feedback was addressed - is this good to merge? Thanks so much!

[lucasgomide]

@filip-michalsky Just double-checking it’s important that we support both ways of using StagehandTool: with a context manager and without one.
The documentation currently says it’s only usable without a context manager, but we’re actually supporting usage like this:

# Using as a context manager
with StagehandTool() as tool:
    Agent(tools=[tool])

# Manual management
tool = StagehandTool()
try:
    Agent(tools=[tool])
finally:
    tool.close()

Just update the documentation by adding we can use with context manager also

[filip-michalsky]

@lucasgomide this was updated as well!

[filip-michalsky]

@lucasgomide thanks for the approval! I see there are other tools not related to stagehand failing in the CI - how should we address so that this can be merged? I am happy to try to help but I am not familiar with the other tools that much

[lucasgomide]

@filip-michalsky Add it into your pyproject.toml

[project.optional-dependencies]
.... 
# added it after mcp 
stagehand = [
    "stagehand-py>=0.3.6",
]

then run uv sync and then push that!

[lucasgomide]

@filip-michalsky something weird is happing with your tests.. I gonna checkout later and fix it

[filip-michalsky]

thank you @lucasgomide !

[filip-michalsky]

@lucasgomide i have been trying to fix the tests. in isolation uv run pytest tests/tools/stagehand_tool_test.py -vv

the tests work, but the module mocking is when running the whole test suite is failing...
uv run pytest tests/tools/ -vv`
I have been trying to fix this but no luck thus far