Change8

wrangler@4.106.0

📦 cloudflare-workersView on GitHub →
8 features🐛 3 fixes🔧 22 symbols

Summary

This release introduces significant enhancements to the Wrangler CLI, including management commands for AI Search indexing jobs and a new authentication profile system for managing multiple Cloudflare accounts. Testing utilities have also been expanded with D1 migration application and Workflow introspection capabilities.

Migration Steps

  1. If using `wrangler versions upload` and encountering configuration conflicts in CI/non-interactive environments, consider adding the `--strict` flag to enforce abortion on conflicts.
  2. When using `createTestHarness()`, D1 migrations can now be applied before requests using `worker.applyD1Migrations("DATABASE")`.

✨ New Features

  • Added `wrangler ai-search jobs` commands for managing AI Search indexing jobs (list, trigger, inspect, cancel, logs).
  • Added `--source-jurisdiction` flag to `wrangler ai-search create` for R2-backed instances to specify the jurisdiction of the source bucket.
  • Introduced Auth profiles via new `wrangler auth` commands (`create`, `delete`, `activate`, `deactivate`, `list`) to manage multiple OAuth logins and bind them to directories, accessible via a global `--profile` flag.
  • Improved pre-upload safety checks for `wrangler versions upload`, mirroring `wrangler deploy` checks regarding dashboard edits, secret conflicts, and workflow deployment mismatches.
  • Added `--strict` flag to `wrangler versions upload` to abort on configuration conflicts in non-interactive environments.
  • Added D1 migration setup capability to `createTestHarness()` Worker handles using `worker.applyD1Migrations("DATABASE")` before running requests.
  • Added Workflow introspection capabilities to `createTestHarness()` Worker handles, allowing tests to modify workflows (e.g., disable sleeps) and wait for instance outcomes.
  • Added `bindingOverrides` and `getExport()` to `createTestHarness()` for replacing platform bindings with other Workers defined within the same test harness setup.

🐛 Bug Fixes

  • Improved `wrangler tail` resilience: errors now flow through wrangler's standard error pipeline instead of escaping as uncaught exceptions.
  • The keep-alive timeout message in `wrangler tail` is clearer and no longer prints a stack trace.
  • When the tail connection drops unexpectedly, `wrangler tail` now automatically tries to reconnect with exponential backoff.

Affected Symbols