Document OpenAI Apps SDK Display Mode Support

[mintlify]

Added documentation for the new Display Mode feature (Picture-in-Picture and Fullscreen) for OpenAI Apps SDK widgets introduced in PR #927. This enhancement allows widgets to request different display modes to optimize their presentation, including floating PiP mode and immersive fullscreen experiences.

Files Changed

• docs/inspector/llm-playground.mdx - Added user-facing documentation for display modes
• docs/contributing/openai-sdk-architecture.mdx - Added technical implementation details for display mode support

---

Note

Documents OpenAI Apps SDK display modes (inline/PiP/fullscreen), requestDisplayMode (with maxHeight), and the corresponding parent-side handling, plus adds user-facing playground guidance.

• Docs:
  • Architecture (docs/contributing/openai-sdk-architecture.mdx):
    • Add comprehensive Display Mode support docs: PiP/fullscreen/inline behavior, state management (thread.tsx), mode detection and CSS classes, exit button, and synchronization to ensure single PiP widget.
    • Extend window.openai.requestDisplayMode() to accept options.maxHeight; document propagation to parent and height handling.
    • Update parent message handling to process openai:requestDisplayMode, manage PiP enter/exit, and set maxHeight.
    • Refresh code references (line ranges) and iframe sandbox location; expand Related Files with openai-app-renderer.tsx, thread.tsx, ChatTabV2.tsx.
  • Playground (docs/inspector/llm-playground.mdx):
    • Add Display Modes section describing inline, PiP, fullscreen, and usage of requestDisplayMode with user exit behavior.

^{Written by Cursor Bugbot for commit 6b5b71f. This will update automatically on new commits. Configure here.}