vercel__workflow/packages/web/CHANGELOG.md

@workflow/web

5.0.0-beta.40

Minor Changes

• #3349 371f06e Thanks @karthikscale3! - The runs table now bulk-cancels selected runs in a single request via bulkCancelRuns, caps a batch at 500 runs, and reports a single outcome-summary toast.

• #3280 de1905f Thanks @VaguelySerious! - Breaking: events.listByCorrelationId and analytics.events.listByCorrelationId now require a runId. A correlation id is unique within its run, not across runs, so an unscoped lookup answered with one event per run that numbered a step or wait the same.

Patch Changes

• Updated dependencies [1222aab, de1905f, e6f1b6f]:
  • @workflow/world-local@5.0.0-beta.34

5.0.0-beta.39

Major Changes

• #3298 d06b55e Thanks @mitul-s! - Rename new-trace-viewer to trace-viewer and the public NewTraceViewer export to TraceViewer.

Patch Changes

• Updated dependencies [31f92df, 2677653, aa78a7e, f05f642]:
  • @workflow/world-local@5.0.0-beta.33

5.0.0-beta.38

Minor Changes

• #2548 25715d4 Thanks @pranaygp! - Add a framework-agnostic @workflow/web/handler export (createWorkflowWebHandler) that serves the observability UI as a single Web Request→Response handler under a configurable base path, plus a @workflow/web/registry for embedded-dashboard discovery.

Patch Changes

• #3197 e181f64 Thanks @mitul-s! - Tighten stream list, chunk viewer, and shared loading skeleton styling to match the trace view.

• Updated dependencies [a09d001]:

  • @workflow/world-local@5.0.0-beta.32

5.0.0-beta.37

Patch Changes

• #3146 e8bc7d6 Thanks @TooTallNate! - Let observability tooling decrypt sealed (encp) payloads: key resolution now yields the run's full key capability, and hydrateDataWithKey dispatches on the envelope format.

• #3061 62d570e Thanks @NathanColosimo! - Check only the combined workflow endpoint in the observability health check.

• Updated dependencies [b4ba79e, 49276f2, 4ada27d, 62d570e]:

  • @workflow/world-local@5.0.0-beta.31

5.0.0-beta.36

Patch Changes

• Updated dependencies [7d29bab, 850777a]:
  • @workflow/world-local@5.0.0-beta.30

5.0.0-beta.35

Patch Changes

• Updated dependencies [f72184d]:
  • @workflow/world-local@5.0.0-beta.29

5.0.0-beta.34

5.0.0-beta.33

Patch Changes

• Updated dependencies []:
  • @workflow/world-local@5.0.0-beta.28

5.0.0-beta.32

5.0.0-beta.31

Patch Changes

• Updated dependencies [7a1ea5a]:
  • @workflow/world-local@5.0.0-beta.27

5.0.0-beta.30

Patch Changes

• #2790 145835b Thanks @NathanColosimo! - Centralize workflow event type classifiers and event-data payload field helpers.

• Updated dependencies [84df8f3, 145835b]:

  • @workflow/world-local@5.0.0-beta.26

5.0.0-beta.29

Patch Changes

• Updated dependencies [79a9813]:
  • @workflow/world-local@5.0.0-beta.25

5.0.0-beta.28

Patch Changes

• #2647 1518c48 Thanks @karthikscale3! - The runs, steps, and events observability list views now read from the metadata-only world.analytics namespace when the configured backend provides one, and fall back to the runtime storage APIs otherwise. Event payloads are still loaded lazily per event on the runtime path. Hooks listing, detail views, payload resolution, streams, and mutations are unchanged.

• #2652 ae51f45 Thanks @karthikscale3! - The hooks list now reads from the metadata-only world.analytics namespace when the backend provides one (falling back to the runtime storage APIs otherwise). A hook's secret token is no longer included in list rows — it is fetched one hook at a time via world.hooks.get only when the user copies the token or resumes the hook.

• #2804 cdfac39 Thanks @karthikscale3! - Fix workflow web for local and postgres backends after static world-target injection. The web server now constructs the local world directly and resolves other world packages from the inspected project, instead of calling the createWorld() static-injection stub (which throws when no build plugin aliased it).

• #2812 fe327e6 Thanks @karthikscale3! - Runs list: infinite scroll with SWR-cached pages (tab switches no longer refetch), a plan-aware time-window picker (default 24h), and status filtering without requiring a workflow filter.

• Updated dependencies [c1d29f1, c1d29f1, 7637196, e7e5a0e, 239031a, 0f557d5, 49a50e8]:

  • @workflow/world-local@5.0.0-beta.24

5.0.0-beta.27

Patch Changes

• #2680 89f4726 Thanks @karthikscale3! - Decompress gzip- and zstd-prefixed serialized data returned from Vercel Workflow storage, and route OSS web hydration through the async WASM-capable path for compressed payloads.

5.0.0-beta.26

5.0.0-beta.25

Patch Changes

• 8393716 - Fix the run trace detail panel flickering its Input/Output sections when navigating between spans. Span detail is now driven by a single selection-derived state machine (useSelectedSpanDetail) whose loading state stays in phase with the selected span, replacing the fetch flag that lagged selection by a few renders.

• #2632 7c1e2a2 Thanks @VaguelySerious! - Fix run and event observability pages hanging (~16s) and showing no data in the bundled server build, caused by HTTP/2 requests failing to reach node:http2.

5.0.0-beta.24

5.0.0-beta.23

5.0.0-beta.22

Patch Changes

• #2582 6855282 Thanks @mitul-s! - Add helper text that indicates keyboard shortcuts

5.0.0-beta.21

5.0.0-beta.20

5.0.0-beta.19

5.0.0-beta.18

5.0.0-beta.17

5.0.0-beta.16

5.0.0-beta.15

5.0.0-beta.14

5.0.0-beta.13

Patch Changes

• #2301 bb6ff9a Thanks @pranaygp! - Update vulnerable package dependencies to patched releases.

5.0.0-beta.12

5.0.0-beta.11

Patch Changes

• #2200 f0f002a Thanks @mitul-s! - Fix new trace viewer getting stuck on the first page: re-wire pagination so it auto-loads pages up to an event cap and scroll-loads the rest for very large runs.

• #2164 0606949 Thanks @mitul-s! - Add a loading skeleton to the new trace viewer that matches the real layout's dimensions, and start with the detail panel closed instead of pre-selecting the first span. The skeleton is also exported as TraceViewerSkeleton for consumers that need to render it standalone.

5.0.0-beta.10

Patch Changes

• #2107 ad5c068 Thanks @karthikscale3! - Allow lookup of exact step ID (step_), wait ID (wait_), hook ID (hook_), or event ID (evnt_) in the event list UI.

5.0.0-beta.9

5.0.0-beta.8

5.0.0-beta.7

5.0.0-beta.6

5.0.0-beta.5

Patch Changes

• #1955 f20c706 Thanks @mitul-s! - Show hook name on trace viewer + no toast on decrypt

• #1815 45d1eb2 Thanks @TooTallNate! - Configure vercelPreset() from @vercel/react-router/vite in react-router.config.ts when building the packages/web project for the Vercel deployment, enabling per-route bundle splitting, function-level configuration, and an accurate Deployment Summary.

  The preset is gated on a new WORKFLOW_WEB_VERCEL_BUILD environment variable (rather than the ambient VERCEL var) so that the standard build layout consumed by server.js (self-hosted deployments and the CLI's in-process server via @workflow/web/server) is still produced when the package is packed as a tarball by the docs Vercel deployment. Set WORKFLOW_WEB_VERCEL_BUILD=1 in the web Vercel project's environment variables to enable the preset there. The existing VERCEL-based checks in vite.config.ts have been migrated to this same variable for consistency.

5.0.0-beta.4

Patch Changes

• #1883 640a050 Thanks @TooTallNate! - Polish the new trace viewer: add detail pane, middle-truncate component, timeline tweaks, and various UI cleanups.

5.0.0-beta.3

Patch Changes

• #1852 9ea1254 Thanks @karthikscale3! - Decode UTF-8 typed array stream chunks in the web stream viewer.

5.0.0-beta.2

Patch Changes

• #1732 c57eeff Thanks @VaguelySerious! - Support standalone deploy to vercel

• #1768 bcf818c Thanks @karthikscale3! - Disable Vite minification so the published build contains readable code, reducing false-positive obfuscation flags from supply chain security scanners (Socket).

• #1716 df115fd Thanks @karthikscale3! - Make encrypted markers clickable to trigger decryption and detect encryption at run level before span selection. Persist features.encryption flag in executionContext at run creation so the UI can detect encryption without a probe fetch.

• #1681 ac09f40 Thanks @TooTallNate! - Add clickable Run reference rendering in observability UI

• #1759 173756d Thanks @TooTallNate! - Rename useworkflow.dev URLs to workflow-sdk.dev

5.0.0-beta.1

Major Changes

• #1293 66d49c0 Thanks @VaguelySerious! - BREAKING CHANGE: Restructure stream methods on World interface to use world.streams.* namespace with runId as the first parameter. writeToStream(name, runId, chunk) → streams.write(runId, name, chunk), writeToStreamMulti → streams.writeMulti, closeStream → streams.close, readFromStream → streams.get(runId, name, startIndex?), listStreamsByRunId → streams.list(runId).

• #1293 66d49c0 Thanks @VaguelySerious! - Require runId argument for world.steps.get.

5.0.0-beta.0

Major Changes

• #1642 c5cdfc0 Thanks @VaguelySerious! - Initial v5 beta release

4.1.0-beta.47

Patch Changes

• #1590 74c4cdb Thanks @VaguelySerious! - Fix server crash on unmatched routes (e.g. /robots.txt, /favicon.ico)

4.1.0-beta.46

Patch Changes

• #1542 c488877 Thanks @karthikscale3! - fix: switch web stream reader from readFromStream to getStreamChunks

4.1.0-beta.45

Patch Changes

• #1492 dab106a Thanks @karthikscale3! - Hide the workflow graph viewer tab

• #1515 bb86b69 Thanks @karthikscale3! - Fix Streams tab crash when decrypting large stream chunks

4.1.0-beta.44

Patch Changes

• #1340 84599b7 Thanks @pranaygp! - Add error code classification (USER_ERROR, RUNTIME_ERROR) to run_failed events, improve queue and schema validation error logging

• #1473 2b80e2d Thanks @karthikscale3! - Fix stream display for streams created before version 4.1.0-beta.56

4.1.0-beta.43

Patch Changes

• #1381 7b9b3c1 Thanks @karthikscale3! - web-shared: Timestamp tooltips, toast adapter, improved skeletons, and encrypted data detection for lazy-loaded events web: Add toast for decryption

• #1364 94c14c7 Thanks @karthikscale3! - Strip only ref/payload fields from eventData when resolveData is 'none', preserving all other metadata

4.1.0-beta.42

Patch Changes

• #1346 73c12f1 Thanks @TooTallNate! - Fix ERR_UNSUPPORTED_ESM_URL_SCHEME on Windows by converting absolute file paths to file:// URLs before passing them to dynamic import()

• #1358 5c6ae60 Thanks @karthikscale3! - Improve workflow observability UX with decoupled pagination, stream virtualization, and decrypt actions

• #1366 d6da7ec Thanks @karthikscale3! - Fix stale encryptionKey closure in events list data hook in web

4.1.0-beta.41

Patch Changes

• #1322 d5bc418 Thanks @VaguelySerious! - Update readme to call out self-hosting limitations

• #1327 d5ae817 Thanks @VaguelySerious! - Improve loading indicators for trace viewer and events list

4.1.0-beta.40

Patch Changes

• #1261 887cc2b Thanks @VaguelySerious! - Refactor trace viewer to build spans entirely from events instead of fetching Steps and Hooks as separate resources.

• #1265 aa2f581 Thanks @TooTallNate! - Add custom entry.server.tsx and move @react-router/node, isbot, react-router, and @react-router/express to devDependencies since the build process bundles them entirely at build time

• #1308 33101a2 Thanks @karthikscale3! - Move decrypt operation to the entity panel inside web-shared and wire it up to web via component callback.

4.1.0-beta.39

Patch Changes

• #1288 5e4ef65 Thanks @VaguelySerious! - Use world.events.get(eventId) instead of listByCorrelationId for loading individual event data in run detail view.

4.1.0-beta.38

Patch Changes

• #1278 1eaff36 Thanks @VaguelySerious! - Ensure data resolution failure does not prevent run from being inspected in UI

• #1277 97932d3 Thanks @TooTallNate! - Fix encrypted stream inspection: move deserialization/decryption client-side, add --decrypt support to CLI

4.1.0-beta.37

Patch Changes

• #1256 bbe40ff Thanks @TooTallNate! - Add encryption-aware o11y for CLI and web UI

4.1.0-beta.36

Patch Changes

• #1217 e55c636 Thanks @pranaygp! - Upgrade dependencies across all packages

4.1.0-beta.35

Patch Changes

• #1182 f0823dc Thanks @karthikscale3! - Fix traceviewer pagination issues

• #1070 a0b99c8 Thanks @alizenhom! - Decompose workflow-api-client.ts into focused modules with unit tests

• #1124 1f9a67c Thanks @kschmelter13! - Replace queue pg-boss-based implementation with graphile-worker

4.1.0-beta.34

Patch Changes

• #999 ea3254e Thanks @TooTallNate! - Separate project ID and project name into distinct env vars (WORKFLOW_VERCEL_PROJECT and WORKFLOW_VERCEL_PROJECT_NAME)

• #1031 1c11573 Thanks @karthikscale3! - Refactor and enhance web-shared observability UI components and update builders base behavior.

• #1039 5213309 Thanks @TooTallNate! - Fix "dev" mode

• #1096 29347b7 Thanks @ctgowrie! - Use new Vercel queue client with v2 message format, simplified callback handling, etc.

4.1.0-beta.33

Patch Changes

• #1005 7653e6b Thanks @TooTallNate! - Migrate @workflow/web from Next.js to React Router v7 framework mode. Replace child process spawning in the CLI with in-process Express server. Switch RPC transport from JSON to CBOR.

• #1015 c56dc38 Thanks @TooTallNate! - Extract browser-safe serialization format from @workflow/core and split o11y hydration by environment. Data hydration now happens client-side in the browser, enabling future e2e encryption support.

• #992 dc2dc6a Thanks @ijjk! - stop esbuild bundling for deferred step route in Next.js

4.1.0-beta.32

Patch Changes

• #927 f090de1 Thanks @karthikscale3! - Added subpatch exports for runtime modules to allow direct imports in core. Refactored web-shared to be a thin package that exported UI components and world-actions. Updated web package to consume the UI components and world-actions from web-shared.

4.1.0-beta.31

Minor Changes

• #621 4966b72 Thanks @pranaygp! - BREAKING: Storage interface is now read-only; all mutations go through events.create()
  • Remove cancel, pause, resume from runs
  • Remove create, update from runs, steps, hooks
  • Add run lifecycle events: run_created, run_started, run_completed, run_failed, run_cancelled
  • Add step_created event type
  • Remove fatal field from step_failed (terminal failure is now implicit)
  • Add step_retrying event with error info for retriable failures

Patch Changes

• #814 b16a682 Thanks @TooTallNate! - Move "parse-name" into the utils package

4.0.1-beta.30

Patch Changes

• #816 5ba82ec Thanks @TooTallNate! - Add button to run queue based health checks

4.0.1-beta.29

Patch Changes

• #806 d30e5c0 Thanks @VaguelySerious! - [web] Add view to display a list of all events

• #808 ee7b1fd Thanks @karthikscale3! - Fix layout shift when empty run or hook tables auto-refreshes in local environment

4.0.1-beta.28

Patch Changes

• #774 abdca8f Thanks @VaguelySerious! - Improve display of configuration information. Fix opening of Vercel backend when using --localUi. Fix world caching in multi-tenant environments. Fix flicker in run table when refreshing. Improve contributor experience by adding --observabilityCwd flag to easily iterate on web UI from another directory. Polish navbar UI.

4.0.1-beta.27

Patch Changes

• #737 adb9312 Thanks @VaguelySerious! - Tidy up wake-up and re-enqueue controls

4.0.1-beta.26

Patch Changes

• #747 3fb57e1 Thanks @pranaygp! - Use env variables instead of query params for world config (like WORKFLOW_TARGET_WORLD)

  BREAKING CHANGE: The OSS web UI is now locked to a single world and will not let you change world using query params

4.0.1-beta.25

Patch Changes

• #751 dd3db13 Thanks @VaguelySerious! - Remove the unused paused/resumed run events and states
  • Remove run_paused and run_resumed event types
  • Remove paused status from WorkflowRunStatus
  • Remove PauseWorkflowRunParams and ResumeWorkflowRunParams types
  • Remove pauseWorkflowRun and resumeWorkflowRun functions from world-vercel

4.0.1-beta.24

Patch Changes

• #716 0da8e54 Thanks @VaguelySerious! - Allow selecting and cancelling multiple runs from table view

• #717 8bc4e5f Thanks @VaguelySerious! - Refresh run table on stale re-focus

4.0.1-beta.23

Patch Changes

• #703 9b1640d Thanks @TooTallNate! - Use pluralize() util function

4.0.1-beta.22

Patch Changes

• #694 f989613 Thanks @VaguelySerious! - Add error boundaries around tabs in run detail view

4.0.1-beta.21

Patch Changes

• #455 e3f0390 Thanks @karthikscale3! - Added Control Flow Graph extraction from Workflows and extended manifest.json's schema to incorporate the graph structure into it. Refactored manifest generation to pass manifest as a parameter instead of using instance state. Add e2e tests for manifest validation across all builders.

4.0.1-beta.20

Patch Changes

• #674 4bc98ff Thanks @VaguelySerious! - Move ErrorBoundary component from web to web-shared and use in sidebar detail view.

4.0.1-beta.19

Patch Changes

• #656 ef22f82 Thanks @VaguelySerious! - Allow resuming hooks with payloads from the UI

4.0.1-beta.18

Patch Changes

• #646 f396833 Thanks @adriandlam! - Fix missing next.config.ts inside built @workflow/web package

4.0.1-beta.17

Patch Changes

• #582 05ea678 Thanks @VaguelySerious! - Add buttons to wake up workflow from sleep or scheduling issues

4.0.1-beta.16

Patch Changes

• #604 6265534 Thanks @VaguelySerious! - Bump next.js to address CVE-2025-55184

4.0.1-beta.15

Patch Changes

• #575 161c54c Thanks @VaguelySerious! - Add Web and CLI UI for listing and viewing streams

• #572 33c254c Thanks @VaguelySerious! - Refactor error handling to surface more error details and reduce code

• #562 058757c Thanks @VaguelySerious! - Unify time helper functions

4.0.1-beta.14

Patch Changes

• 14daedd: Refine span viewer panel UI: reduced font sizes and spacing, added connecting lines in detail cards, improved attribute layout with bordered containers. Improve status badge with colored indicators and optional duration, add overlay mode to copyable text, simplify stream detail back navigation
• 4aecb99: Add workflow graph visualization to observability UI and o11y migration to nuqs for url state management
• 24e6271: UI polish: inline durations, font fixes, trace viewer scrolling fix
• 8172455: Show expiredAt date in trace viewer, add tooltip

4.0.1-beta.13

Patch Changes

• ca27c0f: Update to latest Next.js

4.0.1-beta.12

Patch Changes

• 109fe59: Add PostgreSQL backend support in web UI settings
• 10c5b91: Update Next.js version to 16
• 8d4562e: Rename leftover references to "embedded world" to be "local world"

4.0.1-beta.11

Patch Changes

• b97b6bf: Lock all dependencies in our packages

4.0.1-beta.10

Patch Changes

• 11469d8: Update default fallback path for connecting to local world
• 00efdfb: Improve trace viewer load times and loading animation

4.0.1-beta.9

Patch Changes

• 0b3e89e: Fix event data serialization for observability

4.0.1-beta.8

Patch Changes

• 7db9e94: Fix hook events not displaying on trace viewer if there's multiple hook_received events

4.0.1-beta.7

Patch Changes

• 2ae7426: Clean up loading animation on trace viewer
• f973954: Update license to Apache 2.0
• 2ae7426: Export react-jsx transpiled code, not raw jsx

4.0.1-beta.6

Patch Changes

• 8f63385: Add readme section about self-hosting observability UI
• 20d51f0: Add optional retryAfter property to Step interface
• 55e2d0b: Extract reusable web UI code into shared package

4.0.1-beta.5

Patch Changes

• 0f845af: Alias workflow web to workflow inspect runs --web, hide trace viewer search for small runs
• ffb7af3: Web: make error handling local/inline to where it's used, unify API error responses

4.0.1-beta.4

Patch Changes

• dbf2207: Web: refactor active/hover styles from trace viewer to avoid color conflicts
• eadf588: Add button to re-run workflows

4.0.1-beta.3

Patch Changes

• 731adff: Fix run data not updating live on run detail view
• 22917ab: Web: fix resource detail sidebar briefly showing old data when updating selection
• 66225bf: Web: Allow filtering by workflow name and status on the runs list view
• 9ba86ce: Web: fix links to docs

4.0.1-beta.2

Patch Changes

• f5f171f: Refactor trace-viewer API, fix visibility of tiny traces

4.0.1-beta.1

Patch Changes

• e46294f: Add "license" and "repository" fields to package.json file

4.0.1-beta.0

Patch Changes

• fcf63d0: Initial publish