# Four packages, start roles, and stricter checks

**Version:** v0.39.0

**Published:** November 16, 2026

Workflows 0.39 ships as four packages, and `npx @sanity/workflows-cli codemod packages` moves a project to them. Definitions can say who may start them, and deploy checks definitions more strictly. Every project needs to act, so read [Before you upgrade](https://www.sanity.io/docs/workflows/release-notes) in the release notes before you install.

## Four Workflows packages

`@sanity/workflows`, `@sanity/workflows-ui`, `@sanity/workflows-cli`, and `@sanity/workflows-test` replace the `@sanity/workflow-*` packages. The [codemod](https://www.sanity.io/docs/workflows/cli-reference) rewrites imports and dependencies and renames ten UI exports. See [Move to the four Workflows packages](https://www.sanity.io/docs/workflows/upgrade).

## Start roles

`start: {roles: [...]}` limits who may start a fresh instance. Studio leaves the workflow out of Start for everyone else, unless an unfinished start on the document needs completing. It needs reader model 13. See [Decide who may start an instance](https://www.sanity.io/docs/workflows/definitions-and-instances).

## References into any resource type

An engine created without `resourceClients` reads and writes references into other datasets, Canvases, and dashboards. It derives a client for each one from its own client with `withConfig`, so its token must reach those resources. See [Allowed target resources](https://www.sanity.io/docs/workflows/global-document-references).

## Stricter definition checks

Deploy refuses condition and field reads that always return null. Run `sanity-workflows deploy --check` with the 0.39 CLI before you upgrade. See [Fix condition and field reads that never hold a value](https://www.sanity.io/docs/workflows/upgrade).

## 🐛 Notable bugfixes and improvements

- The generated heartbeat logs one summary line per run. See [Check the result](https://www.sanity.io/docs/workflows/generate-functions).
- `useWorkflowInstances` and `useDocumentWorkflows` take a GROQ filter. See [Instance list hooks](https://www.sanity.io/docs/workflows/ui-components).
- Studio gives object and list fields that declare their sub-fields real inputs, and a disabled action button says why.
- The start dialog submits a single assignee and lets you fill a required list field.

