Skip to content

docs: Google ADK JS + Python Strands Agents Guard - #917

Merged
davidmytton merged 10 commits into
mainfrom
david/cursor/google-adk-strands-py-2ccd
Sep 3, 2026
Merged

docs: Google ADK JS + Python Strands Agents Guard#917
davidmytton merged 10 commits into
mainfrom
david/cursor/google-adk-strands-py-2ccd

Conversation

@davidmytton

@davidmytton davidmytton commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Adds Guard adapter pages for Google ADK JS and Python Strands Agents.

Until-published pins:

  • Google ADK JS (/guards/google-adk/): 41ef3681. Peer @google/adk >=2 <3. Surfaces: guardPlugin + googleAdkContext only. No guardTool. DENY is an ArcjetDenialResult dict that skips the tool runAsync. Fail closed returns that dict; never undefined on error. Related cites examples/google-adk-agent (example branch david/cursor/google-adk-agent-guardrails @ 312cb80c).
  • Python Strands Agents (/guards/strands-agents-py/): a6308061. Extra arcjet[strands-agents] with strands-agents>=1.11.0,<2. Surfaces: guard_tool + guard_hooks + strands_agent_context. Gate is per-tool cancel_tool only. Related cites examples/fastapi-strands-agents-guard (example branch david/cursor/fastapi-strands-agents-guard-example @ b132a510).

The live JS /guards/strands-agents/ page is untouched. This PR does not rewrite TanStack AI, Claude Agent SDK Python, or unpublished JS Strands docs.

Open in Web Open in Cursor 

cursoragent and others added 3 commits September 3, 2026 03:21
Until-published placeholders (ADAPTER_SHA) for JS Google ADK
(@arcjet/guard/google-adk/v2) and Python Strands Agents
(arcjet[strands-agents]). Leaves the live JS Strands page unchanged.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Replace the ADAPTER_SHA placeholder with the shipped arcjet-py SHA and
document the strands-agents>=1.11.0,<2 extra floor. Google ADK stays
unpinned.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Replace the ADAPTER_SHA placeholder with the shipped arcjet-js SHA
and sync HITL names from the adapter. Python Strands stays pinned
to a6308061.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
@vercel

vercel Bot commented Sep 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
arcjet-docs Ready Ready Preview Sep 3, 2026 11:43am UTC

Request Review

@davidmytton
davidmytton marked this pull request as ready for review September 3, 2026 03:33
google-adk-agent is not on a branch yet. Keep the ADK pin at 41ef3681
and the Python Strands Related cite for fastapi-strands-agents-guard.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>

@arcjet-review arcjet-review Bot 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.

Arcjet Review — 🟢 Low Risk

Decision: Approved

Rationale: Documentation-only PR adding two new Guard adapter pages (Google ADK JS and Strands Agents Python) plus supporting scaffolding: framework registry entries, icons, sidebars, snippets, snapshot updates, and Vercel redirects. No runtime application code, no auth/secrets/infrastructure changes. The additions follow the same shape as existing framework pages (e.g., Genkit, Strands Agents JS). No security flags. Approving despite the size because the diff is overwhelmingly new .mdx content plus mechanical registrations, which is low-risk and internally consistent.

Summary of Changes

Adds Guard adapter documentation for Google ADK JS (guardPlugin + googleAdkContext, no guardTool; DENY skips runAsync) and Python Strands Agents (guard_tool + guard_hooks + strands_agent_context; per-tool cancel_tool). Includes framework-integrations updates, get-started and quick-start snippet trees, sidebar entries, Vercel redirects, llms.txt/llms-full.txt updates, snapshot updates, and Google ADK icon component. Both adapters are pinned to unpublished commits until upstream releases land.

Notes

PR is ~2,500 changed lines, above the 1000-line size threshold, but the bulk is new .mdx documentation and mechanical registry additions (framework enum lists, icon map, sidebar, redirects, llms.txt snapshots). Reviewing the two new guard pages and the get-started/quick-start snippet trees is the substantive part; everything else is pattern-following boilerplate that mirrors existing adapters.

Review: 2753d128 | Model: anthropic/claude-opus-4-7 | Powered by Arcjet Review

Comment thread src/snippets/guards/quick-start/google-adk/Wrap.ts Outdated
Comment thread src/snippets/guards/quick-start/google-adk/Wrap.ts Outdated
Comment thread src/snippets/guards/quick-start/strands-agents-py/Wrap.py
Comment thread src/snippets/guards/quick-start/google-adk/Try.ts
Comment thread src/content/docs/guards/google-adk.mdx
The example branch is in at 312cb80c and vendors the 41ef3681 pin.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
cursoragent and others added 4 commits September 3, 2026 11:27
Make the Python Strands quick-start helper async so Try.py can
await it, wrap the inbound sample in async def, and say the
plugin skips the tool runAsync. Frontmatter uses requireConfirmation.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Generate the new google-adk and strands-agents-py snapshots and
refresh the get-started, guards hub, framework-integrations, and
quick-start Linux baselines that list those adapters.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Build ADK tools per run so user context is not shared, stub the
mail transports, drop unused allowedRecipients, and add
package-manager install tabs on the ADK page.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
Google ADK and Strands Agents Python lengthened the homepage
framework list, so the home light/dark Playwright baselines need
the new 1280x1683 size.

Co-authored-by: David Mytton <davidmytton@users.noreply.github.com>
@davidmytton
davidmytton added this pull request to the merge queue Sep 3, 2026
@arcjet-review arcjet-review Bot added the ready Ready to merge label Sep 3, 2026
Merged via the queue into main with commit f74ea67 Sep 3, 2026
11 checks passed
@davidmytton
davidmytton deleted the david/cursor/google-adk-strands-py-2ccd branch September 3, 2026 12:04
@arcjet-review arcjet-review Bot removed the ready Ready to merge label Sep 3, 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.

2 participants