Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
@cindy/browser-control-runtime
Neutral, in-process browser-automation runtime for Cindy. Exposes a small,
stable contract (BrowserControlRuntime) that the cindy_browser MCP and the
desktop host drive — without depending on any upstream product API or surfacing
an upstream product name in product code.
Layout
src/
types.ts Public contract: BrowserControlRuntime / Request / Result
runtime.ts createBrowserControlRuntime() — drives the vendored
in-process route dispatcher behind the contract
unavailable.ts A safe "not configured" runtime
shim/ Hand-written replacements for the upstream plugin-sdk
surface the vendored core imports (see shim-spec)
_local/ Faithful ports of small self-contained upstream helpers
(errors, ports, redact, tmp-dir, browser-cdp, text-utils)
_generated/ GENERATED — DO NOT EDIT. Produced by sync.mjs:
extension/ vendored browser core (extensions/browser/src/**)
leaf/ vendored SSRF / security leaf closure (src/infra, src/security)
packages/ vendored net-policy + normalization-core
vendor/fs-safe/ vendored @openclaw/fs-safe dist (zero-dep, version-pinned)
__tests__/ runtime + SSRF contract tests
upstream/
MAINTAINING.md 维护者必读:三层架构 + 踩坑清单 + 上游同步 + 中性约束
browser-runtime.lock.json pinned commit + fs-safe version + content hash
vendor-manifest.txt the 133 core files
shim-spec.md exact named-export surface each shim must provide
STATUS.md 交付现状
BUILD-PLAN.md 历史设计笔记
改这块代码前先读
upstream/MAINTAINING.md—— 它记录了集成层(desktop host + cindy_browser MCP)以及所有踩过的坑与不变量。
Updating from upstream
pnpm sync:browser-runtime --ref=<commit-or-branch>
pnpm --filter @cindy/browser-control-runtime build # surfaces any shim gaps
pnpm --filter @cindy/browser-control-runtime test # contract + SSRF guard
_generated/** is regenerated wholesale; never hand-edit it. To change behavior,
edit sync.mjs (vendor set / import rewrite) or the hand-written src/shim/*.
Security note
The SSRF/path-containment decision logic is vendored upstream code, not
re-implemented. src/shim/ssrf-runtime.ts only re-implements the thin fetch
shell that composes those vendored primitives (isBlockedHostnameOrIp,
resolvePinnedHostnameWithPolicy, createPinnedDispatcher). The SSRF contract
tests assert the real teeth still block cloud-metadata and private IPs, so a
future sync that weakens them fails CI.