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.
Files changed (140) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +142 -107
  3. package/THIRD_PARTY_NOTICES.md +32 -27
  4. package/bin/vamp-mcp.mjs +37 -37
  5. package/notices/mcp-virtualbox-LICENSE +21 -21
  6. package/notices/mcp-virtualbox-PROVENANCE.json +37 -37
  7. package/package.json +51 -17
  8. package/runtime/backends/common/Test-Environment.ps1 +7 -6
  9. package/runtime/backends/common/guest-install.json +58 -0
  10. package/runtime/backends/common/guest_install.py +57 -0
  11. package/runtime/backends/common/host-support.cjs +16 -0
  12. package/runtime/backends/common/packer.cjs +16 -0
  13. package/runtime/backends/hyperv/scripts/Manage-Desktop.ps1 +40 -67
  14. package/runtime/backends/hyperv/scripts/Send-InstallerBoot.ps1 +25 -0
  15. package/runtime/backends/kvm/debian-preseed.cfg +35 -35
  16. package/runtime/backends/library/registry.py +77 -77
  17. package/runtime/backends/library/replay.py +154 -154
  18. package/runtime/backends/packer/answer_media.py +16 -0
  19. package/runtime/backends/packer/deploy-hyperv.ps1 +10 -0
  20. package/runtime/backends/packer/drivers.py +49 -0
  21. package/runtime/backends/packer/hyperv-network.ps1 +10 -0
  22. package/runtime/backends/packer/images.py +75 -0
  23. package/runtime/backends/packer/osinfo.py +113 -0
  24. package/runtime/backends/packer/policy.json +15 -0
  25. package/runtime/backends/packer/runner.py +224 -0
  26. package/runtime/backends/packer/templates.py +118 -0
  27. package/runtime/backends/packer/toolchain.py +80 -0
  28. package/runtime/backends/remote_ssh/server.mjs +321 -94
  29. package/runtime/backends/virtualbox/desktop.cjs +37 -0
  30. package/runtime/backends/virtualbox/display.py +101 -101
  31. package/runtime/backends/virtualbox/history.py +139 -139
  32. package/runtime/backends/virtualbox/mouse_click.py +15 -15
  33. package/runtime/backends/virtualbox/mouse_move.py +18 -18
  34. package/runtime/backends/virtualbox/profiles.json +46 -46
  35. package/runtime/backends/virtualbox/provision.py +238 -184
  36. package/runtime/backends/virtualbox/recording_listener.py +29 -29
  37. package/runtime/backends/virtualbox/recordings.py +39 -39
  38. package/runtime/backends/virtualbox/requirements.txt +7 -7
  39. package/runtime/backends/virtualbox/rpas/debian_first_boot/manifest.json +1 -1
  40. package/runtime/backends/virtualbox/rpas/debian_first_boot/run.robot +13 -13
  41. package/runtime/backends/virtualbox/rpas/debian_first_boot/workflow.py +75 -75
  42. package/runtime/backends/virtualbox/rpas/observe/manifest.json +7 -7
  43. package/runtime/backends/virtualbox/rpas/observe/run.robot +13 -13
  44. package/runtime/backends/virtualbox/rpas/observe/workflow.py +14 -14
  45. package/runtime/backends/virtualbox/server.mjs +440 -63
  46. package/runtime/backends/virtualbox/setup_windows_sdk.py +58 -58
  47. package/runtime/backends/virtualbox/shares.py +68 -68
  48. package/runtime/backends/virtualbox/snapshots.py +53 -53
  49. package/runtime/backends/virtualbox/transfers.py +89 -89
  50. package/runtime/backends/virtualbox/vnc.py +61 -61
  51. package/runtime/guest_keys.py +13 -13
  52. package/runtime/guest_setup/http/debian-preseed.cfg +39 -0
  53. package/runtime/guest_setup/http/postdeb.sh +94 -0
  54. package/runtime/guest_setup/http/postwin.ps1 +53 -0
  55. package/runtime/guest_setup/http/setup-all.ps1 +25 -0
  56. package/runtime/guest_setup/http/setup-win.cmd +7 -0
  57. package/runtime/guest_setup/http/setup.ps1 +44 -0
  58. package/runtime/guest_setup/http/setup.sh +50 -0
  59. package/runtime/guest_setup/kvm/setup-debian.sh +73 -0
  60. package/runtime/guest_setup/kvm/setup-windows.ps1 +52 -0
  61. package/runtime/guest_setup/recorder/README.txt +12 -8
  62. package/runtime/guest_setup/recorder/RECORDER-LICENSE +674 -674
  63. package/runtime/guest_setup/recorder/RECORDING-GUIDE.txt +31 -31
  64. package/runtime/guest_setup/recorder/apply-display.py +41 -41
  65. package/runtime/guest_setup/recorder/configure-debian-mirrors.py +62 -62
  66. package/runtime/guest_setup/recorder/configure-gdm.py +23 -0
  67. package/runtime/guest_setup/recorder/configure-session.ps1 +14 -0
  68. package/runtime/guest_setup/recorder/gnome-display.py +60 -60
  69. package/runtime/guest_setup/recorder/install-display-startup.py +66 -39
  70. package/runtime/guest_setup/recorder/install-hypervisor-drivers.ps1 +34 -0
  71. package/runtime/guest_setup/recorder/install-resolution-shortcut.ps1 +36 -0
  72. package/runtime/guest_setup/recorder/postwin.cmd +10 -10
  73. package/runtime/guest_setup/recorder/prepare-recording.py +30 -30
  74. package/runtime/guest_setup/recorder/recorder.zip +0 -0
  75. package/runtime/guest_setup/recorder/requirements-recorder.txt +2 -2
  76. package/runtime/guest_setup/recorder/session-policy.py +22 -0
  77. package/runtime/guest_setup/recorder/setup-user.py +53 -35
  78. package/runtime/guest_setup/recorder/setup-win.cmd +4 -11
  79. package/runtime/guest_setup/recorder/setup.ps1 +108 -30
  80. package/runtime/guest_setup/recorder/setup.sh +19 -1
  81. package/runtime/guest_setup/recorder/vamp-recorder.py +148 -148
  82. package/runtime/guest_setup/recorder/verify-recorder.py +4 -4
  83. package/runtime/guest_setup/recorder/windows-display.py +76 -76
  84. package/runtime/guest_setup/requirements.txt +2 -0
  85. package/runtime/guest_setup/setup-all.ps1 +35 -0
  86. package/runtime/guest_setup/setup-all.sh +22 -0
  87. package/runtime/guest_setup/vault/Install-VCRuntime.ps1 +26 -0
  88. package/runtime/guest_setup/vault/setup-guest-vault.ps1 +148 -0
  89. package/runtime/guest_setup/vault/setup-guest-vault.sh +75 -0
  90. package/runtime/recording_converter.py +230 -230
  91. package/runtime/requirements-mcp.txt +11 -11
  92. package/runtime/rpas/README.md +161 -161
  93. package/runtime/rpas/captcha_handoff/manifest.json +27 -27
  94. package/runtime/rpas/captcha_handoff/run.robot +16 -16
  95. package/runtime/rpas/captcha_handoff/workflow.py +11 -11
  96. package/runtime/rpas/common.resource +26 -26
  97. package/runtime/rpas/debian_update/manifest.json +27 -27
  98. package/runtime/rpas/debian_update/run.robot +17 -17
  99. package/runtime/rpas/debian_update/workflow.py +13 -13
  100. package/runtime/rpas/desktop_control/manifest.json +26 -26
  101. package/runtime/rpas/desktop_control/run.robot +27 -27
  102. package/runtime/rpas/desktop_control/workflow.py +51 -51
  103. package/runtime/rpas/firefox_launch/manifest.json +27 -27
  104. package/runtime/rpas/firefox_launch/run.robot +15 -15
  105. package/runtime/rpas/firefox_launch/workflow.py +25 -25
  106. package/runtime/rpas/firefox_naver/manifest.json +27 -27
  107. package/runtime/rpas/firefox_naver/run.robot +21 -21
  108. package/runtime/rpas/firefox_naver/workflow.py +28 -28
  109. package/runtime/rpas/kvm_validation/README.md +11 -11
  110. package/runtime/rpas/kvm_validation/manifest.json +28 -28
  111. package/runtime/rpas/kvm_validation/run.robot +30 -30
  112. package/runtime/rpas/kvm_validation/workflow.py +91 -91
  113. package/runtime/rpas/manifest.schema.json +105 -105
  114. package/runtime/rpas/naver_login/login.robot +25 -25
  115. package/runtime/rpas/naver_login/manifest.json +33 -33
  116. package/runtime/rpas/naver_login/run.robot +20 -20
  117. package/runtime/rpas/naver_login/workflow.py +32 -32
  118. package/runtime/rpas/windows_naver_recorded/README.md +24 -24
  119. package/runtime/rpas/windows_naver_recorded/conversion.json +25 -25
  120. package/runtime/rpas/windows_naver_recorded/manifest.json +28 -28
  121. package/runtime/rpas/windows_naver_recorded/run.robot +37 -37
  122. package/runtime/rpas/windows_naver_recorded/workflow.py +32 -32
  123. package/runtime/scripts/build_recorder_media.py +39 -39
  124. package/runtime/scripts/macos/setup-host.sh +126 -0
  125. package/runtime/scripts/remote_host_setup.sh +7 -4
  126. package/runtime/scripts/script_server.py +571 -0
  127. package/runtime/skills/vamp-rpa-ui-checks/SKILL.md +26 -0
  128. package/runtime/skills/vamp-rpa-ui-checks/agents/openai.yaml +4 -0
  129. package/runtime/skills/vamp-rpa-ui-checks/references/display.md +12 -0
  130. package/runtime/skills/vamp-rpa-ui-checks/references/user-guide.md +49 -0
  131. package/runtime/skills/vamp-ui-cleanup/SKILL.md +15 -0
  132. package/runtime/skills/vamp-ui-cleanup/agents/openai.yaml +4 -0
  133. package/runtime/skills/vamp-ui-validation/SKILL.md +27 -0
  134. package/runtime/skills/vamp-ui-validation/agents/openai.yaml +4 -0
  135. package/runtime/third_party/mcp-virtualbox/scripts/mouse_click.py +65 -65
  136. package/runtime/third_party/pyautogui-recorder/LICENSE +674 -674
  137. package/runtime/third_party/pyautogui-recorder/PROVENANCE.json +16 -16
  138. package/runtime/third_party/pyautogui-recorder/PyAutoGuiRecorder.py +169 -169
  139. package/runtime/third_party/pyautogui-recorder/README.md +53 -53
  140. 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,4 @@
1
+ interface:
2
+ display_name: "VAMP UI Cleanup"
3
+ short_description: "Simplify VAMP controls and English UI copy"
4
+ default_prompt: "Use $vamp-ui-cleanup to simplify the VAMP webview while preserving status and recovery actions."
@@ -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.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "VAMP UI Validation"
3
+ short_description: "Check packaged VSIX UI with isolated fixtures"
4
+ default_prompt: "Use $vamp-ui-validation to verify the packaged VAMP UI and report observable outcomes."
@@ -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()