@weavetab/mcp 2.5.0-beta.5 → 2.5.0

package/docs/cli/cli-commands.md

@@ -1,50 +1,50 @@
----
-title: "Commands"
-description: "Reference for every top-level subcommand."
-product: mcp
-section: cli
-icon: ListTree
-slug: cli-commands
----
-
-# Commands
-
-## Server Commands
-
-| Command | Description |
-|---|---|
-| `weavetab` | Start the MCP server (stdio mode — default for MCP clients). When run in a TTY without arguments, launches the interactive UI menu. |
-| `weavetab --ws [--port N]` | Start the WebSocket daemon on `127.0.0.1` (default port `3000`). |
-| `weavetab --version` | Print version and exit. |
-| `weavetab config` | Launch the 6-phase interactive configuration wizard. |
-| `weavetab view` | Display the current active configuration report. Press **[R]** to view raw JSON, **[Q]** to quit. |
-| `weavetab reset` | Purge browser profiles, lockfiles, mutexes, session registries, and kill orphan browser processes. Accepts `--yes`/`-y` to skip confirmation prompts. |
-| `weavetab reload-ext` | Send a reload signal to the Weavetab browser extension via CDP `Runtime.evaluate`. |
-| `weavetab plugin <add\|browse\|search\|list\|remove\|verify>` | Manage plugins — see `weavetab plugin --help`. |
-| `weavetab skills [options]` | Install or update AI agent skills (passthrough to `@weavetab/skills`). |
-| `weavetab help` / `--help` | Show full CLI help message with all commands, flags, and environment variables. |
-
-## Secrets Management
-
-Credentials are stored in `~/.weavetab/secrets.json` (global) or `.weavetab/secrets.json` (project-scoped). Values are never echoed to the terminal.
-
-| Command | Description |
-|---|---|
-| `weavetab secrets set <KEY>` | Store a new encrypted secret. Prompts for value (hidden input) and allowed domains (comma-separated). |
-| `weavetab secrets list` | List all stored secrets (key names only, values hidden). Shows domains and last-updated timestamps. |
-| `weavetab secrets rm <KEY>` | Remove a secret by key name. |
-| `weavetab secrets init --project` | Initialize a project-scoped `.weavetab/secrets.json` file. |
-
-## Interactive TTY Menu
-
-When run without arguments in a TTY terminal, Weavetab opens an interactive keyboard-driven menu:
-
-| Key | Action |
-|---|---|
-| `[C]` | Launch the configuration wizard |
-| `[V]` | View current active configuration |
-| `[P]` | List installed Weavetab plugins |
-| `[R]` | Purge browser profiles and lockfiles |
-| `[H]` | Show help information |
-| `[G]` / `[N]` / `[W]` | Open GitHub / npm / website links |
-| `[Q]` | Exit Weavetab |
+---
+title: "Commands"
+description: "Reference for every top-level subcommand."
+product: mcp
+section: cli
+icon: ListTree
+slug: cli-commands
+---
+
+# Commands
+
+## Server Commands
+
+| Command | Description |
+|---|---|
+| `weavetab` | Start the MCP server (stdio mode — default for MCP clients). When run in a TTY without arguments, launches the interactive UI menu. |
+| `weavetab --ws [--port N]` | Start the WebSocket daemon on `127.0.0.1` (default port `3000`). |
+| `weavetab --version` | Print version and exit. |
+| `weavetab config` | Launch the 6-phase interactive configuration wizard. |
+| `weavetab view` | Display the current active configuration report. Press **[R]** to view raw JSON, **[Q]** to quit. |
+| `weavetab reset` | Purge browser profiles, lockfiles, mutexes, session registries, and kill orphan browser processes. Accepts `--yes`/`-y` to skip confirmation prompts. |
+| `weavetab reload-ext` | Send a reload signal to the Weavetab browser extension via CDP `Runtime.evaluate`. |
+| `weavetab plugin <add\|browse\|search\|list\|remove\|verify>` | Manage plugins — see `weavetab plugin --help`. |
+| `weavetab skills [options]` | Install or update AI agent skills (passthrough to `@weavetab/skills`). |
+| `weavetab help` / `--help` | Show full CLI help message with all commands, flags, and environment variables. |
+
+## Secrets Management
+
+Credentials are stored in `~/.weavetab/secrets.json` (global) or `.weavetab/secrets.json` (project-scoped). Values are never echoed to the terminal.
+
+| Command | Description |
+|---|---|
+| `weavetab secrets set <KEY>` | Store a new encrypted secret. Prompts for value (hidden input) and allowed domains (comma-separated). |
+| `weavetab secrets list` | List all stored secrets (key names only, values hidden). Shows domains and last-updated timestamps. |
+| `weavetab secrets rm <KEY>` | Remove a secret by key name. |
+| `weavetab secrets init --project` | Initialize a project-scoped `.weavetab/secrets.json` file. |
+
+## Interactive TTY Menu
+
+When run without arguments in a TTY terminal, Weavetab opens an interactive keyboard-driven menu:
+
+| Key | Action |
+|---|---|
+| `[C]` | Launch the configuration wizard |
+| `[V]` | View current active configuration |
+| `[P]` | List installed Weavetab plugins |
+| `[R]` | Purge browser profiles and lockfiles |
+| `[H]` | Show help information |
+| `[G]` / `[N]` / `[W]` | Open GitHub / npm / website links |
+| `[Q]` | Exit Weavetab |

package/docs/cli/cli-flags.md

@@ -1,28 +1,28 @@
----
-title: "Flags"
-description: "Global flags accepted by the CLI."
-product: mcp
-section: cli
-icon: Flag
-slug: cli-flags
----
-
-# Flags
-
-Only these flags are parsed by the CLI (`MCP/src/index.ts`). Anything else is ignored.
-
-| Flag | Type | Description |
-|---|---|---|
-| `--help` / `-h` | boolean | Show help message and exit |
-| `help` | command | Show help message and exit |
-| `--version` / `-v` | boolean | Print version and exit |
-| `--ws` | boolean | Start the WebSocket daemon instead of stdio |
-| `--port <port>` / `--port=<port>` | number | Port for the WebSocket daemon (default `3000`) |
-| `--yes` / `-y` | boolean | Skip confirmation prompt when running `weavetab reset` / `reload` |
-| `--official` / `-O` | boolean | Prefer the official `@weavetab/plugin-<name>` candidate (`plugin add`) |
-| `--community` / `-C` | boolean | Prefer the community package candidate (`plugin add`) |
-| `--refresh` | boolean | Invalidate and refresh the verified plugin cache (`plugin`) |
-| `--project` | boolean | Project-scoped secrets file (`secrets init --project`) |
-
-Notes:
-- There are no `--headless` / `--role` CLI flags. Browser headless mode and RBAC role come from `~/.weavetab/config.json` (`weavetab config` / `weavetab view`). The wizard offers `admin` / `operator` / `viewer` / `automation`.
+---
+title: "Flags"
+description: "Global flags accepted by the CLI."
+product: mcp
+section: cli
+icon: Flag
+slug: cli-flags
+---
+
+# Flags
+
+Only these flags are parsed by the CLI (`MCP/src/index.ts`). Anything else is ignored.
+
+| Flag | Type | Description |
+|---|---|---|
+| `--help` / `-h` | boolean | Show help message and exit |
+| `help` | command | Show help message and exit |
+| `--version` / `-v` | boolean | Print version and exit |
+| `--ws` | boolean | Start the WebSocket daemon instead of stdio |
+| `--port <port>` / `--port=<port>` | number | Port for the WebSocket daemon (default `3000`) |
+| `--yes` / `-y` | boolean | Skip confirmation prompt when running `weavetab reset` / `reload` |
+| `--official` / `-O` | boolean | Prefer the official `@weavetab/plugin-<name>` candidate (`plugin add`) |
+| `--community` / `-C` | boolean | Prefer the community package candidate (`plugin add`) |
+| `--refresh` | boolean | Invalidate and refresh the verified plugin cache (`plugin`) |
+| `--project` | boolean | Project-scoped secrets file (`secrets init --project`) |
+
+Notes:
+- There are no `--headless` / `--role` CLI flags. Browser headless mode and RBAC role come from `~/.weavetab/config.json` (`weavetab config` / `weavetab view`). The wizard offers `admin` / `operator` / `viewer` / `automation`.

package/docs/cli/cli-scripting.md

@@ -1,35 +1,35 @@
----
-title: "Scripting & CI/CD"
-description: "Chain CLI calls in shell scripts and CI."
-product: mcp
-section: cli
-icon: FileCode
-slug: cli-scripting
----
-
-# Scripting & CI/CD
-
-## Shell Scripting
-
-```bash
-# Reset before a fresh test run
-weavetab reset --yes
-
-# List stored secrets
-weavetab secrets list
-
-# List installed plugins
-weavetab plugin list
-
-# Start the MCP server in WebSocket daemon mode for custom scripts
-weavetab --ws --port 3000 &
-```
-
-## CI/CD Pipeline
-
-```bash
-# In GitHub Actions or Docker CI
-npm install -g @weavetab/mcp
-weavetab reset --yes
-weavetab --ws --port 3000 &
-```
+---
+title: "Scripting & CI/CD"
+description: "Chain CLI calls in shell scripts and CI."
+product: mcp
+section: cli
+icon: FileCode
+slug: cli-scripting
+---
+
+# Scripting & CI/CD
+
+## Shell Scripting
+
+```bash
+# Reset before a fresh test run
+weavetab reset --yes
+
+# List stored secrets
+weavetab secrets list
+
+# List installed plugins
+weavetab plugin list
+
+# Start the MCP server in WebSocket daemon mode for custom scripts
+weavetab --ws --port 3000 &
+```
+
+## CI/CD Pipeline
+
+```bash
+# In GitHub Actions or Docker CI
+npm install -g @weavetab/mcp
+weavetab reset --yes
+weavetab --ws --port 3000 &
+```

package/docs/configuration/config-locations.md

@@ -1,23 +1,23 @@
----
-title: "Locations & Merge"
-description: "Two-tier merge: global config → built-in defaults."
-product: mcp
-section: configuration
-icon: FolderTree
-slug: config-locations
----
-
-# Config Locations & Merge Priority
-
-## Priority Tiers
-
-1. **Global** — `~/.weavetab/config.json` (the only config file Weavetab reads)
-2. **Built-in defaults** — defined in `DEFAULT_CONFIG`
-
-## Live Reload
-
-A debounced file watcher (150 ms) reloads the in-memory configuration on change. In-flight tool executions complete on the existing configuration; subsequent calls automatically pick up the new values.
-
-## Corrupt File Quarantine
-
-If a configuration file contains invalid JSON, Weavetab automatically quarantines the file to `config.broken.<timestamp>.json` and safely falls back to the next tier without crashing.
+---
+title: "Locations & Merge"
+description: "Two-tier merge: global config → built-in defaults."
+product: mcp
+section: configuration
+icon: FolderTree
+slug: config-locations
+---
+
+# Config Locations & Merge Priority
+
+## Priority Tiers
+
+1. **Global** — `~/.weavetab/config.json` (the only config file Weavetab reads)
+2. **Built-in defaults** — defined in `DEFAULT_CONFIG`
+
+## Live Reload
+
+A debounced file watcher (150 ms) reloads the in-memory configuration on change. In-flight tool executions complete on the existing configuration; subsequent calls automatically pick up the new values.
+
+## Corrupt File Quarantine
+
+If a configuration file contains invalid JSON, Weavetab automatically quarantines the file to `config.broken.<timestamp>.json` and safely falls back to the next tier without crashing.

package/docs/configuration/env-variables.md

@@ -1,19 +1,19 @@
----
-title: "Environment Variables"
-description: "Runtime environment variables that override config."
-product: mcp
-section: configuration
-icon: Variable
-slug: env-variables
----
-
-# Environment Variables
-
-Only these two are read at runtime (`MCP/src/config/loader.ts`). Everything else
-(browser path, role, headless, dev mode) lives in `~/.weavetab/config.json`
-— run `weavetab config` to change it.
-
-| Variable | Description |
-|---|---|
-| `WT_AGENT_ID` | Override the auto-generated agent UUID |
-| `WT_PROXY_URL` | Set outbound HTTP/SOCKS proxy server URL |
+---
+title: "Environment Variables"
+description: "Runtime environment variables that override config."
+product: mcp
+section: configuration
+icon: Variable
+slug: env-variables
+---
+
+# Environment Variables
+
+Only these two are read at runtime (`MCP/src/config/loader.ts`). Everything else
+(browser path, role, headless, dev mode) lives in `~/.weavetab/config.json`
+— run `weavetab config` to change it.
+
+| Variable | Description |
+|---|---|
+| `WT_AGENT_ID` | Override the auto-generated agent UUID |
+| `WT_PROXY_URL` | Set outbound HTTP/SOCKS proxy server URL |

package/docs/get-started/setup-wizard.md

@@ -1,27 +1,27 @@
----
-title: "Setup Wizard"
-description: "Interactive wizard that writes a clean config.json."
-product: mcp
-section: get-started
-icon: Wand2
-slug: setup-wizard
----
-
-# Setup Wizard
-
-Run the interactive CLI configuration wizard:
-
-```bash
-weavetab config
-```
-
-The wizard walks through every option across 6 interactive phases. Re-run it at any time to update your saved config.
-
-## Wizard Phases
-
-1. **Phase 1 — Essentials:** Browser path, RBAC role (`admin`, `viewer`, `automation`), headless mode, dev mode, max tabs, actionability timeout, domain block/allow lists.
-2. **Phase 2 — Advanced (optional):** Browser engine selection, timeouts and rate limits, telemetry opt-in, download/proxy directories, domain policy entries.
-3. **Phase 3 — Save Location:** Global (`~/.weavetab/config.json`).
-4. **Phase 4 — MCP Auto-Config:** Auto-detects installed IDEs (Claude Desktop, Cursor, Windsurf) and merges Weavetab into their MCP configuration.
-5. **Phase 5 — Agent Skills:** Optionally installs `@weavetab/skills` for your agent framework.
-6. **Phase 6 — Summary:** Displays full configuration validation report.
+---
+title: "Setup Wizard"
+description: "Interactive wizard that writes a clean config.json."
+product: mcp
+section: get-started
+icon: Wand2
+slug: setup-wizard
+---
+
+# Setup Wizard
+
+Run the interactive CLI configuration wizard:
+
+```bash
+weavetab config
+```
+
+The wizard walks through every option across 6 interactive phases. Re-run it at any time to update your saved config.
+
+## Wizard Phases
+
+1. **Phase 1 — Essentials:** Browser path, RBAC role (`admin`, `viewer`, `automation`), headless mode, dev mode, max tabs, actionability timeout, domain block/allow lists.
+2. **Phase 2 — Advanced (optional):** Browser engine selection, timeouts and rate limits, telemetry opt-in, download/proxy directories, domain policy entries.
+3. **Phase 3 — Save Location:** Global (`~/.weavetab/config.json`).
+4. **Phase 4 — MCP Auto-Config:** Auto-detects installed IDEs (Claude Desktop, Cursor, Windsurf) and merges Weavetab into their MCP configuration.
+5. **Phase 5 — Agent Skills:** Optionally installs `@weavetab/skills` for your agent framework.
+6. **Phase 6 — Summary:** Displays full configuration validation report.

package/docs/troubleshooting/trouble-browser.md

@@ -1,27 +1,27 @@
----
-title: "Browser Issues"
-description: "CDP connection failures, crashes, and extension problems."
-product: mcp
-section: troubleshooting
-icon: MonitorX
-slug: trouble-browser
----
-
-# Browser Connection Issues
-
-## "CDP connection failed" Error
-
-**Causes:**
-- Port 9222 is occupied by another process
-- Chrome was launched without `--remote-debugging-port`
-
-**Fixes:**
-1. Run `weavetab reset --yes` to terminate orphaned browser processes
-2. Verify port availability: `netstat -an | grep 9222`
-3. Restart Weavetab
-
-## Browser Crashes on Launch
-
-**Fixes:**
-1. Run `weavetab reset` to purge corrupted profiles
-2. Run `weavetab config` and set the browser executable path (or `browserPath: "auto"` to detect)
+---
+title: "Browser Issues"
+description: "CDP connection failures, crashes, and extension problems."
+product: mcp
+section: troubleshooting
+icon: MonitorX
+slug: trouble-browser
+---
+
+# Browser Connection Issues
+
+## "CDP connection failed" Error
+
+**Causes:**
+- Port 9222 is occupied by another process
+- Chrome was launched without `--remote-debugging-port`
+
+**Fixes:**
+1. Run `weavetab reset --yes` to terminate orphaned browser processes
+2. Verify port availability: `netstat -an | grep 9222`
+3. Restart Weavetab
+
+## Browser Crashes on Launch
+
+**Fixes:**
+1. Run `weavetab reset` to purge corrupted profiles
+2. Run `weavetab config` and set the browser executable path (or `browserPath: "auto"` to detect)

package/mcp.json

@@ -1,8 +1,8 @@
 {
   "name": "@weavetab/mcp",
-  "mcpName": "io.github.Weavetab/mcp",
-  "version": "2.5.0-beta.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.",
+  "mcpName": "dev.weavetab/mcp",
+  "version": "2.5.0",
+  "description": "The open automation engine for AI agents. Control live browsers and desktop apps locally with instant execution.",
   "icon": "icon.png",
   "author": "fy2ne",
   "license": "AGPL-3.0-only",