@weavetab/mcp 2.5.0-beta.1 → 2.5.0-beta.2
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/AGENTS.md +1 -0
- package/LICENSE +2 -2
- package/README.md +208 -43
- package/SECURITY.md +3 -3
- package/TROUBLESHOOTING.md +1 -1
- package/dist/cdp/bridge.d.ts +10 -0
- package/dist/cdp/bridge.js +284 -78
- package/dist/cdp/connector.d.ts +5 -3
- package/dist/cdp/connector.js +188 -71
- package/dist/cdp/lock.d.ts +9 -6
- package/dist/cdp/lock.js +72 -59
- package/dist/cdp/omni_broker.d.ts +1 -0
- package/dist/cdp/omni_broker.js +12 -6
- package/dist/cdp/profiles.d.ts +10 -0
- package/dist/cdp/profiles.js +65 -0
- package/dist/cdp/walker.js +50 -0
- package/dist/cli/plugin.d.ts +0 -2
- package/dist/cli/plugin.js +31 -683
- package/dist/cli/updater.js +2 -2
- package/dist/config/loader.d.ts +25 -6
- package/dist/config/loader.js +133 -20
- package/dist/index.js +48 -52
- package/dist/overlay/ghost.js +2 -2
- package/dist/overlay/injector.js +1 -3
- package/dist/plugin/extension_bridge.d.ts +40 -0
- package/dist/plugin/extension_bridge.js +158 -0
- package/dist/plugin/interface.d.ts +78 -16
- package/dist/plugin/loader.d.ts +4 -0
- package/dist/plugin/loader.js +178 -57
- package/dist/plugin/registry.js +11 -1
- package/dist/plugin/storage.d.ts +51 -0
- package/dist/plugin/storage.js +164 -0
- package/dist/server.js +213 -121
- package/dist/state/session.d.ts +2 -2
- package/dist/state/session.js +33 -13
- package/dist/tools/browser_detect.d.ts +2 -1
- package/dist/tools/browser_detect.js +6 -3
- package/dist/tools/burst.d.ts +1 -0
- package/dist/tools/burst.js +4 -6
- package/dist/tools/click.js +23 -28
- package/dist/tools/clipboard.js +31 -24
- package/dist/tools/navigate.d.ts +1 -1
- package/dist/tools/navigate.js +28 -10
- package/dist/tools/tabs.d.ts +10 -10
- package/dist/tools/tabs.js +47 -39
- package/dist/tools/type.js +2 -2
- package/docs/DOCUMENTATION.md +63 -6
- package/docs/architecture/blind-injection.md +20 -0
- package/docs/architecture/dual-injection.md +32 -0
- package/docs/architecture/overview.md +49 -0
- package/docs/architecture/security.md +35 -0
- package/docs/architecture/transport.md +37 -0
- package/docs/captcha-stealth/captcha-solver.md +75 -0
- package/docs/captcha-stealth/stealth-physics.md +60 -0
- package/docs/cli/cli-commands.md +44 -0
- package/docs/cli/cli-flags.md +20 -0
- package/docs/cli/cli-introduction.md +20 -0
- package/docs/cli/cli-scripting.md +32 -0
- package/docs/cli/g-ide/ide-antigravity.md +24 -0
- package/docs/cli/g-ide/ide-claude-code.md +24 -0
- package/docs/cli/g-ide/ide-claude-desktop.md +32 -0
- package/docs/cli/g-ide/ide-cursor.md +31 -0
- package/docs/cli/g-ide/ide-generic.md +34 -0
- package/docs/cli/g-ide/ide-opencode.md +24 -0
- package/docs/cli/g-ide/ide-vscode-copilot.md +24 -0
- package/docs/cli/g-ide/ide-windsurf.md +24 -0
- package/docs/configuration/config-locations.md +24 -0
- package/docs/configuration/configuration.md +73 -0
- package/docs/configuration/env-variables.md +19 -0
- package/docs/configuration/folders.md +54 -0
- package/docs/desktop-automation/electron-apps.md +162 -0
- package/docs/get-started/installation.md +47 -0
- package/docs/get-started/introduction.md +60 -0
- package/docs/get-started/quickstart.md +54 -0
- package/docs/get-started/setup-wizard.md +26 -0
- package/docs/skills-ecosystem/skills-overview.md +35 -0
- package/docs/skills-ecosystem/skills-recipes.md +36 -0
- package/docs/tools/tools.md +293 -0
- package/docs/troubleshooting/trouble-browser.md +27 -0
- package/docs/troubleshooting/trouble-config.md +20 -0
- package/docs/troubleshooting/trouble-loop.md +31 -0
- package/ext-dist/content.js +0 -1
- package/mcp.json +8 -6
- package/package.json +11 -5
- package/server.json +3 -3
- package/docs/DEV_MODE.md +0 -68
- package/docs/PLUGINS.md +0 -538
- package/docs/TOOLS.md +0 -104
- package/docs/dev_plugin.md +0 -310
package/mcp.json
CHANGED
|
@@ -1,18 +1,20 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@weavetab/mcp",
|
|
3
3
|
"mcpName": "io.github.weavetab/mcp",
|
|
4
|
-
"version": "2.5.0-beta.
|
|
5
|
-
"description": "Weavetab MCP —
|
|
4
|
+
"version": "2.5.0-beta.2",
|
|
5
|
+
"description": "Weavetab MCP — Direct Layer 0 interface for AI agents across web and desktop applications. Direct socket transport, zero wrapper overhead, deterministic state execution.",
|
|
6
6
|
"icon": "icon.png",
|
|
7
7
|
"author": "fy2ne",
|
|
8
8
|
"license": "AGPL-3.0-only",
|
|
9
|
-
"homepage": "https://weavetab
|
|
9
|
+
"homepage": "https://github.com/weavetab/mcp",
|
|
10
10
|
"repository": "https://github.com/weavetab/mcp",
|
|
11
11
|
"keywords": [
|
|
12
12
|
"weavetab",
|
|
13
13
|
"mcp",
|
|
14
14
|
"model context protocol",
|
|
15
15
|
"browser automation",
|
|
16
|
+
"electron automation",
|
|
17
|
+
"desktop automation",
|
|
16
18
|
"chrome devtools protocol",
|
|
17
19
|
"cdp",
|
|
18
20
|
"ai agent",
|
|
@@ -714,10 +716,10 @@
|
|
|
714
716
|
"default": 0,
|
|
715
717
|
"description": "Chrome DevTools Protocol attach port"
|
|
716
718
|
},
|
|
717
|
-
"
|
|
719
|
+
"extension": {
|
|
718
720
|
"type": "boolean",
|
|
719
|
-
"default":
|
|
720
|
-
"description": "
|
|
721
|
+
"default": true,
|
|
722
|
+
"description": "Enable Weavetab Chrome extension integration"
|
|
721
723
|
},
|
|
722
724
|
"maxTabs": {
|
|
723
725
|
"type": "number",
|
package/package.json
CHANGED
|
@@ -1,10 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@weavetab/mcp",
|
|
3
|
-
"version": "2.5.0-beta.
|
|
4
|
-
"description": "
|
|
5
|
-
"author":
|
|
3
|
+
"version": "2.5.0-beta.2",
|
|
4
|
+
"description": "Direct Layer 0 interface for AI agents across web and desktop applications. No WebDriver. No cloud. Pure control.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "fy2ne",
|
|
7
|
+
"email": "hello@fy2ne.me",
|
|
8
|
+
"url": "https://fy2ne.me"
|
|
9
|
+
},
|
|
6
10
|
"license": "AGPL-3.0-only",
|
|
7
|
-
"homepage": "https://
|
|
11
|
+
"homepage": "https://github.com/weavetab/mcp",
|
|
8
12
|
"repository": {
|
|
9
13
|
"type": "git",
|
|
10
14
|
"url": "https://github.com/weavetab/mcp.git"
|
|
@@ -17,6 +21,8 @@
|
|
|
17
21
|
"mcp",
|
|
18
22
|
"model context protocol",
|
|
19
23
|
"browser automation",
|
|
24
|
+
"electron automation",
|
|
25
|
+
"desktop automation",
|
|
20
26
|
"ai agent",
|
|
21
27
|
"claude mcp",
|
|
22
28
|
"cursor mcp",
|
|
@@ -74,7 +80,7 @@
|
|
|
74
80
|
"start": "node dist/index.js",
|
|
75
81
|
"prepublishOnly": "npm run verify && npm run build",
|
|
76
82
|
"test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
|
|
77
|
-
"test:unit": "node --import tsx/esm --test \"tests/unit/cache.test.ts\" \"tests/unit/delta.test.ts\" \"tests/unit/sessionMemory.test.ts\" \"tests/unit/trail.test.ts\" \"tests/unit/walker.test.ts\" \"tests/unit/burst.test.ts\" \"tests/unit/navigate.test.ts\" \"tests/unit/select.test.ts\" \"tests/unit/design_extract.test.ts\" \"tests/unit/plugin.test.ts\"",
|
|
83
|
+
"test:unit": "node --import tsx/esm --test \"tests/unit/cache.test.ts\" \"tests/unit/delta.test.ts\" \"tests/unit/sessionMemory.test.ts\" \"tests/unit/trail.test.ts\" \"tests/unit/walker.test.ts\" \"tests/unit/burst.test.ts\" \"tests/unit/navigate.test.ts\" \"tests/unit/select.test.ts\" \"tests/unit/design_extract.test.ts\" \"tests/unit/plugin.test.ts\" \"tests/unit/electron.test.ts\"",
|
|
78
84
|
"test:e2e": "tsx tests/e2e/smoke_test.ts"
|
|
79
85
|
},
|
|
80
86
|
"dependencies": {
|
package/server.json
CHANGED
|
@@ -2,18 +2,18 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.weavetab/mcp",
|
|
4
4
|
"title": "Weavetab MCP",
|
|
5
|
-
"description": "
|
|
5
|
+
"description": "Direct Layer 0 interface for AI agents across web and desktop applications. No WebDriver. No cloud. Pure control.",
|
|
6
6
|
"repository": {
|
|
7
7
|
"url": "https://github.com/weavetab/mcp",
|
|
8
8
|
"source": "github"
|
|
9
9
|
},
|
|
10
|
-
"version": "2.5.0-beta.
|
|
10
|
+
"version": "2.5.0-beta.2",
|
|
11
11
|
"packages": [
|
|
12
12
|
{
|
|
13
13
|
"registryType": "npm",
|
|
14
14
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
15
15
|
"identifier": "@weavetab/mcp",
|
|
16
|
-
"version": "2.5.0-beta.
|
|
16
|
+
"version": "2.5.0-beta.2",
|
|
17
17
|
"transport": {
|
|
18
18
|
"type": "stdio"
|
|
19
19
|
},
|
package/docs/DEV_MODE.md
DELETED
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
# Weavetab Developer Mode (devMode) & Plugin Profiling Guide
|
|
2
|
-
|
|
3
|
-
This guide explains Developer Mode (`devMode`), how tool execution timing (`execution_ms`) works, and how it empowers **`weavetab-plugin` developers** and AI agents to profile performance.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## Enabling Developer Mode
|
|
8
|
-
|
|
9
|
-
Developer Mode can be enabled in two ways:
|
|
10
|
-
|
|
11
|
-
1. **Via Configuration (`~/.weavetab/config.json` or `.weavetab/config.json`)**:
|
|
12
|
-
```json
|
|
13
|
-
{
|
|
14
|
-
"devMode": true
|
|
15
|
-
}
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
2. **Via Environment Variable**:
|
|
19
|
-
```bash
|
|
20
|
-
WEAVETAB_DEV=1 node dist/index.js
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
---
|
|
24
|
-
|
|
25
|
-
## What Does `devMode` Add?
|
|
26
|
-
|
|
27
|
-
When `devMode` is active, Weavetab exposes rich execution metadata, visual debugging tools, and mission logging without altering underlying tool execution behavior.
|
|
28
|
-
|
|
29
|
-
### 1. `execution_ms` & Tool Performance Profiling
|
|
30
|
-
|
|
31
|
-
In `devMode`, every tool response automatically includes an **`execution_ms`** field:
|
|
32
|
-
|
|
33
|
-
```json
|
|
34
|
-
{
|
|
35
|
-
"success": true,
|
|
36
|
-
"execution_ms": 14,
|
|
37
|
-
"result": { ... }
|
|
38
|
-
}
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
* **Purpose**: Measures the exact millisecond duration required to process and complete that specific tool call.
|
|
42
|
-
* **Essential for Plugin Developers**: Allows community developers building custom Weavetab plugins to profile their handlers, measure bottleneck latency, and optimize tool responsiveness.
|
|
43
|
-
* **Agent Context Awareness**: AI agents and users reading tool outputs can monitor tool performance in real time.
|
|
44
|
-
|
|
45
|
-
### 2. Extension Visual Overlays & Tool Calls
|
|
46
|
-
|
|
47
|
-
* **Extension Visuals**: Renders real-time tool execution badges and `toolcalls` counters directly within the extension overlay.
|
|
48
|
-
* **Trajectory & Hitbox Inspection**: Visualizes pointer paths, click target bounding boxes, and action status badges during execution.
|
|
49
|
-
|
|
50
|
-
### 3. Mission Logs (`/logs/`)
|
|
51
|
-
|
|
52
|
-
* For every completed mission, Weavetab generates a structured mission log file inside `/logs/` (`~/.weavetab/logs/`).
|
|
53
|
-
* Contains full step-by-step tool traces, `execution_ms` timing distributions, and action histories for auditing and debugging.
|
|
54
|
-
|
|
55
|
-
---
|
|
56
|
-
|
|
57
|
-
## Plugin Performance Profiling
|
|
58
|
-
|
|
59
|
-
Developer Mode is especially valuable for community developers creating Weavetab plugin packages.
|
|
60
|
-
|
|
61
|
-
* **Profiling Custom Tool Handlers**:
|
|
62
|
-
When developing a plugin, enabling `devMode` (`WEAVETAB_DEV=1`) allows you to inspect the `execution_ms` timer on every custom tool response to benchmark performance and optimize your code before publishing.
|
|
63
|
-
* **Manifest & Permissions**:
|
|
64
|
-
Plugins define their metadata, permissions, and entry points in a `weavetab.json` manifest.
|
|
65
|
-
* **Marketplace Screenshots (`/images/`)**:
|
|
66
|
-
Plugins can include an `/images` directory with screenshots and logos for display on the official Weavetab Marketplace website (`website/`).
|
|
67
|
-
|
|
68
|
-
> 📖 For full details on building, packaging, and publishing plugins, see [docs/PLUGINS.md](PLUGINS.md).
|