@luaward/mcp 0.2.2 → 0.2.4

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/README.md CHANGED
@@ -4,8 +4,8 @@ Official **Luaward Hybrid Model Context Protocol (MCP)** stdio bridge for Claude
4
4
 
5
5
  `@luaward/mcp` connects your AI client to three cooperating layers:
6
6
 
7
- 1. **Luaward Cloud MCP (`https://luaward.com/mcp`)**: full Luau script protection, licensing, live in-game agent recipes (`gui_snapshot`, `remotes`, `search_scripts`, `scripts_read`, `inspect`, `exec`, `spy_start`, `player_state`), and workspace script deployment.
8
- 2. **Potassium Local MCP Bridge (`http://127.0.0.1:8225/mcp`)**: zero-touch auto-inject of the Luaward in-game agent whenever Potassium has an attached Roblox client, local `editor_tabs` sync (with `luaward_scratch.luau` tab reuse to avoid Potassium's unclosable dirty tabs), and local `file_path` loading for `exec`, `create_script`, and `deploy_script`.
7
+ 1. **Luaward Cloud MCP (`https://luaward.com/mcp`)**: full Luau script protection, licensing, live in-game agent recipes (`run_and_collect`, `benchmark_session`, `cleanup_run`, `inspect_session_capabilities`, `ui_controls`, `gui_snapshot`, `remotes`, `search_scripts`, `scripts_read`, `inspect`, `exec`, `spy_start`, `player_state`), and workspace script deployment.
8
+ 2. **Potassium Local MCP Bridge (`http://127.0.0.1:8225/mcp`)**: zero-touch auto-inject of the Luaward in-game agent whenever Potassium has an attached Roblox client, local `editor_tabs` sync (with `luaward_scratch.luau` tab reuse to avoid Potassium's unclosable dirty tabs), and local `file_path` loading for `run_and_collect`, `exec`, `create_script`, and `deploy_script`.
9
9
  3. **Windows Computer Use & OS Lifecycle Automation**: Win32 `SendInput` (Roblox UI hover-wake `dx=1` and Raw Input `WM_INPUT` 3D camera rotation, ScanCode & Unicode keyboard), Windows UI Automation tree inspection (`desktop_ui_tree`), OS PNG screenshots (`desktop_screenshot`), window management (`desktop_window`), Roblox/Potassium process lifecycle & crash recovery (`desktop_launch`), and hybrid in-game `#n` + Win32 clicking (`os_click`).
10
10
 
11
11
  ---
@@ -47,7 +47,7 @@ claude mcp add --transport http luaward https://luaward.com/mcp --header "Author
47
47
  ### Potassium Local Bridge & File Integration
48
48
  - **Zero-Touch Auto-Inject**: When any Cloud in-game tool returns `"no game is connected"`, `@luaward/mcp` checks `http://127.0.0.1:8225/mcp` (`list_clients`), fetches your workspace's `luaward://pair` bootstrapper, injects it via Potassium `execute_script`, waits for the session to connect, and retries your tool call automatically.
49
49
  - **`editor_tabs`**: Manage Potassium tabs and bridge them with Luaward Cloud (`list`, `read`, `open`, `write`, `activate`, `close`, `run_tab`, `sync_tab_to_cloud`, `open_cloud_script_in_tab`, `install_autoexec`). Reuses `luaward_scratch.luau` by default so you do not accumulate unclosable `dirty: true` tabs.
50
- - **Local `file_path` parameter**: Pass `file_path: "./path/to/script.luau"` to `exec`, `create_script`, or `deploy_script` to read large Luau files directly from disk instead of pasting them inside JSON.
50
+ - **Local `file_path` parameter**: Pass `file_path: "./path/to/script.luau"` to `run_and_collect`, `exec`, `create_script`, or `deploy_script` to read large Luau files (up to 4 MB) directly from disk instead of pasting them inside JSON.
51
51
 
52
52
  ### Windows Computer Use & OS Automation Tools
53
53
  - **`desktop_launch`**: `status`, `launch_potassium`, `launch_roblox` (`roblox://experiences/start?placeId=...&gameInstanceId=...` or direct `RobloxPlayerBeta.exe --app --deeplink`), `rejoin` (crash/hang recovery), and `kill_roblox`.
@@ -75,7 +75,7 @@ claude mcp add --transport http luaward https://luaward.com/mcp --header "Author
75
75
  | `--no-auto-inject` / `LUAWARD_AUTO_INJECT=0` | Disable zero-touch Potassium auto-inject | Enabled (`true`) |
76
76
  | `POTASSIUM_AUTOEXEC_DIR` | Custom Potassium `autoexec` / `AUTO EXECUTE` folder for `install_autoexec` | Auto-detected |
77
77
  | `ROBLOX_PLAYER_PATH` / `POTASSIUM_PATH` | Optional explicit paths to `RobloxPlayerBeta.exe` or `Potassium.exe` | Auto-detected |
78
- | `--version`, `-v` | Print package version (`@luaward/mcp/0.2.1`) | - |
78
+ | `--version`, `-v` | Print package version (`@luaward/mcp/0.2.2`) | - |
79
79
  | `--help`, `-h` | Show usage help | - |
80
80
 
81
81
  ---