Skip to content

refactor: rebuild agentic webview as modular SDK - #6

Merged
shanthropic merged 13 commits into
mainfrom
refactor/agentic-webview-architecture
Sep 2, 2026
Merged

refactor: rebuild agentic webview as modular SDK#6
shanthropic merged 13 commits into
mainfrom
refactor/agentic-webview-architecture

Conversation

@shanthropic

Copy link
Copy Markdown
Owner

Summary

This is the complete breaking refactor of the prototype Agentic WebView into a modular, framework-neutral Android browser SDK. It intentionally removes the prior controller API and adds no compatibility layer.

What changed

  • Split the project into platform-neutral API, Android WebView host, Compose binding, generic tools, Koog, JSON-RPC, and TypeScript runtime modules.
  • Rebuilt browser lifecycle, typed commands/results/errors, semantic observation, document/frame/element identity, and action verification.
  • Added a versioned correlated protocol with cancellation, timeouts, size/pending limits, callback rate limits, and shared fixtures.
  • Hardened navigation and WebView behavior: HTTPS-only default, host/scheme policy, credential rejection, Safe Browsing/TLS handling, delegated privileged requests, bounded popup relay, renderer handling, sensitive-data and diagnostic redaction.
  • Added same-origin frame and open Shadow DOM support, traversal budgets, stable identity, postcondition receipts, screenshots, and untrusted-webpage markers.
  • Added framework-neutral JSON Schema tools, Koog and JSON-RPC adapters, sample app, canonical docs, ADR, architecture/artifact validators, CI, release checks, APK/checksum packaging, and Maven publication workflow.
  • Deleted the prototype modules, obsolete app path, legacy web injector, duplicated website docs, and compatibility surface.

Verification

Passed locally:

  • TypeScript strict typecheck
  • 43 runtime tests across 6 suites
  • Production runtime bundle: 37,398 bytes
  • Architecture and documentation-link validation
  • Workflow YAML, package JSON, Android XML, and diff checks

Deferred to the planned acceptance pass:

  • Gradle/JVM tests, Android lint/assembly, and emulator instrumentation
  • Website install/lint/build
  • Maven publication and clean consumer smoke test
  • Reference-device performance baselines

Breaking change

This targets the 0.3.0-SNAPSHOT development line. Consumers must migrate to the new AgenticBrowserHost / AgenticBrowserSession API and modular coordinates; no compatibility façade is provided.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 2, 2026

Copy link
Copy Markdown

Deploying agentic-webview with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7c7dde1
Status: ✅  Deploy successful!
Preview URL: https://367bda81.agentic-webview.pages.dev
Branch Preview URL: https://refactor-agentic-webview-arc.agentic-webview.pages.dev

View logs

@shanthropic
shanthropic merged commit 94954dc into main Sep 2, 2026
4 checks passed
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