@cloudflare/shell@0.4.0

cloudflare/agents@cloudflare/shell@0.4.0Jun 12, 2026by github-actions[bot]

AI Summary

Adds a `StateConnector` to the shell package, exposing the filesystem API as a codemode connector with object-style arguments and optimized replay behavior.

Key Highlights

New `StateConnector` class for codemode integration.
Object-style argument support (`state.writeFile({ path, content })`).
Pure reads marked `replay: 'reexecute'` to avoid storing large content in logs.
Updated type declarations and system prompts to match object-argument convention.

New Features

StateConnector implementation for durable tooling.
Object-argument convention adoption for state tools.

Full Release Notes

### Minor Changes

-   [#1656](https://github.com/cloudflare/agents/pull/1656) [`4c2d1a7`](https://github.com/cloudflare/agents/commit/4c2d1a7f7f337bf426b0b35e3c9e8e4901c6360b) Thanks [@cjol](https://github.com/cjol)! - Add `StateConnector` — the `state.*` filesystem API as a codemode connector.

    `stateConnector(ctx, backend)` (or `new StateConnector(ctx, backend)`) exposes every `StateBackend` method (`readFile`, `writeFile`, `editFile`, `ls`, `find`, `grep`, `readJson`, `mergeJson`, …) as connector tools for `@cloudflare/codemode`'s durable runtime. Tools take a single object argument (`state.writeFile({ path, content })`), which the connector maps to the backend's positional parameters; pure reads are marked `replay: "reexecute"` so large file contents are never stored in the durable log. The legacy provider path (`createStateToolProvider`/`stateTools`) is unchanged and also accepts object-style arguments now, and the `state.*` type declarations and system prompt were updated to the object-argument convention.

### Patch Changes

-   Updated dependencies \[[`b2b6762`](https://github.com/cloudflare/agents/commit/b2b67623deab327042b99344d8ee530ae37a71b2), [`4c2d1a7`](https://github.com/cloudflare/agents/commit/4c2d1a7f7f337bf426b0b35e3c9e8e4901c6360b), [`4c2d1a7`](https://github.com/cloudflare/agents/commit/4c2d1a7f7f337bf426b0b35e3c9e8e4901c6360b)]:
    -   @cloudflare/codemode@0.4.0