Skip to content

docs(plugin-dev): document MessageDisplay streaming semantics - #83374

Open
iCodeCraft wants to merge 1 commit into
anthropics:mainfrom
iCodeCraft:message-display-hook-guidance
Open

docs(plugin-dev): document MessageDisplay streaming semantics#83374
iCodeCraft wants to merge 1 commit into
anthropics:mainfrom
iCodeCraft:message-display-hook-guidance

Conversation

@iCodeCraft

@iCodeCraft iCodeCraft commented Aug 2, 2026

Copy link
Copy Markdown

Summary

The bundled Hook Development skill currently omits MessageDisplay from its trigger description, event guidance, and quick-reference table, even though it is a supported hook event.

This PR documents MessageDisplay in the bundled plugin-development guidance:

  • adds it to the skill trigger description and event table
  • explains the streaming fields: message_id, index, final, and delta
  • clarifies display-only behavior, per-message state, cleanup, and latency considerations
  • links to the canonical MessageDisplay hook reference

Real-world motivation

This guidance was validated while building an opt-in MessageDisplay plugin that preserves Markdown-sensitive LaTeX escapes in terminal output:

The plugin uses MessageDisplay as intended: it is display-only, preserves the transcript and model context, and maintains state per streamed message.

It is a workaround for LaTeX source corruption, not a replacement for native math rendering. Native rendering remains a separate feature request: #44479

Testing

  • git diff --check

This is a documentation-only change that aligns the bundled skill with the existing MessageDisplay hook reference.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants