Customer Worker bundle sizing #

This records the production pnpm build && wrangler deploy --dry-run measurement for the customer Worker. It distinguishes upload size from isolate-start evaluation: Wrangler currently folds dynamic imports into the one index.js Worker module, so a lazy dependency is still uploaded.

2026-09-12 baseline #

Artifact	Raw bytes	gzip bytes
`dist/server/entry.js` (Octane SSR)	3,697,200	695,920
Wrangler `index.js`	12,733,452	2,513,169

The Octane entry is the largest independent server-side component. Removing it would change direct-navigation and hydration behavior covered by test:app-shell and test:worker, so it is not a lower-complexity sizing seam.

Deferred Bash interpreter evaluation #

The customer Conversation explicitly sets workspaceBash = false; interactive shell work uses the native @cloudflare/sandbox path instead. Before this change, importing Think eagerly loaded @cloudflare/think/dist/tools/workspace.js, which statically loaded just-bash. agents/skills also statically loaded it even though it is needed only by a Skill declaring the Bash runtime.

The package patches retain both APIs and load just-bash only in the two executable Bash paths:

@cloudflare/think createBashTool(...).execute()
agents/skills runBashScript(...)

tests/worker-bundle-boundaries.test.mjs protects the deferred edges and exercises Think's Bash tool. The ordinary conversation and Skill runner tests remain the product-level coverage for the disabled-workspace and native Skill paths.

Wrangler `index.js`	Raw bytes	gzip bytes	Change from baseline
Baseline static imports	12,733,452	2,513,169	—
Deferred interpreter initialization	12,806,695	2,515,213	+73,243 raw / +2,044 gzip

This is intentionally not an upload-size claim. The emitted module now has only two init_browser() calls, each behind the relevant await import("just-bash"); it no longer invokes the interpreter during Worker module evaluation. The small upload increase is Wrangler's inlined dynamic-import wrapper.

Upstream opportunity #

To reduce both upload bytes and startup evaluation, Cloudflare's packages need a compile-time boundary rather than only an internal dynamic import:

Think's root entry imports ./tools/workspace.js, which currently includes every default workspace tool. Publish a non-Bash workspace entrypoint and have a workspaceBash: false Think entry avoid the Bash executor entirely.
Split the agents/skills Bash runner from the metadata/registry entrypoint. Flarebot imports fromManifest, SkillRegistry, and parsing helpers, but not the Bash Skill runtime.
Preserve the existing @cloudflare/sandbox shell and @cloudflare/think APIs. The desired SDK change is an import boundary, not an application replacement or a minification change.

With a Worker bundler that supports separate dynamic modules, the current deferred edges may become an upload saving automatically; remeasure before claiming it.