Skip to content

Add read-only Parallel web gatekeeper - #80

Closed
RowanAldean wants to merge 1 commit into
cloudflare:mainfrom
RowanAldean:agent/add-parallel-gatekeeper
Closed

Add read-only Parallel web gatekeeper#80
RowanAldean wants to merge 1 commit into
cloudflare:mainfrom
RowanAldean:agent/add-parallel-gatekeeper

Conversation

@RowanAldean

Copy link
Copy Markdown

Summary

  • add an optional, install-once gatekeeper-parallel package
  • expose read-only Parallel web search and URL extraction through an ambient PARALLEL binding
  • keep the deployment API key inside the Gatekeeper Worker and audit every returned result as an observation
  • add deploy metadata, generated Worker types, setup documentation, and release-manifest coverage

Why

Parallel's Search and Extract APIs return LLM-optimized web content. Exposing them through a Gatekeeper gives Cloudflare OS agents a native web research path while preserving the capability and observation model used by the rest of the project.

Security and behavior

  • PARALLEL_API_KEY is a deployment secret and is never returned to agents or Gadgets
  • the gatekeeper provides no authentication identity and no write actions
  • searches and extractions are released only after observation authorization
  • extraction accepts only HTTP(S) URLs and enforces Parallel's 20-URL request limit

This is a draft to get feedback on the integration shape and whether this belongs as a first-party Gatekeeper package.

Validation

  • pnpm types:check
  • pnpm lint:check (passes with existing repository warnings)
  • pnpm --filter @gadgets/gatekeeper-parallel build
  • node --test scripts/release-manifest.test.js
  • Wrangler deployment dry-run for gatekeeper-parallel

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@RowanAldean

Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA

github-actions Bot added a commit that referenced this pull request Aug 7, 2026
@RowanAldean
RowanAldean marked this pull request as ready for review August 7, 2026 21:34
@RowanAldean

Copy link
Copy Markdown
Author

I know this PR is 16 files as per guidelines so will open a discussion too? This just felt useful given low cost web search capability and can work my existing setup this last couple of weeks. Happy to close in favour of discussing how to add ☺️

@RowanAldean

Copy link
Copy Markdown
Author

Closed in favour of having my Hermes agent remind me after I use the OS more 👀

@RowanAldean RowanAldean closed this Aug 7, 2026
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