@weavetab/mcp 2.5.0-beta.0 → 2.5.0-beta.2

package/dist/tools/plan.js

@@ -1,161 +0,0 @@
-import { logAction } from "../audit/logger.js";
-import { sendToExtension } from "../cdp/helpers.js";
-// In-memory comment store (agent-side)
-const planComments = [];
-let activeGoal = "";
-let activeTasks = [];
-// Dormant Guard (Layer 1)
-let dormantTimer = null;
-const DORMANT_TIMEOUT_MS = 45000;
-function resetDormantGuard(session) {
-    if (dormantTimer)
-        clearTimeout(dormantTimer);
-    dormantTimer = setTimeout(async () => {
-        try {
-            await session.Runtime.evaluate({
-                expression: `(function() { if (typeof window.__wt_plan === 'function') window.__wt_plan('hide'); })()`
-            });
-        }
-        catch { /* session may be dead */ }
-    }, DORMANT_TIMEOUT_MS);
-}
-/** Poll the page for new user comments on plan tasks */
-async function pollComments(session) {
-    try {
-        const { result } = await session.Runtime.evaluate({
-            expression: `(function() {
-        var q = window.__wt_plan_comments || [];
-        if (q.length > 0) { window.__wt_plan_comments = []; return JSON.stringify(q); }
-        return '[]';
-      })()`,
-            returnByValue: true,
-        });
-        if (result?.value && result.value !== '[]') {
-            return JSON.parse(result.value);
-        }
-    }
-    catch { /* non-fatal */ }
-    return [];
-}
-export async function weavePlan(session, options, _config) {
-    const { action, goal, tasks, taskId, status } = options;
-    // Always poll for new user comments from the overlay
-    const newComments = await pollComments(session);
-    for (const c of newComments) {
-        planComments.push(c);
-        const task = activeTasks.find(t => t.id === c.taskId);
-        if (task) {
-            task.comment = c.comment;
-            logAction("browser_plan", "comment", `task ${c.taskId}: ${c.comment}`);
-        }
-    }
-    if (action === "create") {
-        activeGoal = goal || "";
-        activeTasks = tasks || [];
-        // Use sendToExtension for reliable delivery to content script
-        await sendToExtension(session, {
-            type: 'Weavetab_STATE',
-            plan: { action: 'create', goal: activeGoal, tasks: activeTasks },
-        }).catch(() => { });
-        // Also try direct injection as fallback
-        await session.Runtime.evaluate({
-            expression: `(function() {
-        if (typeof window.__wt_plan === 'function') {
-          window.__wt_plan('create', ${JSON.stringify(activeGoal)}, ${JSON.stringify(activeTasks)});
-        }
-      })()`,
-            returnByValue: true,
-        }).catch(() => { });
-        resetDormantGuard(session);
-        logAction("browser_plan", "create", `goal: ${activeGoal}, ${activeTasks.length} tasks`);
-        return { success: true, plan: { goal: activeGoal, tasks: activeTasks } };
-    }
-    if (action === "update") {
-        if (taskId === undefined || !status) {
-            return { success: false, error: "browser_plan update requires taskId and status" };
-        }
-        const task = activeTasks.find(t => t.id === taskId);
-        if (!task) {
-            return { success: false, error: `Task ${taskId} not found` };
-        }
-        task.status = status;
-        // Use sendToExtension for reliable delivery
-        await sendToExtension(session, {
-            type: 'Weavetab_STATE',
-            plan: { action: 'update', goal: activeGoal, tasks: activeTasks },
-        }).catch(() => { });
-        // Also try direct injection as fallback
-        await session.Runtime.evaluate({
-            expression: `(function() {
-        if (typeof window.__wt_plan === 'function') {
-          window.__wt_plan('update', ${JSON.stringify(activeGoal)}, ${JSON.stringify(activeTasks)});
-        }
-      })()`,
-            returnByValue: true,
-        }).catch(() => { });
-        resetDormantGuard(session);
-        logAction("browser_plan", "update", `task ${taskId} \u2192 ${status}`);
-        return { success: true, plan: { goal: activeGoal, tasks: activeTasks } };
-    }
-    if (action === "hide") {
-        if (dormantTimer) {
-            clearTimeout(dormantTimer);
-            dormantTimer = null;
-        }
-        // Use sendToExtension for reliable delivery
-        await sendToExtension(session, {
-            type: 'Weavetab_STATE',
-            plan: { action: 'hide', goal: '', tasks: [] },
-        }).catch(() => { });
-        // Also try direct injection as fallback
-        await session.Runtime.evaluate({
-            expression: `(function() {
-        if (typeof window.__wt_plan === 'function') window.__wt_plan('hide');
-      })()`,
-            returnByValue: true,
-        }).catch(() => { });
-        return { success: true };
-    }
-    if (action === "comments") {
-        return { success: true, comments: planComments.slice(), plan: { goal: activeGoal, tasks: activeTasks } };
-    }
-    return { success: false, error: `Unknown action: ${action}` };
-}
-export function addPlanComment(taskId, comment) {
-    planComments.push({ taskId, comment, time: Date.now() });
-}
-/** Returns current in-memory plan (goal + tasks) — used to re-inject on page navigation */
-export function getActivePlan() {
-    if (!activeGoal && activeTasks.length === 0)
-        return null;
-    return { goal: activeGoal, tasks: activeTasks };
-}
-export function setActivePlan(goal, tasks) {
-    activeGoal = goal || "";
-    activeTasks = tasks || [];
-}
-/** Re-inject plan into a (possibly fresh) page session — used after navigation / reconnect */
-export async function restoreActivePlanIntoPage(session) {
-    if (!activeGoal && activeTasks.length === 0)
-        return;
-    // Use sendToExtension for reliable delivery
-    try {
-        await sendToExtension(session, {
-            type: 'Weavetab_STATE',
-            plan: { action: 'create', goal: activeGoal, tasks: activeTasks },
-        });
-    }
-    catch { /* non-fatal */ }
-    // Also try direct injection as fallback
-    try {
-        await session.Runtime.evaluate({
-            expression: `(function() {
-        if (typeof window.__wt_plan === 'function') {
-          window.__wt_plan('create', ${JSON.stringify(activeGoal)}, ${JSON.stringify(activeTasks)});
-        }
-      })()`,
-            returnByValue: true,
-        });
-    }
-    catch { /* page may not be ready */ }
-}

package/docs/DEV_MODE.md

@@ -1,68 +0,0 @@
-# Weavetab Developer Mode (devMode) & Plugin Profiling Guide
-
-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.
-
----
-
-## Enabling Developer Mode
-
-Developer Mode can be enabled in two ways:
-
-1. **Via Configuration (`~/.weavetab/config.json` or `.weavetab/config.json`)**:
-   ```json
-   {
-     "devMode": true
-   }
-   ```
-
-2. **Via Environment Variable**:
-   ```bash
-   WEAVETAB_DEV=1 node dist/index.js
-   ```
-
----
-
-## What Does `devMode` Add?
-
-When `devMode` is active, Weavetab exposes rich execution metadata, visual debugging tools, and mission logging without altering underlying tool execution behavior.
-
-### 1. `execution_ms` & Tool Performance Profiling
-
-In `devMode`, every tool response automatically includes an **`execution_ms`** field:
-
-```json
-{
-  "success": true,
-  "execution_ms": 14,
-  "result": { ... }
-}
-```
-
-* **Purpose**: Measures the exact millisecond duration required to process and complete that specific tool call.
-* **Essential for Plugin Developers**: Allows community developers building custom Weavetab plugins to profile their handlers, measure bottleneck latency, and optimize tool responsiveness.
-* **Agent Context Awareness**: AI agents and users reading tool outputs can monitor tool performance in real time.
-
-### 2. Extension Visual Overlays & Tool Calls
-
-* **Extension Visuals**: Renders real-time tool execution badges and `toolcalls` counters directly within the extension overlay.
-* **Trajectory & Hitbox Inspection**: Visualizes pointer paths, click target bounding boxes, and action status badges during execution.
-
-### 3. Mission Logs (`/logs/`)
-
-* For every completed mission, Weavetab generates a structured mission log file inside `/logs/` (`~/.weavetab/logs/`).
-* Contains full step-by-step tool traces, `execution_ms` timing distributions, and action histories for auditing and debugging.
-
----
-
-## Plugin Performance Profiling
-
-Developer Mode is especially valuable for community developers creating Weavetab plugin packages.
-
-* **Profiling Custom Tool Handlers**:
-  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.
-* **Manifest & Permissions**:
-  Plugins define their metadata, permissions, and entry points in a `weavetab.json` manifest.
-* **Marketplace Screenshots (`/images/`)**:
-  Plugins can include an `/images` directory with screenshots and logos for display on the official Weavetab Marketplace website (`website/`).
-
-> 📖 For full details on building, packaging, and publishing plugins, see [docs/PLUGINS.md](PLUGINS.md).