Karthik Kalyan

This commit **refactors** the **web package's stream reading mechanism** to use a more efficient, **cursor-based polling system** for **workflow streams**. Specifically, the **`useStreamReader` hook** and the **`api.stream.$streamId` route** are updated to leverage a new `readStreamChunksServerAction`, enabling incremental data fetching and real-time updates for the **streams tab** in the **run detail view**. This **enhancement** improves the responsiveness and performance of displaying **workflow stream data**, ensuring users see the latest output without full reloads, and also introduces a **decrypt button** for stream content.

This commit **resolves a critical crash** within the **web application's Streams tab** that previously occurred when decrypting and displaying large stream chunks. It implements **data sanitization** and **main thread yielding** within the `useStreamReader` hook, specifically using `sanitizeForDisplay` and `yieldToMain`, to prevent the UI from becoming unresponsive or crashing. This **bug fix** and **performance optimization** significantly enhances the stability and reliability of the **Streams tab** when handling substantial data volumes.

This commit **hides the workflow graph viewer tab** within the **web application's `RunDetailView` component**. It implements this **UI adjustment** by forcing the `trace` tab to be active whenever the `graph` tab is requested, and by conditionally preventing the rendering of the graph tab's UI elements. This change effectively **disables the workflow graph viewer** for web users, streamlining the interface by removing an unneeded or incomplete feature from the run detail page.

This commit delivers a **bug fix** to enhance the **timeline duration format and precision** within the **`web-shared`** package. It **removes millisecond precision** from the `formatWallClockTime` function in `packages/web-shared/src/components/trace-viewer/util/timing.ts`, leading to cleaner wall clock time displays in the **trace viewer**. Concurrently, the `formatDuration` utility in `packages/web-shared/src/lib/utils.ts` is adjusted to present more compact, multi-unit durations (e.g., '8m 20s') by utilizing floor division. This ensures improved readability and accuracy for time-related displays, particularly impacting the **trace viewer's timeline**.

This commit introduces a **compatibility fix** to the **web package's** `useStreamReader` hook, enabling it to correctly parse **legacy newline-delimited stream formats**. This **bug fix** ensures that the **stream tab** accurately displays data from older or **legacy runs** by implementing robust encoding detection and parsing logic within `useStreamReader`. The change primarily affects the `packages/web/app/lib/hooks/use-stream-reader.ts` file, resolving display issues for previously incompatible stream data and improving the overall reliability of stream visualization for historical data.

This commit provides a **bug fix** to prevent unnecessary re-renders and visual flickering within the **detail panel** of the web application, especially for encrypted runs during polling. The **attribute panel** (`attribute-panel.tsx`) is updated to avoid re-rendering when input/output data is loading but has no display content. Concurrently, the **data fetching logic** in `use-resource-data.ts` is refined to only clear existing data when the selected resource genuinely changes, eliminating flicker during re-fetches for the same resource. This improves the stability and user experience of the **web UI** when displaying resource details.

This commit delivers significant **UX improvements and stability fixes** across the **web-shared detail panels**, particularly impacting the `AttributePanel`, `EntityDetailPanel`, and `EventsList`. It introduces **loading skeletons** for attribute blocks and event lists, providing clearer visual feedback during data fetching, and standardizes error messages with a reusable `ErrorCard`. Key **bug fixes** prevent unnecessary re-renders in the `EntityDetailPanel` by stabilizing callbacks during polling and optimize `SelectionBridge` in `workflow-trace-view` to avoid redundant selection change notifications. These enhancements collectively provide a **more stable, responsive, and visually consistent user interface** when interacting with detailed entity information.

This commit introduces a **new feature** to track Vercel request IDs (`x-vercel-id`) across workflow events, significantly **improving log correlation** for applications deployed on Vercel. It modifies the **`@world/core` runtime** to extract and propagate the `requestId` through workflow entrypoints, step handlers, and suspension handlers. The **`@world-vercel` package** is updated to capture the `x-vercel-id` header from incoming requests and include it in workflow run events, while **`@world/world`** event and queue interfaces are extended to support this new identifier. This enhancement allows for easier debugging and tracing of specific Vercel requests through the entire workflow execution by linking logs to their originating request.

This commit introduces a **bug fix** to the **`web-shared` package**, specifically addressing the **trace viewer's construction of step spans for V1 workflow events**. The `stepEventsToStepEntity` function within `trace-span-construction.ts` has been updated to correctly process V1 events by **falling back to the earliest available event** when a `step_created` event is missing. This ensures that **older V1 workflow runs are accurately visualized** in the trace viewer, providing a more reliable representation of historical execution traces. New test cases have also been added to validate this corrected behavior.

This commit **fixes** an issue within the **`web-shared` package's Trace Viewer component** where **run span segments were incorrectly computed for V1 events**. The core logic in `packages/web-shared/src/components/trace-viewer/components/span-segments.ts` has been updated to detect V1 runs by the absence of `run_created` events and then infer segments from the run entity status using a dedicated V1 computation. This **bug fix** ensures that historical **V1 run traces are accurately displayed and segmented**, significantly improving the reliability and completeness of trace visualization for older data. New tests have been added in `packages/web-shared/test/trace-builder-v1.test.ts` to validate the correct trace building and segment computation for these V1 events.

This commit introduces a **refinement** to how event data is processed when `resolveData='none'` is specified, ensuring that only reference-related fields are stripped while other metadata is preserved. A new helper function, `stripEventDataRefs`, is added to the **`@workflow/world`** package to selectively remove `ref` and `payload` fields from event data. This new, more precise stripping logic is then integrated across the **`@workflow/world-local`**, **`@workflow/world-postgres`**, and **`@workflow/world-vercel`** storage implementations, replacing previous, less granular filtering. Additionally, the **`@workflow/web`** frontend is updated to correctly set `withData: false` when fetching events, aligning its requests with the backend's refined data resolution behavior. This change acts as a **bug fix** and **refactoring**, preventing unintended data loss and ensuring consistent event data handling across the platform.

This commit introduces significant **UI enhancements** and **architectural improvements** within the **`web-shared` package** and its consumers. It adds a new **`TimestampTooltip` component** to provide detailed time information on hover, integrated into `EventListView` and `AttributePanel` for improved data clarity. A new **toast abstraction layer** is implemented via `ToastProvider` and `useToast`, which is then used to **refactor** various components like `CopyableDataBlock` and `WorkflowTraceViewer` for consistent notification display, including new toasts for **successful data decryption**. Furthermore, the `EventListView` now features **improved loading skeletons** and **encrypted data detection**, allowing users to decrypt data directly from expanded rows.

This commit introduces a **bug fix** to the **web client's `useEventsListData` hook** by resolving a **stale closure issue** with the `encryptionKey`. Previously, the `encryptionKey` could become outdated, leading to problems during the decryption of events. The change updates the `packages/web/app/lib/client/hooks/use-events-list-data.ts` file to use a ref for `encryptionKey`, ensuring that the latest key is always available for `fetchInitial` and `fetchMore` operations. This guarantees **correct event decryption and display** for users viewing event lists, preventing data integrity issues.

This commit delivers significant **UX improvements** to the **observability features** by enhancing how traces, events, and streams are displayed and interacted with. It **decouples event data fetching** in the `RunDetailView` and `EventListView` for better pagination via a new `LoadMoreButton`, and implements **stream virtualization** in `StreamViewer` using `react-virtuoso` for improved performance with large datasets. Furthermore, new **decryption capabilities** are added through a `DecryptButton` component, allowing users to decrypt sensitive information directly within the event list and stream views. This work primarily introduces **new capabilities** and **enhances existing UI components** within the `web-shared` and `web` packages, providing a more responsive and secure debugging experience.

This commit significantly **improves the user experience and functionality** of the **workflow observability event list** within the `web-shared` package. It introduces **event sorting**, enhances **search functionality** for better matching, and refines the **event row expansion logic** with caching for smoother interactions in the `EventListView` component. Additionally, the `ErrorStackBlock` component has been **redesigned for improved visual clarity** in error reporting, and a new reusable `MenuDropdown` component is added. These **UX enhancements** provide users with a more efficient and intuitive way to navigate and understand workflow events.

This commit **refactors the user interface** by **relocating the decrypt button** from the main `RunDetailView` to the **sidebar's `EntityDetailPanel`**. This **UI/UX improvement** allows users to decrypt encrypted data directly from the sidebar, enhancing accessibility and consistency. The change involves adding the button and its `onDecrypt` callback to `EntityDetailPanel` within `web-shared` components, while removing it from `RunDetailView`. This streamlines the interaction flow for managing encrypted data across the application.

This commit **enhances the `web-shared` sidebar components** by enriching the display of sleep span details and correcting attribute capitalization. Specifically, the **`EntityDetailPanel` now correctly shows enriched sleep span information**, including `resumeAt` and `completedAt` timestamps, providing more comprehensive context for sleep workflows. Concurrently, a **bug fix** in the **`AttributePanel` adjusts attribute label capitalization**, ensuring `workflowCoreVersion` is no longer incorrectly capitalized. This work improves the **user interface's accuracy and detail** when viewing entity and attribute information within the application.

This commit performs a **maintenance chore** within the **CI/CD pipeline** by updating the **GitHub Actions release workflow**. It specifically modifies `.github/workflows/release.yml` to add a GitHub token to the `checkout` action. This change is crucial for **enabling authenticated operations** during the release process, ensuring that the workflow can successfully interact with GitHub APIs and other protected resources. Ultimately, this **fixes potential dispatch or synchronization issues** by providing the necessary permissions for the release job to complete.

This commit **fixes date parsing and formatting logic** within the **`web-shared` package**, specifically for the **sidebar's attribute panel** (`attribute-panel.tsx`). This **bug fix** addresses an issue where invalid or null date values would incorrectly display as "Invalid Date" in the detail panel. By refactoring the date handling, it ensures that dates are presented correctly and gracefully handles problematic data. This improves the **user experience** by preventing UI errors and providing accurate date displays in the workflow observability detail panel.

This commit introduces a **new automation capability** to streamline the **front-end release process** by synchronizing release pull requests. It adds a **GitHub Actions workflow** (`.github/workflows/dispatch-front-workflow-release-pr.yml`) designed to dispatch events for creating and managing front-end release PRs based on activity. Complementing this, a new Node.js script (`scripts/trigger-front-release-workflow-dispatch.cjs`) is included to programmatically trigger these workflow dispatch events. This enhancement automates the raising and synchronization of release PRs, significantly improving the efficiency and consistency of **front-end deployments**.