Check the local QEMU host, configured binary, managed VM root, accelerator policy, and stable guest-to-host TCP route.

List broker-managed QEMU VMs and their lifecycle state.

Record the managed QEMU VM selected in this MCP/Admin session's QEMU panel. In-guest MCP control remains the agent's outbound TCP connection.

Clear this session's managed QEMU VM selection.

Read one managed QEMU VM's process, QMP, and guest TCP transport state.

Preview the exact managed QEMU command without changing VM state.

Import a broker-local disk into a new managed qcow2 QEMU VM. disk_path currently belongs to the broker host; remote-media upload is not available yet.

Update a stopped managed QEMU VM definition, including accelerator policy and any profile component.

Start a managed QEMU VM with QMP and the profile's guest TCP network.

Request graceful guest shutdown, wait 40 seconds, then stop only this QEMU process if needed.

Gracefully stop then restart a managed QEMU VM.

Immediately stop a managed QEMU VM when graceful shutdown is not possible.

Move a managed QEMU VM to recoverable broker trash; only the newest three entries are retained.

List recoverable deleted managed VMs.

Restore a managed VM from broker trash.

Permanently delete every retained QEMU trash entry.

Read managed QEMU process and QMP metrics.

Copy a broker-local .iso image into this VM's managed media directory. source_path is resolved on the broker host; remote media upload is not available yet.

List ISO images stored in this managed VM's media directory and report which ISO is configured as mounted.

Mount a managed ISO now when the VM is running and persist it for future starts.

Eject the managed CD-ROM now when running and persist an empty drive for future starts.

Delete an unmounted managed ISO. force=true ejects it first when it is mounted.

Set persistent QEMU boot order to disk, cdrom, or network. The VM must be stopped.

List stopped-VM qcow2 internal snapshots.

Create a named qcow2 internal disk snapshot while the VM is stopped.

Restore a named qcow2 internal disk snapshot while the VM is stopped.

Delete a named qcow2 internal disk snapshot while the VM is stopped.

Capture the QEMU framebuffer before the Windows controller has started.

Send a QMP qcode key event before or after guest-agent startup.

Type basic QEMU monitor-compatible text into the active QEMU display.

Send absolute QMP mouse coordinates to a running QEMU VM.

Move then click through QMP before the Windows controller is available.

Run an advanced QMP command against a managed VM's local broker-owned QMP endpoint.

Run an advanced HMP command through QMP human-monitor-command.

List every named VM known to this broker with its current connection, build, address, capabilities, and lease state.

Inspect guest connection and lease state without acquiring the VM lease.

Read the connected Windows 98 guest capabilities without acquiring the VM lease.

Explicitly acquire the exclusive VM lease. Most operational tools acquire it automatically. VM remains locked by this session; call vm_unlock when finished.

Wait in the FIFO lease queue for at most ten minutes. Use after VM_BUSY. VM remains locked by this session; call vm_unlock when finished.

Release this session's VM lease. Normal unlock refuses while terminals or transfers remain open.

Display a Windows 98 message dialog titled Windows 98 Remote Control. Acquires the VM lease. VM remains locked by this session; call vm_unlock when finished.

Capture the primary display or a pixel region as native MCP PNG image content. Acquires the VM lease. VM remains locked by this session; call vm_unlock when finished.

Move the mouse to an exact zero-based physical pixel coordinate. VM remains locked by this session; call vm_unlock when finished.

Click at the supplied coordinates, or at the current pointer position when omitted. VM remains locked by this session; call vm_unlock when finished.

Hold a mouse button down, optionally moving to coordinates first. Always release it later. VM remains locked by this session; call vm_unlock when finished.

Release a held mouse button, optionally moving to coordinates first. VM remains locked by this session; call vm_unlock when finished.

Drag between exact pixel coordinates while holding the selected mouse button. VM remains locked by this session; call vm_unlock when finished.

Send a mouse-wheel delta at optional coordinates. Requires guest wheel support. VM remains locked by this session; call vm_unlock when finished.

Read the current mouse pointer position. VM remains locked by this session; call vm_unlock when finished.

Release every mouse button tracked as held by this session. VM remains locked by this session; call vm_unlock when finished.

Type text with the active Windows 98 keyboard layout; fails rather than substituting unrepresentable characters. VM remains locked by this session; call vm_unlock when finished.

Press, hold, or release a named key such as ENTER, CTRL, LEFT, or F1. VM remains locked by this session; call vm_unlock when finished.

Press named keys in order and release them in reverse order. VM remains locked by this session; call vm_unlock when finished.

Send a low-level Win32 virtual-key or scan-code input event. VM remains locked by this session; call vm_unlock when finished.

Release every keyboard key tracked as held by this session. VM remains locked by this session; call vm_unlock when finished.

Execute a validated mouse, keyboard, delay, clipboard, and focus sequence in one guest round trip. VM remains locked by this session; call vm_unlock when finished.

Read text from the Windows 98 clipboard. VM remains locked by this session; call vm_unlock when finished.

Replace Windows 98 clipboard text. VM remains locked by this session; call vm_unlock when finished.

List windows with handle, title, class, process, visibility, enabled state, and screen rectangle. VM remains locked by this session; call vm_unlock when finished.

Bring a window returned by window_list to the foreground. VM remains locked by this session; call vm_unlock when finished.

Request that a selected window close. VM remains locked by this session; call vm_unlock when finished.

Capture a selected window as native MCP PNG image content. VM remains locked by this session; call vm_unlock when finished.

Run a command to completion with captured ordered stdout+stderr output; error results may include a screenshot. VM remains locked by this session; call vm_unlock when finished.

Start an interactive redirected-pipe shell session and return its session ID. VM remains locked by this session; call vm_unlock when finished.

Read bounded output after a cursor from an interactive shell, optionally long-polling. VM remains locked by this session; call vm_unlock when finished.

Write UTF-8 text or base64 bytes to an interactive shell and optionally close stdin. VM remains locked by this session; call vm_unlock when finished.

Terminate a running interactive shell session. VM remains locked by this session; call vm_unlock when finished.

Release broker resources for a completed interactive shell session. VM remains locked by this session; call vm_unlock when finished.

List Windows 98 processes. VM remains locked by this session; call vm_unlock when finished.

Wait for a process to exit for a bounded period. VM remains locked by this session; call vm_unlock when finished.

Terminate a process and, by default, its discovered child tree. VM remains locked by this session; call vm_unlock when finished.

List available Windows drive roots for filesystem browsing. VM remains locked by this session; call vm_unlock when finished.

Read metadata for a guest filesystem path. VM remains locked by this session; call vm_unlock when finished.

List a guest directory, optionally recursively. VM remains locked by this session; call vm_unlock when finished.

Create a guest directory. VM remains locked by this session; call vm_unlock when finished.

Move or rename a guest file or directory. VM remains locked by this session; call vm_unlock when finished.

Delete a guest file or directory. VM remains locked by this session; call vm_unlock when finished.

Copy a host file into the guest through a verified temporary-file commit. VM remains locked by this session; call vm_unlock when finished.

Copy a guest file to an allowed host path through a verified temporary-file commit. VM remains locked by this session; call vm_unlock when finished.

Merge-copy a host directory into the guest without deleting unrelated guest files. VM remains locked by this session; call vm_unlock when finished.

Merge-copy a guest directory to an allowed host path without deleting unrelated host files. VM remains locked by this session; call vm_unlock when finished.

Read detailed guest operating-system, code-page, display, and build information. VM remains locked by this session; call vm_unlock when finished.

Read the guest crash context and supervisor recovery status without acquiring the VM lease.

Reboot Windows 98. This disconnects the guest and requires configured autostart for recovery. VM remains locked by this session; call vm_unlock when finished.

Shut down Windows 98. The guest cannot reconnect until the VM is started externally. VM remains locked by this session; call vm_unlock when finished.