docs: Google ADK Guard (JS and Python) and Cloudflare Think

[davidmytton]

Documents Google ADK Guard for JS and Python on one tabbed /guards/google-adk/ page, and adds Cloudflare Think Guard at /guards/cloudflare-think/.

• Google ADK — JS @arcjet/guard/google-adk/v2 and Python arcjet.guard.google_adk / arcjet[google-adk] behind Strands-style language tabs. Retired /guards/google-adk-py/ (old URLs redirect).
• Cloudflare Think — @arcjet/guard/cloudflare-think/v0, with the official Cloudflare mark in the framework switcher.
• Wiring — framework switcher, sidebar, SDK registry, get-started, quick-start, framework-integrations index, llms.txt, redirects, and Playwright snapshots.

Until publish: Python ADK pin a71970dc; Think pin b06e584d.

Supersedes #920.

  

[vercel]

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

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

[cursor]

Review of b4873298 (content from 6e08456e plus CI-aligned Think snapshots):

Content looks good. Both /guards/google-adk-py/ and /guards/cloudflare-think/ teach actor/inputs on day one: omit those names and a remote rule that declares them never fires; a resolver throw is a guard error and fail-closes via the deny default; actor comes from authenticated app state, never model tool args.

Related cites check out: Think points at examples/cloudflare-think-agent at 48d4e54c (not main); ADK Python points at examples/fastapi-google-adk-guard at a71970dc. Live /guards/google-adk/ was left alone.

CI is green on this head after refreshing the Think light/dark screenshots from CI actuals (the only deterministic Playwright failure). #920 is already closed as superseded.

[arcjet-review]

Arcjet Review — 🔴 High Risk

Decision: Blocked

Rationale: PR has merge conflicts. Resolve conflicts before review.

_{Review: 9a6f0156 | Powered by Arcjet Review}

[arcjet-review]

Arcjet Review — 🟢 Low Risk

Decision: Approved

Rationale: Documentation-only PR adding new guard pages for Cloudflare Think and a tabbed JS/Python page for Google ADK, plus supporting sidebar/switcher/redirect entries and refreshed screenshots. The previous blocking merge conflict was resolved via the 'merge: bring main into the ADK and Think docs branch' commit. Code changes are additive entries in framework/SDK maps and a new SVG icon component; the two workflow edits only add workflow_dispatch triggers, which is a low-risk convenience. No secrets, no auth/infra logic, no schema changes. PR is >1000 lines but almost entirely MDX/snippets/PNG snapshots — low risk despite size.

Summary of Changes

Adds a new /guards/cloudflare-think/ page and merges Google ADK JS + Python into a single tabbed /guards/google-adk/ page (superseding the split /guards/google-adk-py/). Wires the two into the framework switcher, sidebar, SDK registry, get-started, quick-start, framework-integrations index, Python reference, and llms.txt/llms-full.txt. Adds a Simple-Icons Cloudflare mark icon component, get-started + quick-start snippets for both, screenshot baselines, sdk.test.ts assertions, vercel.json redirects from old /guards/google-adk-py/ and /sdk/google-adk-py/* URLs, and workflow_dispatch triggers on the Playwright and spellcheck workflows.

Escalation Triggers

• CI/CD Pipeline: playwright.yml and spellcheck.yml each add a workflow_dispatch trigger. Low-impact convenience change, no secrets or permissions touched.

Notes

PR exceeds the 1000-line size threshold, but the bulk is MDX prose, JSON redirect entries, and binary screenshot baselines — all straightforward to review. Previous blocking issue (merge conflicts) has been resolved by the merge commit from main.

_{Review: 49a6f2a7 | Model: anthropic/claude-opus-4-7 | Powered by Arcjet Review}

[cursor]

Review of 07951ab4:

1. Cloudflare Think icon: PASS. CloudflareThink.tsx uses the Simple Icons cloudflare path, byte-for-byte the current Simple Icons mark. The switcher, SDK icon, and framework links all use that component. The old notched cloud glyph is gone.
2. One Google ADK page: PASS. There is no /guards/google-adk-py/ content page. Python is language tabs on /guards/google-adk/, the same pattern as /guards/strands-agents/. Cloudflare Think stays /guards/cloudflare-think/.

Redirects and listings: PASS. /guards/google-adk-py redirects to /guards/google-adk, and /sdk/google-adk-py redirects to /sdk/google-adk/get-started. The switcher, sidebar, framework-integrations index, get-started, and llms-full.txt list one Google ADK entry.

Actor/inputs and cites: PASS. The merged page still teaches actor and inputs. The Python pin is still a71970dc; the install link now points at that commit tree because david/cursor/google-adk-guard-5549 was deleted. Examples remain examples/google-adk-agent (JS, main) and examples/fastapi-google-adk-guard at a71970dc. Think Related still cites examples/cloudflare-think-agent at 48d4e54c.

CI on 07951ab4: green. Playwright (build, four shards, merge-reports), typos, Vercel, and both Socket checks passed. The PR is mergeable.

Nit: Playwright and spellcheck now allow workflow_dispatch so a stuck run can be started by hand. It does not change the docs.

[cursor]

Review of 07951ab4:

David’s content requirements: PASS.

• Cloudflare Think uses the official Simple Icons mark (M16.5088… in CloudflareThink.tsx).
• There is no /guards/google-adk-py/ page. Python is language tabs on /guards/google-adk/. Cloudflare Think stays /guards/cloudflare-think/.
• /guards/google-adk-py redirects to /guards/google-adk. /sdk/google-adk-py redirects to /sdk/google-adk/get-started. Switcher, sidebar, and prefs list one Google ADK entry.
• Actor/inputs teaching is still on the merged page. Python pin remains a71970dc (install link is that commit tree). Think Related still cites examples/cloudflare-think-agent at 48d4e54c.

CI on 07951ab4: green. Playwright (build, four shards, merge-reports), typos, Vercel, and both Socket checks passed. The PR is mergeable.

All six review threads are resolved.

[cursor]

Post-rebase re-verify

• HEAD: b3502b62 (rebased onto main 76554db6; prior HEAD 272d716f + quick-start snapshot refresh from CI actuals)
• Content: PASS
  • Official Cloudflare Think mark (Simple Icons), not a generic cloud glyph
  • No separate /guards/google-adk-py/; Python is language tabs on /guards/google-adk/ (Strands pattern)
  • Cloudflare Think stays /guards/cloudflare-think/
  • Redirects google-adk-py → google-adk (guards + sdk get-started)
  • Actor/inputs teaching on merged ADK page
  • Pins a71970dc (ADK) / b06e584d (Think) unchanged
  • Prior review fixes present (Env placeholder, per-request hooks, split install, guard_action link, workflow_dispatch note)
• CI on b3502b62: all green — Playwright (build + shards 1–4 + merge-reports), typos, Socket, Vercel
• Note: 272d716f Playwright failed only on intentional UI (guards-quick-start light/dark); snapshots refreshed in b3502b62
• Mergeability: MERGEABLE / CLEAN (not merging)

[cursor]

Final confirm after rebase

• HEAD: b3502b62 (snapshot refresh after rebase 272d716f onto main 76554db6)
• Content: PASS
• CI: green (Playwright build/shards/merge-reports, typos, Socket×2, Vercel)
• Mergeability: MERGEABLE / CLEAN (not merging)