Skip to content

feat: add agentcore browser tool#133

Draft
craigh33 wants to merge 19 commits into
mainfrom
feat/agentcore-browser-tool
Draft

feat: add agentcore browser tool#133
craigh33 wants to merge 19 commits into
mainfrom
feat/agentcore-browser-tool

Conversation

@craigh33

@craigh33 craigh33 commented Jul 8, 2026

Copy link
Copy Markdown
Owner

Summary

Adds tools/agentcorebrowser, a constrained ADK tool for Amazon Bedrock AgentCore Browser. It supports session start/status/stop plus CDP-backed navigate, extract_text, and screenshot actions with host policy checks and artifact-backed screenshots.

Also adds a runnable examples/bedrock-agentcore-browser, package docs, tests, and moves the Nova Web Grounding note from the root README into tools/novagrounding/README.md.

Type of change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature / enhancement (non-breaking change that adds behavior)
  • Breaking change (fix or feature that could break existing callers)
  • Documentation only
  • Build / CI / tooling
  • Refactor / test / chore (no user-visible behavior change)

Testing

  • make test
  • make lint (or equivalent local golangci-lint)
  • Example Created/Updated: added examples/bedrock-agentcore-browser

Additional verification: make build; commit hooks passed.

Checklist

  • I ran pre-commit run --all-files (or equivalent local hooks).
  • My change follows existing patterns in this repository (naming, layout, error handling).
  • I updated docs when behavior, setup, or public API surface changed (if applicable).
  • I considered backwards compatibility for library consumers (if applicable).

Related issues

Fixes #98

@craigh33 craigh33 self-assigned this Jul 8, 2026
Copilot AI review requested due to automatic review settings July 8, 2026 15:26
@craigh33 craigh33 added documentation Improvements or additions to documentation enhancement New feature or request go Pull requests that update go code labels Jul 8, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds a new ADK tool package (tools/agentcorebrowser) that exposes a constrained subset of Amazon Bedrock AgentCore Browser capabilities (session lifecycle + CDP-backed navigate/text extraction/screenshot), along with tests, docs, and a runnable example. Also moves the Nova Web Grounding documentation out of the root README into tools/novagrounding/README.md.

Changes:

  • Introduce agentcore_browser tool with session start/status/stop and constrained CDP actions (navigate, extract_text, screenshot) plus host policy checks and artifact-backed screenshots.
  • Add unit tests and a runnable example CLI under examples/bedrock-agentcore-browser.
  • Update docs: new tool README, new Nova grounding README, and root README example list adjustments.

Reviewed changes

Copilot reviewed 9 out of 10 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
tools/agentcorebrowser/tool.go Implements the AgentCore Browser ADK tool, including CDP connection logic and host policy checks.
tools/agentcorebrowser/tool_test.go Adds unit tests for config validation, host policy, CDP actions, and artifact saving.
tools/agentcorebrowser/README.md Documents tool usage, behavior, and required IAM permissions.
examples/bedrock-agentcore-browser/main.go Runnable example wiring the tool into an ADK agent/runner.
examples/bedrock-agentcore-browser/README.md Example setup and IAM documentation.
examples/bedrock-agentcore-browser/Makefile Adds a simple make run wrapper for the example.
tools/novagrounding/README.md Adds Nova grounding docs previously in the root README.
README.md Adds the AgentCore Browser example to the list and removes the embedded Nova grounding section.
go.mod Adds bedrockagentcore and makes gorilla/websocket a direct dependency.
go.sum Records new module checksums for the added dependencies.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool_test.go Outdated
Comment thread tools/agentcorebrowser/README.md Outdated
Copilot AI review requested due to automatic review settings July 8, 2026 15:35

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 2 comments.

Comment thread tools/agentcorebrowser/tool.go
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 8, 2026 15:50

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 5 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 8, 2026 16:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 2 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 8, 2026 16:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 4 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 8, 2026 16:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 2 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/README.md Outdated
Copilot AI review requested due to automatic review settings July 15, 2026 09:34

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated no new comments.

Copilot AI review requested due to automatic review settings July 15, 2026 11:52

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated 1 comment.

Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 15, 2026 12:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated 2 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 15, 2026 12:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.

Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 15, 2026 12:20

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated 1 comment.

Comment thread tools/agentcorebrowser/tool.go Outdated
Copilot AI review requested due to automatic review settings July 15, 2026 12:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated no new comments.

Copilot AI review requested due to automatic review settings July 16, 2026 09:43

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 13 out of 15 changed files in this pull request and generated 1 comment.

Comment thread tools/agentcorebrowser/actions.go Outdated
Copilot AI review requested due to automatic review settings July 16, 2026 10:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 13 out of 15 changed files in this pull request and generated no new comments.

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

Labels

documentation Improvements or additions to documentation enhancement New feature or request go Pull requests that update go code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement AgentCore Browser tool

2 participants