Repository navigation
V9x Remote Agent v0.13.0
Everything since v0.12.0, newest first.
0.13.0 (2026-10-23)
Added
- Smaller, faster screenshots.
screenshotandinput -OutFiletake
-Region x,y,w,h,-Scale <0.01-1>and-Gray; the MCP's
v9x_screenshotand every input tool takeregion,scaleandgray.
The result reportsRegionX/Y/Width/HeightandScalePercentso image
coordinates map back to the screen. - The agent shapes the capture before sending it (new capability
V9X_CAP_SCREENSHOT_OPTIONS0x00020000, an options block after the
SCREENSHOT_REQUEST path;src\common\shotxf.c): crop, box-filtered
downscale, and lossless packing. A screen with at most 256 colours (every
8-bpp desktop and most dialogs) goes out as 8-bit with an exact palette,
RLE8-compressed when smaller, instead of 24-bit. New hosts always ask for
that, so even a plain screenshot crosses the wire (and the remote-help
relay) in a fraction of the bytes.-Grayis the lossy option. - Against older agents, v9xctl and the MCP crop/scale/grey on the host after
the download, so the options work everywhere. - The MCP reads 8-bit and RLE8 BMPs and sends greyscale PNGs as one channel.
- The verbs agents kept improvising (each its own capability, so older
agents are refused cleanly with exit 23):cat -Path <file> [-Tail N] [-Match text] [-MaxBytes n]/ MCP
v9x_read_text: a text file inline, filtered and bounded in the guest,
instead ofgetand reading the download (V9X_CAP_FILE_TOOLS
0x00040000,FILE_READ_TEXT; filter insrc\common\textscan.c).hash -Path <file> [-Source <local>]/v9x_hash: size, CRC32 and
SHA-256 computed in the guest, compared with a local file on request.delete -Path <path> [-Recurse] [-Force]/v9x_delete; refuses roots,
the Windows and system directories,C:\V9XREMOTEand their parents.ps [-Name]/v9x_psandkill -Pid|-Name/v9x_kill
(V9X_CAP_PROCESS0x00080000, toolhelp): processes started byexec
are marked with their request id, so a job holding the slot (BUSY on
screenshot, reboot or update) can be found and ended; itsexec
completes as usual. The agent and Windows core processes are refused.
Exit 45.reg -Key HKLM\.../v9x_reg_query(V9X_CAP_REGISTRY0x00100000):
subkeys and decoded values of one key, read-only, instead of
REGEDIT /Eandget. Exit 46.
- Waits instead of sleeps. Transcripts showed thousands of
Start-Sleepcalls between v9xctl calls; each now has a verb or option
that returns as soon as the condition holds (AGENTS.md "Never sleep and
poll"):wait-file -Path [-Gone] [-StableMs]andexec/shell -WaitForFile
(stat polling on one connection; every agent). MCPv9x_wait_file,
wait_for_file. Exit 47.windows,wait-window -Title [-Gone],exec -WaitForWindowand
screenshot -Window <title>(captures that window only) on a new
WINDOW_LISTrequest (V9X_CAP_WINDOWS0x00200000). MCP
v9x_windows,wait_for_window,window. Exit 48.- Connections dropped before HELLO are retried twice by default;
-WaitForAgent N(any verb) retries every transport failure for N s
with backoff.wait-desktopandping -WaitSecondswait for the agent
too. MCP: same retry,v9x_pingwait_seconds.
- v9xctl usage:
help <verb>; a one-line unknown-verb error (verb list, this
copy's version and path) instead of the full help; verb aliases agents
guess (ls,pull,status,rm,type,tasklist,wait-ready...);
-Target host:port;-HostName/-EndpointPortaliases. - The tray icon carries a small cloud in its bottom-right corner while remote
help is connected to the relay: white with a blue outline, or grey while
remote help is paused. It sits on every state, so the white/yellow resting
body and the lime command flash work as before.
Fixed
get(andstat) could return a stale or garbage copy of an INI file that
a running program had just written withWritePrivateProfileString:
Windows 9x caches that file in memory and writes it lazily, which is why
shell TYPE(a DOS VM start flushes it) showed the right contents.
stat,get,hashandcatnow flush that file's cache first.
Reproduced on 98 SE: a five-key INI read back as 17 bytes of garbage before,
intact after.help update(anyhelp <verb>) failed parameter binding: the second
positional argument only accepted vnc's status/start/stop.
0.12.1 (2026-10-20)
Added
- One GUI step in one call:
v9xctl.ps1 input -OutFile <image>and
screenshot: trueon every MCP input tool send the input, wait
-SettleMs/settle_ms(default 500) and capture a screenshot on the same
connection. Host-side only; no protocol or guest change.
Changed
v9x_inputwith rawmoverelactions now checks that the agent supports
relative mouse moves, asv9x_movealready did.