docs: expand Python workflow guide

[fantix]

Summary

• install the standalone vercel-workflow package in the Python guide
• document starting workflows and inspecting Run handles
• add a minimal workflow streaming example
• fix Python code-line highlighting with the current Shiki notation

Testing

• git diff --check
• pnpm --dir docs build

Docs Preview

Version	Preview
v5	Python guide
v4	Python guide

[changeset-bot]

🦋 Changeset detected

Latest commit: adb20bb

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

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

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

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
example-nextjs-workflow-turbopack	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
example-nextjs-workflow-webpack	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
example-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-astro-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-express-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-fastify-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-hono-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-nestjs-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-nitro-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-nuxt-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-python-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-sveltekit-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-tanstack-start-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workbench-vite-workflow	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workflow-docs	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workflow-swc-playground	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workflow-tarballs	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC
workflow-web	Ready	Preview, v0	Sep 1, 2026 5:20pm UTC

[github-actions]

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 41 total

fence=per-spec

scenario	outcome	events	virt	replay	violations
✅ smoke-no-steps	completed	3	0ms	ok	0
✅ smoke-one-step	completed	6	0ms	ok	0
✅ hook-at-step-started	completed	12	0ms	ok	0
✅ hook-at-step-completed	completed	12	0ms	ok	0
✅ hook-at-hook-created	completed	12	0ms	ok	0
✅ deadline-hook-wins	completed	7	1.0h	ok	0
✅ deadline-expires	completed	7	1.0h	ok	0
✅ long-sleep	completed	11	30.0d	ok	0
✅ hook-never-arrives	stalled	3	0ms	skipped	0
✅ step-retries-twice	completed	10	2.0s	ok	0
✅ parallel-steps	completed	9	0ms	ok	0
✅ hook-on-execution-state	completed	12	0ms	ok	0
✅ peek-hook-before-branch	completed	12	0ms	ok	0
✅ peek-hook-after-branch	completed	12	0ms	ok	0
✅ peek-hook-at-registration	completed	12	0ms	ok	0
✅ race-hook-before-probe	completed	12	0ms	ok	0
✅ race-hook-after-probe	completed	12	0ms	ok	0
✅ race-duplicate-delivery	completed	13	0ms	ok	0
✅ attr-hook-before-step	completed	11	0ms	ok	0
✅ attr-hook-after-step	completed	11	0ms	ok	0
✅ attr-from-step-body	completed	13	0ms	ok	0
✅ fork-hook-after-timeout	completed	14	1.0m	ok	0
✅ fork-hook-before-timeout	completed	14	1.0m	ok	0
✅ count-hook-after-timeout	completed	17	1.0m	ok	0
✅ count-hook-before-timeout	completed	20	1.0m	ok	0
✅ stale-read-step-count-fork	completed	20	1.0m	ok	0
✅ stale-read-equal-step-counts	completed	14	1.0m	ok	0
✅ step-vs-step-fork	completed	12	0ms	ok	0
✅ step-vs-step-fork-fenced	completed	12	0ms	ok	0
✅ fence-catches-benign-direction	completed	12	5ms	ok	0
✅ in-flight-before-decision	completed	17	1.0m	ok	0
❌ in-flight-before-decision-counted	completed	17	1.0m	ok	0
✅ in-flight-after-decision	completed	19	2.0m	ok	0
✅ stale-read-step-count-fork-fenced	completed	20	1.0m	ok	0
✅ fork-hook-wins	completed	13	1.0m	ok	0
✅ fork-timeout-wins	completed	13	1.0m	ok	0
✅ unclaimed-payload-under-fork	completed	17	1.0m	ok	0
✅ claimed-payload-under-fork	completed	17	1.0m	ok	0
✅ writers-independent-step-bodies	completed	12	0ms	ok	0
✅ writers-scripted-tempo	completed	12	0ms	ok	0
✅ cancel-mid-step	cancelled	7	0ms	skipped	0

Full trace: world-sim.txt

[github-actions]

No backport to stable for aba7c8d (AI decision).

The commit is primarily a docs expansion — it adds new "Starting a workflow" and "Streaming" sections documenting additional Python SDK capabilities, which is documentation of new capabilities rather than a correction. It also does not apply to stable: verified with git ls-tree origin/stable that neither docs/content/docs/v4/getting-started/python.mdx nor the v5 path exists there (stable has no Python guide at all, and no versioned getting-started trees). The genuine corrections bundled in (the vercel → vercel-workflow package name and the Shiki highlight notation) have no target on stable.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

aba7c8d5d0df39ae857219d5f1802711aeaa6a1a