feat(agentcore): enhance Browser & Code Interpreter toolkits with full session config, new tools, and telemetry

[kevin-orellana]

Summary

Enhances the AWS Bedrock AgentCore Browser and Code Interpreter toolkits to expose the full SDK feature surface — session configuration with typed dataclass support, new tool capabilities, and telemetry tracking.

Telemetry

• Add integration_source="crewai" to BrowserClient and CodeInterpreter constructors for customer acquisition tracking via User-Agent header

Session Configuration Passthrough (with SDK Typed Dataclass Support)

Expose all start() parameters so users can configure sessions at toolkit creation time. Previously only identifier was supported — all other SDK options were silently ignored.

All config parameters accept both SDK typed dataclasses and plain dicts, matching the SDK's own BrowserClient.start() signature. Typed dataclasses give users IDE autocomplete, validation at construction time, and convenience factory methods.

Browser — 5 new params on BrowserToolkit / create_browser_toolkit():

• session_timeout_seconds — session timeout in seconds (1–28800, default 3600)
• viewport — ViewportConfiguration or dict. Factory methods: .desktop_hd(), .laptop(), .mobile(), etc.
• proxy_configuration — ProxyConfiguration or dict. Proxy routing with optional auth via Secrets Manager
• extensions — list[BrowserExtension | dict]. S3-hosted browser extensions
• profile_configuration — ProfileConfiguration or dict. Persist cookies/local storage across sessions

Code Interpreter — 1 new param on CodeInterpreterToolkit / create_code_interpreter_toolkit():

• session_timeout_seconds — session timeout in seconds (default 900)

All params default to None (SDK defaults apply). No validation on our side — the SDK handles it.

Custom Sandbox Identifier

• Add optional identifier parameter to BrowserToolkit, CodeInterpreterToolkit, and BrowserSessionManager for custom browser/interpreter resources (VPC, recording, Web Bot Auth)
• Passed through to .start(identifier=...) on the underlying SDK clients

New Browser Tools (3)

• GenerateLiveViewUrlTool — generate a presigned URL for live browser viewing
• TakeControlTool — take manual control of the browser (disables automation)
• ReleaseControlTool — release manual control (re-enables automation, reconnects Playwright)

New Code Interpreter Tools (6)

• UploadFileTool / UploadFilesTool — upload files with optional semantic descriptions
• DownloadFileTool / DownloadFilesTool — download files from the sandbox
• InstallPackagesTool — install pip packages with optional --upgrade flag
• ClearContextTool — reset the Python execution context

Browser Session Manager

• Add reconnect_sync_browser() / reconnect_async_browser() for CDP reconnection after release_control()
• Add get_browser_client() / get_async_browser_client() accessors for the underlying BrowserClient
• Thread-safe session creation with per-key events to serialize without blocking unrelated callers

Usage Examples

# Browser with typed SDK dataclasses (recommended)
from bedrock_agentcore.tools import (
    ViewportConfiguration, ProxyConfiguration, ExternalProxy,
    ProfileConfiguration,
)

toolkit, tools = create_browser_toolkit(
    region="us-west-2",
    viewport=ViewportConfiguration.desktop_hd(),  # 1920x1080
    proxy_configuration=ProxyConfiguration(
        proxies=[ExternalProxy(server="proxy.corp.com", port=8080)],
        bypass_patterns=[".amazonaws.com"],
    ),
    profile_configuration=ProfileConfiguration(profile_identifier="my-profile"),
    session_timeout_seconds=7200,
)

# Browser with plain dicts (also works)
toolkit, tools = create_browser_toolkit(
    region="us-west-2",
    viewport={"width": 1920, "height": 1080},
    proxy_configuration={
        "proxies": [{"externalProxy": {"server": "proxy.corp.com", "port": 8080}}],
        "bypass": {"domainPatterns": [".amazonaws.com"]},
    },
    session_timeout_seconds=7200,
)

# Code interpreter with longer timeout
toolkit, tools = create_code_interpreter_toolkit(
    region="us-west-2",
    session_timeout_seconds=1800,
)

Test Plan

• 68 unit tests (all pass) covering telemetry, identifier passthrough, session config passthrough with both dicts and typed dataclasses (sync + async), all new tools, edge cases
• Live integration tests against real AgentCore sessions verifying:
  • Browser viewport 1920x1080 returned in session API response
  • Browser timeout 600s applied correctly
  • Code interpreter timeout 1800s applied correctly
  • Default timeouts (3600s browser, 900s CI) when no config specified

---

Note

Medium Risk
Modifies AgentCore Browser/Code Interpreter session lifecycle and configuration passthrough (including reconnection behavior), which could impact remote session stability and resource cleanup. Changes are covered by new unit tests but touch threaded/async session management and SDK start kwargs.

Overview
Adds new Amazon Bedrock AgentCore documentation pages (EN/KO) and navigation entries for AgentCore Browser, AgentCore Code Interpreter, and an AgentCore Overview.

Extends the AgentCore BrowserToolkit and CodeInterpreterToolkit to pass through additional SDK session configuration (e.g., session_timeout_seconds, viewport, proxy_configuration, extensions, profile_configuration, plus identifier), and tags SDK client creation with integration_source="crewai".

Introduces new browser tools for human oversight/control (including generate_live_view_url, take_control, release_control with Playwright reconnection) and new code-interpreter tools for file transfer, package install, and context reset. Adds comprehensive unit tests for the new capabilities and config passthrough.

^{Written by Cursor Bugbot for commit d4dd9dd. This will update automatically on new commits. Configure here.}

[kevin-orellana]

Fixed in e23da7d — changed if self.identifier: to if self.identifier is not None: in both browser_session_manager.py (sync + async paths) and code_interpreter_toolkit.py. Now consistent with all other params.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}