[workflows] add individual and batch instance deletion

[vaishnav-mk]

Adds individual and batch Workflow instance deletion to the runtime and SDK.

• env.MY_WORKFLOW.get(id).delete() deletes one instance.
• env.MY_WORKFLOW.deleteBatch(instanceIds) returns { deleted, errors } with per-instance results.
• wrangler workflows instances delete <name> [id..] deletes one or up to 100 instances remotely or in local development; IDs can also come from a JSON array passed with --filename.
• Missing batch targets are returned as errors; duplicate IDs are processed once.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s): Workflows: document individual and batch instance deletion cloudflare-docs#32128
  • Documentation not necessary because:

A picture of a cute animal (not mandatory, but encouraged)
(i want a cat like this :))

[changeset-bot]

🦋 Changeset detected

Latest commit: 94f1156

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages

Name	Type
wrangler	Minor
miniflare	Minor
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-pool-workers	Patch
@cloudflare/deploy-helpers	Patch
@cloudflare/pages-shared	Patch
@cloudflare/remote-bindings	Patch
@cloudflare/runtime-types	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

✅ All changesets look good

[ask-bonk]

I notice a real inconsistency worth flagging. The remote deleteInstance in utils.ts does NOT encodeURIComponent the workflowName or instanceId, while the local variant and other newer remote helpers do. Actually the remote ones (describe line 84, send-event line 79) also don't encode. So it's consistent with the existing remote convention. Not a new bug.

The implementation is consistent, well-tested, and follows established patterns for all sibling commands. The local DELETE route pre-exists in the explorer worker. The engine/binding changes mirror the terminate pattern correctly.

I've reviewed all changed files, the engine abort semantics, the binding pattern, the local-explorer route (pre-existing), CLI wiring, and tests. No actionable logic bugs, security issues, backward-compat violations, or incorrect API behavior found.

LGTM

github run

[pkg-pr-new]

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@14735

@cloudflare/build-output-utils

npm i https://pkg.pr.new/@cloudflare/build-output-utils@14735

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@14735

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@14735

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@14735

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@14735

miniflare

npm i https://pkg.pr.new/miniflare@14735

@cloudflare/pages-functions

npm i https://pkg.pr.new/@cloudflare/pages-functions@14735

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@14735

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@14735

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@14735

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@14735

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@14735

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@14735

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@14735

wrangler

npm i https://pkg.pr.new/wrangler@14735

commit: 94f1156

[workers-devprod]

Codeowners approval required for this PR:

• @cloudflare/workflows
• @cloudflare/wrangler

Show detailed file reviewers

• .changeset/workflows-instances-delete.md: [@cloudflare/wrangler]
• packages/miniflare/src/workers/workflows/wrapped-binding.worker.ts: [@cloudflare/wrangler]
• packages/miniflare/test/plugins/workflows/index.spec.ts: [@cloudflare/wrangler]
• packages/workflows-shared/src/binding.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/engine.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/lib/errors.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/types.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/tests/binding.test.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/wrangler/src/tests/workflows.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/index.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/commands/instances/delete.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/local.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/utils.ts: [@cloudflare/wrangler]

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[workers-devprod]

Codeowners approval required for this PR:

• @cloudflare/workflows
• @cloudflare/wrangler

Show detailed file reviewers

• .changeset/workflows-instances-delete.md: [@cloudflare/wrangler]
• packages/miniflare/scripts/openapi-filter-config.ts: [@cloudflare/wrangler]
• packages/miniflare/src/index.ts: [@cloudflare/wrangler]
• packages/miniflare/src/plugins/workflows/index.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/explorer.worker.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/generated/index.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/generated/types.gen.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/generated/zod.gen.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/openapi.local.json: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/resources/workflows.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/local-explorer/route-names.ts: [@cloudflare/wrangler]
• packages/miniflare/src/workers/workflows/wrapped-binding.worker.ts: [@cloudflare/wrangler]
• packages/miniflare/test/plugins/workflows/index.spec.ts: [@cloudflare/wrangler]
• packages/miniflare/test/plugins/workflows/wrapped-binding.spec.ts: [@cloudflare/wrangler]
• packages/miniflare/vitest.config.mts: [@cloudflare/wrangler]
• packages/workflows-shared/src/binding.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/engine.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/lib/errors.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/src/types.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/workflows-shared/tests/binding.test.ts: [@cloudflare/workflows @cloudflare/wrangler]
• packages/wrangler/src/tests/workflows.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/index.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/commands/instances/delete.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/local.ts: [@cloudflare/wrangler]
• packages/wrangler/src/workflows/utils.ts: [@cloudflare/wrangler]

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 5 additional findings in Devin Review.