vamp-mcp 0.1.9 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +142 -107
- package/THIRD_PARTY_NOTICES.md +32 -27
- package/bin/vamp-mcp.mjs +37 -37
- package/notices/mcp-virtualbox-LICENSE +21 -21
- package/notices/mcp-virtualbox-PROVENANCE.json +37 -37
- package/package.json +51 -17
- package/runtime/backends/common/Test-Environment.ps1 +7 -6
- package/runtime/backends/common/guest-install.json +58 -0
- package/runtime/backends/common/guest_install.py +57 -0
- package/runtime/backends/common/host-support.cjs +16 -0
- package/runtime/backends/common/packer.cjs +16 -0
- package/runtime/backends/hyperv/scripts/Manage-Desktop.ps1 +40 -67
- package/runtime/backends/hyperv/scripts/Send-InstallerBoot.ps1 +25 -0
- package/runtime/backends/kvm/debian-preseed.cfg +35 -35
- package/runtime/backends/library/registry.py +77 -77
- package/runtime/backends/library/replay.py +154 -154
- package/runtime/backends/packer/answer_media.py +16 -0
- package/runtime/backends/packer/deploy-hyperv.ps1 +10 -0
- package/runtime/backends/packer/drivers.py +49 -0
- package/runtime/backends/packer/hyperv-network.ps1 +10 -0
- package/runtime/backends/packer/images.py +75 -0
- package/runtime/backends/packer/osinfo.py +113 -0
- package/runtime/backends/packer/policy.json +15 -0
- package/runtime/backends/packer/runner.py +224 -0
- package/runtime/backends/packer/templates.py +118 -0
- package/runtime/backends/packer/toolchain.py +80 -0
- package/runtime/backends/remote_ssh/server.mjs +321 -94
- package/runtime/backends/virtualbox/desktop.cjs +37 -0
- package/runtime/backends/virtualbox/display.py +101 -101
- package/runtime/backends/virtualbox/history.py +139 -139
- package/runtime/backends/virtualbox/mouse_click.py +15 -15
- package/runtime/backends/virtualbox/mouse_move.py +18 -18
- package/runtime/backends/virtualbox/profiles.json +46 -46
- package/runtime/backends/virtualbox/provision.py +238 -184
- package/runtime/backends/virtualbox/recording_listener.py +29 -29
- package/runtime/backends/virtualbox/recordings.py +39 -39
- package/runtime/backends/virtualbox/requirements.txt +7 -7
- package/runtime/backends/virtualbox/rpas/debian_first_boot/manifest.json +1 -1
- package/runtime/backends/virtualbox/rpas/debian_first_boot/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/debian_first_boot/workflow.py +75 -75
- package/runtime/backends/virtualbox/rpas/observe/manifest.json +7 -7
- package/runtime/backends/virtualbox/rpas/observe/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/observe/workflow.py +14 -14
- package/runtime/backends/virtualbox/server.mjs +440 -63
- package/runtime/backends/virtualbox/setup_windows_sdk.py +58 -58
- package/runtime/backends/virtualbox/shares.py +68 -68
- package/runtime/backends/virtualbox/snapshots.py +53 -53
- package/runtime/backends/virtualbox/transfers.py +89 -89
- package/runtime/backends/virtualbox/vnc.py +61 -61
- package/runtime/guest_keys.py +13 -13
- package/runtime/guest_setup/http/debian-preseed.cfg +39 -0
- package/runtime/guest_setup/http/postdeb.sh +94 -0
- package/runtime/guest_setup/http/postwin.ps1 +53 -0
- package/runtime/guest_setup/http/setup-all.ps1 +25 -0
- package/runtime/guest_setup/http/setup-win.cmd +7 -0
- package/runtime/guest_setup/http/setup.ps1 +44 -0
- package/runtime/guest_setup/http/setup.sh +50 -0
- package/runtime/guest_setup/kvm/setup-debian.sh +73 -0
- package/runtime/guest_setup/kvm/setup-windows.ps1 +52 -0
- package/runtime/guest_setup/recorder/README.txt +12 -8
- package/runtime/guest_setup/recorder/RECORDER-LICENSE +674 -674
- package/runtime/guest_setup/recorder/RECORDING-GUIDE.txt +31 -31
- package/runtime/guest_setup/recorder/apply-display.py +41 -41
- package/runtime/guest_setup/recorder/configure-debian-mirrors.py +62 -62
- package/runtime/guest_setup/recorder/configure-gdm.py +23 -0
- package/runtime/guest_setup/recorder/configure-session.ps1 +14 -0
- package/runtime/guest_setup/recorder/gnome-display.py +60 -60
- package/runtime/guest_setup/recorder/install-display-startup.py +66 -39
- package/runtime/guest_setup/recorder/install-hypervisor-drivers.ps1 +34 -0
- package/runtime/guest_setup/recorder/install-resolution-shortcut.ps1 +36 -0
- package/runtime/guest_setup/recorder/postwin.cmd +10 -10
- package/runtime/guest_setup/recorder/prepare-recording.py +30 -30
- package/runtime/guest_setup/recorder/recorder.zip +0 -0
- package/runtime/guest_setup/recorder/requirements-recorder.txt +2 -2
- package/runtime/guest_setup/recorder/session-policy.py +22 -0
- package/runtime/guest_setup/recorder/setup-user.py +53 -35
- package/runtime/guest_setup/recorder/setup-win.cmd +4 -11
- package/runtime/guest_setup/recorder/setup.ps1 +108 -30
- package/runtime/guest_setup/recorder/setup.sh +19 -1
- package/runtime/guest_setup/recorder/vamp-recorder.py +148 -148
- package/runtime/guest_setup/recorder/verify-recorder.py +4 -4
- package/runtime/guest_setup/recorder/windows-display.py +76 -76
- package/runtime/guest_setup/requirements.txt +2 -0
- package/runtime/guest_setup/setup-all.ps1 +35 -0
- package/runtime/guest_setup/setup-all.sh +22 -0
- package/runtime/guest_setup/vault/Install-VCRuntime.ps1 +26 -0
- package/runtime/guest_setup/vault/setup-guest-vault.ps1 +148 -0
- package/runtime/guest_setup/vault/setup-guest-vault.sh +75 -0
- package/runtime/recording_converter.py +230 -230
- package/runtime/requirements-mcp.txt +11 -11
- package/runtime/rpas/README.md +161 -161
- package/runtime/rpas/captcha_handoff/manifest.json +27 -27
- package/runtime/rpas/captcha_handoff/run.robot +16 -16
- package/runtime/rpas/captcha_handoff/workflow.py +11 -11
- package/runtime/rpas/common.resource +26 -26
- package/runtime/rpas/debian_update/manifest.json +27 -27
- package/runtime/rpas/debian_update/run.robot +17 -17
- package/runtime/rpas/debian_update/workflow.py +13 -13
- package/runtime/rpas/desktop_control/manifest.json +26 -26
- package/runtime/rpas/desktop_control/run.robot +27 -27
- package/runtime/rpas/desktop_control/workflow.py +51 -51
- package/runtime/rpas/firefox_launch/manifest.json +27 -27
- package/runtime/rpas/firefox_launch/run.robot +15 -15
- package/runtime/rpas/firefox_launch/workflow.py +25 -25
- package/runtime/rpas/firefox_naver/manifest.json +27 -27
- package/runtime/rpas/firefox_naver/run.robot +21 -21
- package/runtime/rpas/firefox_naver/workflow.py +28 -28
- package/runtime/rpas/kvm_validation/README.md +11 -11
- package/runtime/rpas/kvm_validation/manifest.json +28 -28
- package/runtime/rpas/kvm_validation/run.robot +30 -30
- package/runtime/rpas/kvm_validation/workflow.py +91 -91
- package/runtime/rpas/manifest.schema.json +105 -105
- package/runtime/rpas/naver_login/login.robot +25 -25
- package/runtime/rpas/naver_login/manifest.json +33 -33
- package/runtime/rpas/naver_login/run.robot +20 -20
- package/runtime/rpas/naver_login/workflow.py +32 -32
- package/runtime/rpas/windows_naver_recorded/README.md +24 -24
- package/runtime/rpas/windows_naver_recorded/conversion.json +25 -25
- package/runtime/rpas/windows_naver_recorded/manifest.json +28 -28
- package/runtime/rpas/windows_naver_recorded/run.robot +37 -37
- package/runtime/rpas/windows_naver_recorded/workflow.py +32 -32
- package/runtime/scripts/build_recorder_media.py +39 -39
- package/runtime/scripts/macos/setup-host.sh +126 -0
- package/runtime/scripts/remote_host_setup.sh +7 -4
- package/runtime/scripts/script_server.py +571 -0
- package/runtime/skills/vamp-rpa-ui-checks/SKILL.md +26 -0
- package/runtime/skills/vamp-rpa-ui-checks/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/display.md +12 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/user-guide.md +49 -0
- package/runtime/skills/vamp-ui-cleanup/SKILL.md +15 -0
- package/runtime/skills/vamp-ui-cleanup/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-ui-validation/SKILL.md +27 -0
- package/runtime/skills/vamp-ui-validation/agents/openai.yaml +4 -0
- package/runtime/third_party/mcp-virtualbox/scripts/mouse_click.py +65 -65
- package/runtime/third_party/pyautogui-recorder/LICENSE +674 -674
- package/runtime/third_party/pyautogui-recorder/PROVENANCE.json +16 -16
- package/runtime/third_party/pyautogui-recorder/PyAutoGuiRecorder.py +169 -169
- package/runtime/third_party/pyautogui-recorder/README.md +53 -53
- package/runtime/scripts/build_debian_installer.py +0 -48
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vamp-ui-cleanup
|
|
3
|
+
description: Simplify VAMP VS Code webviews and user-facing MCP copy while preserving automation controls, accessibility and installation warnings. Use for UI text translation, redundant controls and layout cleanup.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# VAMP UI cleanup
|
|
7
|
+
|
|
8
|
+
1. Locate the webview generator, message handlers and existing UI tests. List the element IDs consumed by scripts before removing markup.
|
|
9
|
+
2. Use concise English product text. Keep status, errors, permission requirements and recovery actions visible. Preserve language-recognition patterns; they are not product copy.
|
|
10
|
+
3. Keep one primary action for each task. Move manual recovery, environment reset and diagnostics into a labeled disclosure. Remove duplicate guide links and implementation prose from the main flow.
|
|
11
|
+
4. Preserve VS Code theme variables, keyboard focus, accessible labels, narrow layouts and live status announcements. Hide unsupported host/backend options; do not advertise unimplemented features.
|
|
12
|
+
5. Preserve the guest setup warning: wait for setup completion before locking or suspending the guest. Describe display settings as best effort unless verified. Do not present input delivery as successful installation.
|
|
13
|
+
6. Test the generated HTML with mocked webview messages. Cover loading, ready, busy, missing dependency and failure states. Verify stable IDs, event wiring and disabled controls, especially shared HTTP server Start/Stop.
|
|
14
|
+
|
|
15
|
+
Use static fixtures for layout checks. UI editing does not authorize creating or controlling a VM. Honor an existing automation pause. Report changed controls and actual validation separately from untested guest behavior.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vamp-ui-validation
|
|
3
|
+
description: Validate VAMP VS Code webviews and packaged VSIX installations with isolated profiles and deterministic UI evidence. Use for release UI checks, native file pickers and installed-extension regressions.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# VAMP UI validation
|
|
7
|
+
|
|
8
|
+
## Choose the test boundary
|
|
9
|
+
|
|
10
|
+
For copy, layout and message handling, render generated HTML with a mocked acquireVsCodeApi. Record outgoing messages without dispatching them to a real extension. Exercise loading, ready, busy, error and unsupported backend states at wide and narrow sizes.
|
|
11
|
+
|
|
12
|
+
For installed-extension bugs, build the VSIX and install it into an isolated user-data directory and extensions directory. Record extension ID, version and resolved installation path. A development host or source override is not evidence that the packaged extension works. Updating an isolated profile does not update the user's normal profile.
|
|
13
|
+
|
|
14
|
+
## Target the correct window
|
|
15
|
+
|
|
16
|
+
- Identify the isolated VS Code process and its exact webview frame before using locators. Prefer IDs, roles and labels over coordinates.
|
|
17
|
+
- Native file pickers are outside the webview. On Windows, locate the dialog by process and window handle, then locate its filename Edit and Open button through UI Automation. Validate the owning process before targeted window messages. Control IDs vary across dialogs; inspect them instead of assuming them.
|
|
18
|
+
- Bringing a browser page forward does not prove native focus. Avoid global SendKeys. Never type into an unverified foreground window.
|
|
19
|
+
- Use the matching backend skill for authorized guest input. Do not resume paused VM automation merely to validate UI changes.
|
|
20
|
+
|
|
21
|
+
## Check outcomes
|
|
22
|
+
|
|
23
|
+
Wait for settled UI state rather than fixed delays. For server buttons, check busy/disabled states and final Running/Stopped status; check HTTP health only when server lifecycle changes are authorized. Use an isolated fixture otherwise.
|
|
24
|
+
|
|
25
|
+
For creation flows, distinguish accepted request, VM creation, OS installation and completed guest setup. Verify recorder installation and session policy inside the guest only when that test is authorized. A manually invoked installer cannot prove automatic setup.
|
|
26
|
+
|
|
27
|
+
Return a compact record: artifact version/path, host/backend, action, expected state, observed state and evidence path. Mark unrun or incomplete stages explicitly. Keep credentials and development VM names out of release artifacts.
|
|
@@ -1,65 +1,65 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
"""
|
|
3
|
-
Absolute mouse click helper for VirtualBox VMs.
|
|
4
|
-
Uses the VirtualBox Python API (vboxapi) for absolute mouse positioning,
|
|
5
|
-
which requires USB tablet mouse mode on the VM.
|
|
6
|
-
|
|
7
|
-
Usage: python mouse_click.py <vm_name> <x> <y> [left|right|middle] [--double]
|
|
8
|
-
"""
|
|
9
|
-
|
|
10
|
-
import sys
|
|
11
|
-
import time
|
|
12
|
-
|
|
13
|
-
def main():
|
|
14
|
-
if len(sys.argv) < 4:
|
|
15
|
-
print("Usage: mouse_click.py <vm_name> <x> <y> [left|right|middle] [--double]", file=sys.stderr)
|
|
16
|
-
sys.exit(1)
|
|
17
|
-
|
|
18
|
-
vm_name = sys.argv[1]
|
|
19
|
-
x = int(sys.argv[2])
|
|
20
|
-
y = int(sys.argv[3])
|
|
21
|
-
button = sys.argv[4] if len(sys.argv) > 4 and sys.argv[4] != "--double" else "left"
|
|
22
|
-
double = "--double" in sys.argv
|
|
23
|
-
|
|
24
|
-
button_map = {"left": 0x01, "right": 0x02, "middle": 0x04}
|
|
25
|
-
button_flag = button_map.get(button, 0x01)
|
|
26
|
-
|
|
27
|
-
try:
|
|
28
|
-
import vboxapi
|
|
29
|
-
except ImportError:
|
|
30
|
-
# Fallback: try importing from VirtualBox SDK location
|
|
31
|
-
import os
|
|
32
|
-
vbox_path = os.environ.get("VBOX_SDK_PATH", r"C:\Program Files\Oracle\VirtualBox\sdk\install")
|
|
33
|
-
sys.path.insert(0, vbox_path)
|
|
34
|
-
import vboxapi
|
|
35
|
-
|
|
36
|
-
mgr = vboxapi.VirtualBoxManager(None, None)
|
|
37
|
-
vbox = mgr.getVirtualBox()
|
|
38
|
-
machine = vbox.findMachine(vm_name)
|
|
39
|
-
session = mgr.getSessionObject()
|
|
40
|
-
|
|
41
|
-
machine.lockMachine(session, 1) # LockType_Shared = 1
|
|
42
|
-
try:
|
|
43
|
-
console = session.console
|
|
44
|
-
mouse = console.mouse
|
|
45
|
-
|
|
46
|
-
if not mouse.absoluteSupported:
|
|
47
|
-
print("Warning: Absolute mouse not supported. Enable USB tablet mode.", file=sys.stderr)
|
|
48
|
-
|
|
49
|
-
# Move to position and click
|
|
50
|
-
mouse.putMouseEventAbsolute(x, y, 0, 0, button_flag)
|
|
51
|
-
time.sleep(0.05)
|
|
52
|
-
mouse.putMouseEventAbsolute(x, y, 0, 0, 0) # Release
|
|
53
|
-
|
|
54
|
-
if double:
|
|
55
|
-
time.sleep(0.1)
|
|
56
|
-
mouse.putMouseEventAbsolute(x, y, 0, 0, button_flag)
|
|
57
|
-
time.sleep(0.05)
|
|
58
|
-
mouse.putMouseEventAbsolute(x, y, 0, 0, 0)
|
|
59
|
-
|
|
60
|
-
print(f"Clicked {button} at ({x}, {y})" + (" (double)" if double else ""))
|
|
61
|
-
finally:
|
|
62
|
-
session.unlockMachine()
|
|
63
|
-
|
|
64
|
-
if __name__ == "__main__":
|
|
65
|
-
main()
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
Absolute mouse click helper for VirtualBox VMs.
|
|
4
|
+
Uses the VirtualBox Python API (vboxapi) for absolute mouse positioning,
|
|
5
|
+
which requires USB tablet mouse mode on the VM.
|
|
6
|
+
|
|
7
|
+
Usage: python mouse_click.py <vm_name> <x> <y> [left|right|middle] [--double]
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
import sys
|
|
11
|
+
import time
|
|
12
|
+
|
|
13
|
+
def main():
|
|
14
|
+
if len(sys.argv) < 4:
|
|
15
|
+
print("Usage: mouse_click.py <vm_name> <x> <y> [left|right|middle] [--double]", file=sys.stderr)
|
|
16
|
+
sys.exit(1)
|
|
17
|
+
|
|
18
|
+
vm_name = sys.argv[1]
|
|
19
|
+
x = int(sys.argv[2])
|
|
20
|
+
y = int(sys.argv[3])
|
|
21
|
+
button = sys.argv[4] if len(sys.argv) > 4 and sys.argv[4] != "--double" else "left"
|
|
22
|
+
double = "--double" in sys.argv
|
|
23
|
+
|
|
24
|
+
button_map = {"left": 0x01, "right": 0x02, "middle": 0x04}
|
|
25
|
+
button_flag = button_map.get(button, 0x01)
|
|
26
|
+
|
|
27
|
+
try:
|
|
28
|
+
import vboxapi
|
|
29
|
+
except ImportError:
|
|
30
|
+
# Fallback: try importing from VirtualBox SDK location
|
|
31
|
+
import os
|
|
32
|
+
vbox_path = os.environ.get("VBOX_SDK_PATH", r"C:\Program Files\Oracle\VirtualBox\sdk\install")
|
|
33
|
+
sys.path.insert(0, vbox_path)
|
|
34
|
+
import vboxapi
|
|
35
|
+
|
|
36
|
+
mgr = vboxapi.VirtualBoxManager(None, None)
|
|
37
|
+
vbox = mgr.getVirtualBox()
|
|
38
|
+
machine = vbox.findMachine(vm_name)
|
|
39
|
+
session = mgr.getSessionObject()
|
|
40
|
+
|
|
41
|
+
machine.lockMachine(session, 1) # LockType_Shared = 1
|
|
42
|
+
try:
|
|
43
|
+
console = session.console
|
|
44
|
+
mouse = console.mouse
|
|
45
|
+
|
|
46
|
+
if not mouse.absoluteSupported:
|
|
47
|
+
print("Warning: Absolute mouse not supported. Enable USB tablet mode.", file=sys.stderr)
|
|
48
|
+
|
|
49
|
+
# Move to position and click
|
|
50
|
+
mouse.putMouseEventAbsolute(x, y, 0, 0, button_flag)
|
|
51
|
+
time.sleep(0.05)
|
|
52
|
+
mouse.putMouseEventAbsolute(x, y, 0, 0, 0) # Release
|
|
53
|
+
|
|
54
|
+
if double:
|
|
55
|
+
time.sleep(0.1)
|
|
56
|
+
mouse.putMouseEventAbsolute(x, y, 0, 0, button_flag)
|
|
57
|
+
time.sleep(0.05)
|
|
58
|
+
mouse.putMouseEventAbsolute(x, y, 0, 0, 0)
|
|
59
|
+
|
|
60
|
+
print(f"Clicked {button} at ({x}, {y})" + (" (double)" if double else ""))
|
|
61
|
+
finally:
|
|
62
|
+
session.unlockMachine()
|
|
63
|
+
|
|
64
|
+
if __name__ == "__main__":
|
|
65
|
+
main()
|