Check the local QEMU host, configured binary, managed VM root, accelerator policy, and stable guest-to-host TCP route. VM remains locked by this session; call vm_unlock when finished.

List broker-managed QEMU VMs and their lifecycle state. VM remains locked by this session; call vm_unlock when finished.

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. VM remains locked by this session; call vm_unlock when finished.

Clear this session's managed QEMU VM selection. VM remains locked by this session; call vm_unlock when finished.

Read one managed QEMU VM's process, QMP, and guest TCP transport state. VM remains locked by this session; call vm_unlock when finished.

Preview the exact managed QEMU command without changing VM state. VM remains locked by this session; call vm_unlock when finished.

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. VM remains locked by this session; call vm_unlock when finished.

Update a stopped managed QEMU VM definition, including accelerator policy and any profile component. VM remains locked by this session; call vm_unlock when finished.

Start a managed QEMU VM with QMP and the profile's guest TCP network. VM remains locked by this session; call vm_unlock when finished.

Request graceful guest shutdown, wait 40 seconds, then stop only this QEMU process if needed. VM remains locked by this session; call vm_unlock when finished.

Gracefully stop then restart a managed QEMU VM. VM remains locked by this session; call vm_unlock when finished.

Immediately stop a managed QEMU VM when graceful shutdown is not possible. VM remains locked by this session; call vm_unlock when finished.

Move a managed QEMU VM to recoverable broker trash; only the newest three entries are retained. VM remains locked by this session; call vm_unlock when finished.

List recoverable deleted managed VMs. VM remains locked by this session; call vm_unlock when finished.

Restore a managed VM from broker trash. VM remains locked by this session; call vm_unlock when finished.

Permanently delete every retained QEMU trash entry. VM remains locked by this session; call vm_unlock when finished.

Read managed QEMU process and QMP metrics. VM remains locked by this session; call vm_unlock when finished.

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. VM remains locked by this session; call vm_unlock when finished.

List ISO images stored in this managed VM's media directory and report which ISO is configured as mounted. VM remains locked by this session; call vm_unlock when finished.

Mount a managed ISO now when the VM is running and persist it for future starts. VM remains locked by this session; call vm_unlock when finished.

Eject the managed CD-ROM now when running and persist an empty drive for future starts. VM remains locked by this session; call vm_unlock when finished.

Delete an unmounted managed ISO. force=true ejects it first when it is mounted. VM remains locked by this session; call vm_unlock when finished.

Set persistent QEMU boot order to disk, cdrom, or network. The VM must be stopped. VM remains locked by this session; call vm_unlock when finished.

List stopped-VM qcow2 internal snapshots. VM remains locked by this session; call vm_unlock when finished.

Create a named qcow2 internal disk snapshot while the VM is stopped. VM remains locked by this session; call vm_unlock when finished.

Restore a named qcow2 internal disk snapshot while the VM is stopped. VM remains locked by this session; call vm_unlock when finished.

Delete a named qcow2 internal disk snapshot while the VM is stopped. VM remains locked by this session; call vm_unlock when finished.

Capture the QEMU framebuffer before the Windows controller has started. VM remains locked by this session; call vm_unlock when finished.

Send a QMP qcode key event before or after guest-agent startup. VM remains locked by this session; call vm_unlock when finished.

Type basic QEMU monitor-compatible text into the active QEMU display. VM remains locked by this session; call vm_unlock when finished.

Send absolute QMP mouse coordinates to a running QEMU VM. VM remains locked by this session; call vm_unlock when finished.

Move then click through QMP before the Windows controller is available. VM remains locked by this session; call vm_unlock when finished.

Run an advanced QMP command against a managed VM's local broker-owned QMP endpoint. VM remains locked by this session; call vm_unlock when finished.

Run an advanced HMP command through QMP human-monitor-command. VM remains locked by this session; call vm_unlock when finished.

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.