Skip to content

feat: add direct browser tool and drop worker - #191

Merged
QueryPlanner merged 1 commit into
mainfrom
codex/agent-browser-tool
Oct 21, 2026
Merged

QueryPlanner merged 1 commit into
mainfrom
codex/agent-browser-tool

Conversation

@QueryPlanner

@QueryPlanner QueryPlanner commented Oct 21, 2026 •

Copy link
Copy Markdown
Owner

What

Add a dedicated agent_browser(args) tool and remove the delegated task_worker. The root agent performs browser work directly in its current session sandbox, using the shared Chromium/agent-browser sandbox image.

Why

Browser calls should have an explicit argument-based interface, as Athena does. Removing the task worker keeps a single execution path and avoids building a second model and toolset for delegation. The browser boundary is now explicit: Chromium runs in the isolated OpenSandbox, never on the Blacki host.

How

  • Add agent_browser(args), validate the argument list, shell-quote each argument, pin the current conversation's browser session, add content boundaries, and enforce a 90-second timeout.
  • Register the tool only when sandbox tools are enabled and hide it during ordinary web search.
  • Default SANDBOX_IMAGE to ghcr.io/queryplanner/athena-sandbox:latest, which provides Chromium, a pinned agent-browser, and its bundled usage guides.
  • Use a portable sandbox entrypoint that starts the Athena Jupyter/agent-browser bootstrap when present and falls back to the OpenSandbox code-interpreter entrypoint; pass a fresh per-sandbox Jupyter token.
  • Raise the default sandbox memory to 1Gi so Chromium has headroom.
  • Remove the duplicated agent_browser skill. The tool directs the model to agent_browser(args=["skills", "get", "core"]) or agent_browser(args=["--help"]).
  • Update AGENTS.md and the architecture/environment docs to describe the sandbox browser boundary.
  • Remove worker construction, worker instructions, the feature flag, and obsolete worker tests and documentation.
  • Preserve private/public tool boundaries, root failure recovery, memory preload, app plugins, and compaction.

Tests

  • uv run ruff format and uv run ruff check
  • uv run mypy . (218 source files)
  • uv run pytest --cov=src (2,086 passed, 1 skipped, 100% line and branch coverage)
  • uv run --no-sync mkdocs build --strict
  • uv run pytest tests/test_deployment_contract.py (29 passed, 1 skipped)
  • bash -n setup.sh entrypoint.sh
  • docker compose -f compose.yaml -f compose.prod.yaml config --quiet
  • Athena sandbox image pulled and checked: agent-browser 0.38.1, Chromium 154.0.8037.92, and the bundled skills get core guide
  • Production Docker image build and container readiness smoke test on this exact branch (the stacked Zepto branch passes both)

Breaking Changes

  • TASK_WORKER_ENABLED no longer enables delegation. Blacki no longer registers a task worker; existing conversation history is retained.
  • The default sandbox image is now ghcr.io/queryplanner/athena-sandbox:latest (linux/amd64), and the default sandbox memory is 1Gi. Override with SANDBOX_IMAGE or SANDBOX_MEMORY_LIMIT; on arm64, build an arm64 image.
  • The bundled agent_browser skill is removed. The tool exposes the same CLI, and the image's bundled usage guide is available through agent_browser(args=["skills", "get", "core"]).

Related Issues

  • Resolves the hosted review finding on the browser boundary.

@QueryPlanner

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ⚠️ Failed 2026-10-21T16:02:46.390701Z
We couldn’t complete this review. Comment @codex review to try again.
5d1a049 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7220b61dc6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/blacki/tools/agent_browser.py Resolved
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

- Add agent_browser tool for the session sandbox
- Remove task worker, instructions, and feature flag
- Use the Chromium/agent-browser sandbox image
- Remove the separate agent_browser skill
- Update browser boundary and sandbox docs
@QueryPlanner
QueryPlanner force-pushed the codex/agent-browser-tool branch from 7220b61 to 71f767a Compare October 21, 2026 15:42
@QueryPlanner QueryPlanner mentioned this pull request Oct 21, 2026
10 tasks done
@QueryPlanner

Copy link
Copy Markdown
Owner Author

@codex review

@QueryPlanner
QueryPlanner merged commit 5d1a049 into main Oct 21, 2026
3 checks passed
@QueryPlanner
QueryPlanner deleted the codex/agent-browser-tool branch October 21, 2026 15:58
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

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.

1 participant