agents@0.14.5

cloudflare/agentsagents@0.14.5Jun 7, 2026by github-actions[bot]

AI Summary

Combines the introduction of the Think framework with a significant performance update that removes the in-Worker bundler, dropping approximately 14MB of `esbuild-wasm` from Worker bundles.

Key Highlights

  • Removes in-Worker bundler to reduce Worker bundle size by ~14MB
  • Skills are now compiled ahead of time using esbuild
  • New `compileSkillScript` helper for publishing skills to R2
  • Introduction of the Think framework layer

Breaking Changes

  • Skills served from R2 relying on the in-Worker bundler must now be compiled ahead of time using the new helper
  • The previously-added `stubWorkerBundler` option has been removed

New Features

  • Ahead-of-time skill compilation
  • Think framework integration
  • Reduced bundle size

Full Release Notes

### Patch Changes

-   [#1613](https://github.com/cloudflare/agents/pull/1613) [`124a47a`](https://github.com/cloudflare/agents/commit/124a47a91c8a9db0bcf08ab931a5dd99a2fac663) Thanks [@threepointone](https://github.com/threepointone)! - Introduce the first Think framework layer for convention-driven agent apps.

    This release adds a manifest-driven Vite plugin that discovers agents from the
    `agents/` directory, generates a Worker entrypoint and virtual framework
    modules, derives stable Durable Object class names, and merges framework-owned
    Worker config defaults with user Wrangler config. It also keeps the Think Vite
    plugin usable directly in normal Vite plugin arrays.

    The framework now supports optional app server entries, manifest-scoped friendly
    agent and sub-agent routing, deterministic route surfaces, colocated skill
    detection, Worker Loader requirement diagnostics, and explicit diagnostics for
    unsupported nested sub-agent conventions. Think currently supports top-level
    agents and one sub-agent layer; deeper nesting is rejected with guidance so that
    the routing and lifecycle model can be designed deliberately.

    This framework layer is experimental: both the Vite plugin (once, on build
    start) and the `think` CLI (on startup) emit a notice that the API may change
    or be removed in any release. The core Think agent runtime is unchanged.

    The Think CLI now includes `think init`, `think inspect`, and `think types`.
    `think init` scaffolds a minimal Workers/Vite Think app, safely handles prompted
    or named target directories, refuses unsafe migrations, and installs npm
    dependencies by default. `think inspect` exposes manifest/config diagnostics in
    text or JSON, while `think types` generates Think-owned declarations and can
    optionally compose with Wrangler type generation.

    This release also adds host-framework coverage for React Router and TanStack
    Start, updates examples to use the convention-first framework shape, and hardens
    Agents/worker-bundler virtual modules for bundled skill compatibility.

-   [#1613](https://github.com/cloudflare/agents/pull/1613) [`124a47a`](https://github.com/cloudflare/agents/commit/124a47a91c8a9db0bcf08ab931a5dd99a2fac663) Thanks [@threepointone](https://github.com/threepointone)! - Compile skill scripts ahead of time and remove the in-Worker bundler (drops ~14MB of `esbuild-wasm` from Worker bundles).

    Skill scripts are now always compiled to self-contained JavaScript before they run, and the runtime no longer ships an in-Worker bundler (`@cloudflare/worker-bundler` is no longer a dependency of `agents`):

    -   The Agents Vite plugin compiles bundled skill scripts (`scripts/*.ts`/`.tsx`/`.js`/`.mjs`) with esbuild at build time — resolving sibling imports and stripping TypeScript — and marks them `precompiled`.
    -   Skills served from R2 or other dynamic sources must be compiled before upload. A new `compileSkillScript` helper is exported from `agents/skills/compile` for use in your publish/upload tooling.
    -   At runtime, a skill script that still needs compiling (raw TypeScript or a multi-file skill that wasn't bundled) throws a clear "must be compiled to a self-contained JavaScript module" error instead of silently bundling in-Worker.

    **Breaking:** if you ship raw TypeScript or multi-file skill scripts to R2 (or another dynamic source) and relied on the in-Worker bundler to compile them at runtime, bundle them ahead of time (e.g. with `compileSkillScript`) before upload. Bundled skills handled by the Vite plugin require no changes. The previously-added `stubWorkerBundler` option has been removed (there is nothing left to stub).