Rui Figueira

This commit introduces **experimental headful browser rendering support** across **Miniflare**, **Wrangler**, and the **Vite plugin**, enabling developers to launch a visible browser instance during local development. This **new capability** allows for enhanced debugging of Workers that interact with browser APIs by setting the `X_BROWSER_HEADFUL` environment variable. The **Miniflare** browser rendering plugin now conditionally applies headless arguments based on this option, which is integrated into both **Wrangler** and the **Vite plugin**'s Miniflare configurations. This significantly improves the developer experience for visually debugging browser-based Worker interactions.

This commit significantly **expands Miniflare's browser rendering capabilities** by introducing a comprehensive suite of new API endpoints. It **refactors browser session handling** into a Durable Object within `binding.worker.ts`, exposing new APIs for **devtools, history, and limits**. Specifically, this **feature addition** implements standard Chrome DevTools Protocol endpoints like `jsonVersion` and `jsonNew`, alongside session management APIs such as `acquireSession` and `closeSession`. This provides users with more granular control and introspection for browser sessions, complemented by a new top-level endpoint to close sessions by ID.

This commit performs a **dependency upgrade** for **Miniflare's browser rendering subsystem**, bumping the embedded Chrome version to `126.0.6478.182`. This update ensures users benefit from the latest browser features and security patches. Concurrently, it **enhances WebSocket close event handling** within the browser rendering worker by introducing a `forwardClose` helper and refining `checkStatus` logic, ensuring proper reciprocation of close events. This **maintenance and enhancement** work improves the overall stability and currency of browser rendering capabilities, particularly for applications relying on robust WebSocket interactions.

This commit **updates the documentation** for the `Stagehand` platform, specifically addressing compatibility and dependency requirements. It adds a crucial note regarding **Zod v3 compatibility** and explicitly lists the necessary dependencies within `package.json` for `Stagehand`'s proper functioning. This **documentation enhancement** ensures users are aware of specific version requirements, preventing potential integration issues and improving the setup experience. The change primarily affects the `src/content/docs/browser-rendering/platform/stagehand.mdx` file, enhancing the clarity and accuracy of the platform's setup instructions.

This commit **enhances the documentation** for **Playwright integration** with **Cloudflare Workers** by adding a comprehensive example for **storage state persistence**. It introduces a new section in `playwright.mdx` detailing how to configure `wrangler.toml` and set up **Workers KV** to manage Playwright's storage state. This **documentation enhancement** also includes important notes about mandatory compatibility flags required for using the latest Playwright versions, improving the guide's accuracy and utility for developers building browser rendering applications.

This commit introduces a new capability to the `miniflare` package, enabling local browser rendering through a new `/v1/session` endpoint. This expands `miniflare`'s functionality for developers needing to test or develop applications that rely on browser rendering locally.

This change significantly improves the reliability of browser provisioning for `miniflare`'s browser-rendering features, preventing installation failures for `wrangler dev` users. It ensures a more robust and consistent developer experience by explicitly managing browser installation.

This commit introduces a new capability to the `miniflare` package, enabling local browser rendering sessions via a `/v1/session` endpoint. This new feature allows for browser-based testing and development within the `miniflare` environment, with an internal fix to ensure proper websocket closure.

Add @cloudflare/plywright support for Browser Rendering local mode

This commit fixes a critical issue in Miniflare's browser rendering functionality, ensuring Playwright connections properly close in local development environments. Additionally, it introduces a new capability for browser session reuse, significantly improving performance and resource management for browser rendering workloads.

This commit **introduces type-safe serializable RPC methods** within the **`packages/agents`** module, ensuring that all parameters and return values for remote procedure calls are strictly serializable or promises of serializable types. This **refactoring** significantly **improves developer experience** by providing compile-time validation, preventing common runtime errors related to non-serializable data. Specifically, it updates the `call` method in `client.ts` and the `useAgent` hook in `react.tsx`, backed by new type definitions in `serializable.ts` and extensive type-checking tests. The change enhances the robustness of RPC interactions and includes a minor **maintenance** task to consolidate type-checking scripts.

This commit **refactors and improves the type definitions for agents** within the **`packages/agents`** module, specifically impacting its **React component integration**. The changes enhance the robustness and clarity of agent-related types, ensuring better type checking for developers. Extensive updates to various type definition tests, including those for `useAgent` hooks and stubs, validate the correctness of these improvements. This **type improvement** provides a more reliable and predictable typing experience for users of the `agents` package.

This commit **refactors** the **`AgentStub` type** within the **`agents` package** to improve its definition and usage. It specifically ensures that base `Agent` methods are excluded from the stub, simplifying the type and its interaction with the `useAgent` hook. This **type improvement** enhances clarity and correctness for agent definitions. New and updated tests for both typed and untyped `AgentStub` usage have been added to validate these changes, ensuring the robustness of agent type definitions.

This commit introduces a **new capability** for **Agent RPC stubbing** within the `packages/agents` module. It extends the `useAgent` hook to provide an `AgentStub` type via a new `stub` property, which acts as a proxy for remote procedure calls. This allows developers to **simulate and test agent interactions** more effectively, improving development and testing workflows. Type definition tests are also included to ensure the correctness and type safety of this new functionality.

This commit **fixes a type inference bug** within the **`agents` package**, specifically addressing an issue where **TypeScript incorrectly handled method signatures** containing non-optional parameters after optional or `undefined` ones. It **refactors key type definitions** such as `AllOptional`, `Method`, `Methods`, and `OptionalParametersMethod` in `packages/agents/src/react.tsx` to ensure correct parameter handling. New test cases (`f7`, `f8`) have been added to `packages/agents/src/tests-d/typed-use-agent.test-d.ts` to **validate the improved type correctness**. This **bug fix** enhances the reliability of type checking for users interacting with agent methods in React components, ensuring more accurate and predictable type inference for complex method signatures.

This commit introduces **comprehensive type support** for the `useAgent().call` method within the **`@cloudflare/agents` React hook**, significantly enhancing developer experience with improved type safety and autocompletion. This **new capability** involves adding detailed type overloads and dedicated type definition tests to ensure both forward-looking correctness and **backward compatibility** for existing untyped usages. Additionally, it includes minor **refactoring** by removing `biome-ignore` comments in examples and guides, and a **bug fix** for a `wrangler.toml` path issue in the `agents` package's testing setup, resolving a file loading error on Windows.

This commit implements a **bug fix** to prevent a `TypeError` within the **recorder module**, specifically affecting the generation of key press events for **codegen**. A type check has been added to the `_shouldGenerateKeyPressFor` function in `packages/injected/src/recorder/recorder.ts` to ensure `event.key` is a string. This change addresses issues where IME (Input Method Editor) or autofill inputs could cause `event.key` to be an unexpected type, leading to runtime errors. The fix enhances the robustness of keyboard event recording, ensuring more reliable input capture for subsequent code generation.

This commit introduces a **new feature** to the **`McpAgent`** within the `packages/agents` module, enabling it to support its `server` property as a `Promise`. This modification allows for **asynchronous server initialization**, improving the flexibility and robustness of how `McpAgent` connects to its server. Specifically, methods like `connect` and `fetch` in `packages/agents/src/mcp/index.ts` are updated to correctly handle the asynchronous resolution of the server. This enhancement facilitates more dynamic and resilient server setups for the agent.

This commit significantly **improves the Playwright code examples** found within the **browser-rendering documentation** and changelog. It updates type definitions, such as replacing `Fetcher` with `BrowserWorker`, and simplifies the initialization of `TODO_ITEMS` for better clarity and correctness across `playwright.mdx` and the changelog entry. Furthermore, the tracing example in `playwright.mdx` has been refactored to consistently start tracing and return the trace file, providing a more robust demonstration. This **documentation improvement** ensures that users referencing the Playwright guides will find more accurate and up-to-date code snippets.

This commit introduces a **new feature** to the **Playwright Codegen** module, enhancing its **JSONL output format** by including detailed frame context. Specifically, the `generateAction` method in `packages/playwright-core/src/server/codegen/jsonl.ts` now incorporates the `framePath` for each recorded action. This provides richer information about the origin of user interactions, improving the utility of the JSONL output for advanced automation and debugging. New tests in `tests/library/inspector/cli-codegen-3.spec.ts` have been added to verify the accurate inclusion of `framePath` and `pageAlias` in the generated data.