Repository navigation
Conversation
The engine now tells the UI what scripts draw, from THeadlessSession's script-window API: windows (only what changed, with removed, and every window with full to a UI that attaches), each console's last 300 rows as windowText, the main window's area as mainArea and a console's own command line as windowCommandLine. The UI can give the main window's size, ask for any rows of a console, place or close a user window and send a line on a console's command line. libmudlet keeps the size the UI gave for each profile that loads; the stand-in has no script windows, says so on attach and refuses the requests. Versions 4 to 6 are left for protocol changes still in review. The window of a link (getLink/followLink) waits for version 5. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016ujaeGdi2MHnkoicGsDqhg
THeadlessSession sends a turn's main console lines as the turn runs, but its script windows, their text and command lines from the event loop after it. script_windows() waited for the chat console's windowText and then for the "main window" line the same runLua echoed, which had already come, and been collected, before the windowText: the wait timed out. Each wait now looks first at what came since its request, and a timeout lists what did come. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016ujaeGdi2MHnkoicGsDqhg
The profile's mudlet-base-ui package attaches its container to the right border, so after setBorderLeft(100) the main console's text is narrower than the window less 100 by that border: read it with getBorderRight(). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016ujaeGdi2MHnkoicGsDqhg
The engine now tells the UI what each label shows, from THeadlessSession's labelContent(): a label message after the windows message, for each label whose text, image, SVG, movie, tool tip, accessible name or button, click-through or stylesheet changed, and for every label to a UI that attaches or drains. windows gives bgAlpha for a background below opaque, as a Geyser.Gauge's text label is transparent; its back and front labels' geometry gives its value. The UI can send what its pointer did on a window (pointer, run by THeadlessSession::pointer(), so a label's click callback runs) and ask for an image file, scaled or one frame of it, as a PNG (getImage, answered by image). The stand-in has no labels and refuses both. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016ujaeGdi2MHnkoicGsDqhg
This was referenced Nov 15, 2026
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
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.
Brief overview of PR changes/additions
labelmessage after thewindowsmessage it belongs to. Only changed labels are sent, and a UI that attaches or drains gets them all again.pointerrequest: the UI's press, release, double-click, move, enter, leave and wheel on a window reach the profile's click and hover callbacks. The engine replies only when it refuses one.getImagerequest: returns a label's image file (or an icon) as a PNG, optionally scaled or for one frame. It is answered byimage.bgAlphafield carries see-through backgrounds, so the text label is transparent.PROTOCOL_VERSIONis now 8 indocs/protocol.md,SocketBridge,Protocol.ktandprotocol_client.py. The Kotlin side only parses and encodes the new messages; there is no UI for them yet. The stand-in engine refuses the new requests.Motivation for adding to Mudlet
Geyser labels, buttons and gauges are how most scripted interfaces are built. The Android UI needs their content and a way to click them.
Other info (issues closed, discussion etc)
libmudletand a Qt front-end Mudlet#9011bgAlphaon windows andsvgTintAlphaon labels.test_engine.py, ProtocolTest and ProtocolSpecTest, EngineLinkJvmTest against the stand-in, clang-format, ktlint, and a syntax check of MudletEnginetest_mudlet_engine.pyrun in CI only.Generated by Claude Code