feat(rivetkit): rerun workflows from inspector

[NathanFlurry]

Description

Please include a summary of the changes and the related issue. Please also include relevant motivation and context.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[railway-app]

🚅 Deployed to the rivet-pr-4533 environment in rivet-frontend

Service	Status	Web	Updated (UTC)
kitchen-sink	❌ Build Failed (View Logs)	Web	Mar 31, 2026 at 1:13 am
website	😴 Sleeping (View Logs)	Web	Mar 30, 2026 at 11:33 pm
frontend-cloud	😴 Sleeping (View Logs)	Web	Mar 30, 2026 at 11:31 pm
frontend-inspector	😴 Sleeping (View Logs)	Web	Mar 30, 2026 at 11:30 pm
mcp-hub	✅ Success (View Logs)	Web	Mar 30, 2026 at 11:20 pm
ladle	❌ Build Failed (View Logs)	Web	Mar 30, 2026 at 11:20 pm

[NathanFlurry]

• feat: workflow try helpers & visualizer support #4413
• feat(rivetkit): rerun workflows from inspector #4533 👈 (View in Graphite)
• feat: add inspector SQLite shell and property bindings #4410
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[pkg-pr-new]

More templates

• actor-actions
• actor-actions-vercel
• ai-agent
• ai-agent-vercel
• example-ai-and-user-generated-actors-freestyle
• chat-room
• chat-room-vercel
• example-cloudflare-workers
• example-cloudflare-workers-hono
• collaborative-document
• collaborative-document-vercel
• cross-actor-actions
• cross-actor-actions-vercel
• example-cursors
• example-cursors-raw-websocket
• example-cursors-raw-websocket-vercel
• example-cursors-vercel
• custom-serverless
• example-elysia
• example-experimental-durable-streams-ai-agent
• example-experimental-durable-streams-ai-agent-vercel
• geo-distributed-database
• geo-distributed-database-vercel
• hello-world
• hello-world-vercel
• example-hono
• hono-react
• hono-react-vercel
• example-kitchen-sink
• example-kitchen-sink-vercel
• multi-region-vercel
• multiplayer-game
• example-multiplayer-game-patterns
• example-multiplayer-game-patterns-vercel
• multiplayer-game-vercel
• native-websockets
• native-websockets-vercel
• next-js
• per-tenant-database
• per-tenant-database-vercel
• example-raw-fetch-handler
• example-raw-fetch-handler-vercel
• example-raw-websocket-handler
• example-raw-websocket-handler-proxy
• example-raw-websocket-handler-proxy-vercel
• example-raw-websocket-handler-vercel
• example-react
• example-react-vercel
• sandbox
• sandbox-coding-agent
• sandbox-coding-agent-vercel
• sandbox-vercel
• scheduling
• scheduling-vercel
• example-sqlite-drizzle
• example-sqlite-raw
• state
• state-vercel
• example-stream
• example-stream-vercel
• example-trpc

@rivetkit/cloudflare-workers

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/cloudflare-workers@4533

@rivetkit/framework-base

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/framework-base@4533

@rivetkit/next-js

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/next-js@4533

@rivetkit/react

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/react@4533

rivetkit

pnpm add https://pkg.pr.new/rivet-dev/rivet/rivetkit@4533

@rivetkit/sql-loader

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sql-loader@4533

@rivetkit/sqlite-vfs

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sqlite-vfs@4533

@rivetkit/traces

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/traces@4533

@rivetkit/workflow-engine

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/workflow-engine@4533

@rivetkit/virtual-websocket

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/virtual-websocket@4533

@rivetkit/engine-runner

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner@4533

@rivetkit/engine-runner-protocol

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner-protocol@4533

commit: 1d0028d

[NathanFlurry]

Merge activity

• Mar 31, 1:14 AM UTC: @NathanFlurry merged this pull request with Graphite.

[claude]

PR Review: feat(rivetkit): rerun workflows from inspector

This PR adds UI support for replaying workflows from a specific step in the Actor workflow inspector via two surfaces: a right-click context menu on graph nodes and a persistent toolbar button.

HIGH SEVERITY

Issue: data.canReplay is always undefined — context menu never opens

In workflow-visualizer.tsx, the onNodeContextMenu handler gates on data.canReplay. However, canReplay is never set on any node's data in workflow-to-xyflow.ts or the WorkflowNodeData interface. Because the interface has an index signature ([key: string]: unknown), TypeScript will not catch this. data.canReplay will always be undefined and the context menu will never open. The field needs to be added to the WorkflowNodeData interface and populated wherever node data is constructed.

MEDIUM SEVERITY

Issue: Duplicate endpoint in skill-base-rivetkit.md

The line "POST /inspector/workflow/replay" appears to have been added at line 35, but also already exists later in the same file, creating a duplicate bullet point.

Issue: Hint text shown regardless of protocol version

The helper text "Right-click a previous step to replay the workflow from there." renders unconditionally, even when inspector.inspectorProtocolVersion is less than 4. Users on older inspectors see a hint for a feature that will not work. This should be gated on the same version check used for the button and onReplayStep prop.

LOW SEVERITY

Issue: Context menu may clip off viewport edges

The menu is positioned at clientX/clientY with no boundary detection. Nodes near the right or bottom edge will cause the menu to overflow off-screen. Consider checking against window.innerWidth / window.innerHeight and flipping the anchor.

Issue: isReplaying state can become stale

isReplaying is captured into contextMenu state at menu-open time from data.isReplaying. If a replay is triggered elsewhere after the menu opens, the disabled state in the context menu will not update. Consider deriving this from the mutation state reactively.

Issue: canReplayCurrentStep does not handle first-attempt failures

The toolbar button requires retryCount > 0, so a step that fails on its first attempt will not show the button. If first-attempt replay is desirable, the condition should be relaxed or at minimum documented.

Issue: canReplay missing from WorkflowNodeData interface

After fixing the runtime bug above, the TypeScript interface should include canReplay as an optional boolean for type safety.

CODE QUALITY

The implementation is generally well-structured. The useEffect for outside-click/Escape dismissal is correct and properly cleans up listeners. Using globalThis.Node to disambiguate from React's Node type is a thoughtful detail. Tailwind classes on the context menu correctly mirror shadcn/ui dropdown styling. The version guard inspectorProtocolVersion >= 4 is consistently applied across the toolbar button and onReplayStep prop.