devtool: show param descriptions in the left side panel - #963
Draft
claude[bot] wants to merge 1 commit into
Draft
Conversation
Surface each MCP tool param's description in the left side panel via a hover tooltip on the param label, so descriptions stay accessible without opening a dialog. The tooltip only appears when the param has a description; the plain label is rendered otherwise. Adds a shared FieldLabel helper used by the field, object, and array templates, replacing the always-visible truncated description text. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018YtbxbHyEu6gTT7AjtKHAk
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Julien Vallini · Slack thread
Before / After
Before: hovering (or looking at) a param in the DevTools left side panel showed no description — the full description was only reachable by clicking a "... more" link that opened a modal dialog, i.e. by leaving the panel.
After: each param's description is shown as a tooltip on hover of the param label, so it stays accessible inline in the panel. The hover affordance only appears when the param actually has a description.
How
All changes are in
packages/devtools/src/components/layout/tools-list/form/templates.tsx— the RJSF templates that render the generated tool-input form in the left panel:FieldLabelhelper that renders the param label and, when a description exists, wraps it in the existingTooltipprimitive (@alpic-ai/ui/components/tooltip, the same one already used elsewhere in this file) to reveal the full description on hover. When there is no description it renders a plain label, so no affordance is shown.FieldLabelinFieldTemplate(scalar params),ObjectFieldTemplate, andArrayFieldTemplate, replacing the always-visible truncated description text. The inline text is kept only as a fallback for the rare case of a field/container that has a description but no label/title to hang the tooltip on.Typecheck (
tsc -b), lint/format (biome ci), and unit tests pass for the devtools package.Closes #960
🤖 Generated with Claude Code
https://claude.ai/code/session_018YtbxbHyEu6gTT7AjtKHAk
Generated by Claude Code