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

package/ext-dist/hud/hud.js

@@ -1,4 +1,4 @@
-"use strict";(()=>{var S={};window.wtState=S;window.addEventListener("message",e=>{let{type:t,...i}=e.data;if(t?.startsWith("RT_")){S[t]=i;return}$(t,i)});function $(e,t){e==="REHYDRATE"&&window.dispatchEvent(new CustomEvent("wt-rehydrate",{detail:t}))}var c=document.getElementById("rt-canvas"),s=c.getContext("2d"),d=window.innerWidth/2,u=window.innerHeight/2,D=d,L=u,v=0,_=0,g="idle",T="",A=!1,E=!0,Y=!1;window.addEventListener("message",function(e){e.data&&(e.data.type==="WT_SIDEPANEL_STATE"&&(A=!!e.data.open,A&&(T="")),e.data.type==="WT_SUPPRESS_THOUGHT_HUD"&&(Y=!0,T=""),e.data.type==="WT_SCRIPTED_PILL_TOGGLE"&&(E=!!e.data.enabled))});var W=[],y=[],N=0,h=0;function F(){c.width=window.innerWidth,c.height=window.innerHeight}window.addEventListener("resize",F);F();var H=.15,P=.6,K=0,x=0,C=0;var U=0,I=0;function M(){let e=window.wtState||{};e.RT_CURSOR_MOVE&&(d=e.RT_CURSOR_MOVE.x,u=e.RT_CURSOR_MOVE.y,g=e.RT_CURSOR_MOVE.phase||"idle",delete e.RT_CURSOR_MOVE),e.RT_CLICK&&(X(e.RT_CLICK.x,e.RT_CLICK.y,"#3b82f6"),g="clicking",C=Date.now(),setTimeout(()=>{g==="clicking"&&(g="idle")},300),delete e.RT_CLICK),e.RT_SCROLL&&(N=e.RT_SCROLL.y,h=e.RT_SCROLL.ratio,delete e.RT_SCROLL);let t=W.length>0||y.length>0||T||g!=="idle"||Math.abs(d-U)>.5||Math.abs(u-I)>.5;if(U=d,I=u,!t){h>0&&h<1&&(s.clearRect(0,0,c.width,c.height),O()),requestAnimationFrame(M);return}s.clearRect(0,0,c.width,c.height),v+=(d-D)*H,_+=(u-L)*H,v*=P,_*=P;let i=Date.now();if(T&&g!=="typing"&&g!=="clicking"){K+=.016,x+=.03;let n=3;d+=Math.sin(x)*n,u+=Math.cos(x*.7)*n,Math.random()<.02&&(x+=.5)}if(g==="clicking"&&i-C<300){let r=(Math.random()-.5)*2.5,w=(Math.random()-.5)*2.5;d+=r,u+=w;let l=(i-C)/50;d+=Math.sin(l)*1,u+=Math.cos(l)*1}D+=v,L+=_,E&&J(),E&&O(),requestAnimationFrame(M)}function X(e,t,i){for(let n=0;n<15;n++){let r=Math.random()*Math.PI*2,w=Math.random()*4+1;W.push({x:e,y:t,vx:Math.cos(r)*w,vy:Math.sin(r)*w,life:1,color:i})}for(let n=0;n<3;n++)setTimeout(()=>{y.push({x:e,y:t,radius:0,alpha:1})},n*100)}function J(){for(let e=y.length-1;e>=0;e--){let t=y[e];if(t.radius+=3,t.alpha-=.015,t.alpha<=0){y.splice(e,1);continue}s.beginPath(),s.arc(t.x,t.y,t.radius,0,Math.PI*2),s.strokeStyle=`rgba(59, 130, 246, ${t.alpha})`,s.lineWidth=3,s.shadowColor="#3b82f6",s.shadowBlur=10,s.stroke()}}function O(){if(h<=0||h>=1)return;let e=4,t=60,i=c.width-e-10,n=10+(c.height-t-20)*h;s.fillStyle="rgba(59, 130, 246, 0.5)",s.beginPath(),s.roundRect(i,n,e,t,2),s.fill()}requestAnimationFrame(M);var p=!0;function B(){window.addEventListener("message",e=>{e.data.type==="TOGGLE_HUD"&&z()}),window.toggleHUD=z}function z(){p=!p;let e=document.getElementById("rt-canvas"),t=document.getElementById("widgets");e&&(e.style.display=p?"block":"none"),t&&(t.style.display=p?"block":"none"),window.parent.postMessage({type:"HUD_STATE_CHANGED",state:{hudVisible:p}},"*")}function G(e){p=e;let t=document.getElementById("rt-canvas"),i=document.getElementById("widgets");t&&(t.style.display=p?"block":"none"),i&&(i.style.display=p?"block":"none")}var b=!1,a=null,o=null,Q="console";function q(){console.log("[Weavetab HUD] Debug menu initialized"),window.addEventListener("message",e=>{console.log("[Weavetab HUD] Received message:",e.data.type),e.data.type==="TOGGLE_DEBUG"&&(console.log("[Weavetab HUD] Toggling debug menu"),V())}),window.toggleDebugMenu=V,console.log("[Weavetab HUD] Debug menu ready - use Ctrl+F3 or WeaveTabHUD.toggleDebugMenu()")}function V(){console.log("[Weavetab HUD] toggleDebugMenu called, current state:",b),b=!b,a||(console.log("[Weavetab HUD] Creating debug menu container"),Z()),a&&(a.style.display=b?"flex":"none",console.log("[Weavetab HUD] Debug menu visibility set to:",b)),window.parent.postMessage({type:"HUD_STATE_CHANGED",state:{debugMenuVisible:b}},"*")}function Z(){a=document.createElement("div"),a.id="wt-debug-menu",a.style.cssText=`
+"use strict";(()=>{var R={};window.wtState=R;window.addEventListener("message",e=>{let{type:t,...o}=e.data;if(t?.startsWith("RT_")){R[t]=o;return}$(t,o)});function $(e,t){e==="REHYDRATE"&&window.dispatchEvent(new CustomEvent("wt-rehydrate",{detail:t}))}var c=document.getElementById("rt-canvas"),s=c.getContext("2d"),g=window.innerWidth/2,u=window.innerHeight/2,D=g,L=u,v=0,T=0,d="idle",S="",_=!0;window.addEventListener("message",function(e){e.data&&e.data.type==="WT_SCRIPTED_PILL_TOGGLE"&&(_=!!e.data.enabled)});var W=[],y=[],q=0,w=0;function O(){c.width=window.innerWidth,c.height=window.innerHeight}window.addEventListener("resize",O);O();var H=.15,A=.6,Y=0,x=0,C=0;var U=0,P=0;function E(){let e=window.wtState||{};e.RT_CURSOR_MOVE&&(g=e.RT_CURSOR_MOVE.x,u=e.RT_CURSOR_MOVE.y,d=e.RT_CURSOR_MOVE.phase||"idle",delete e.RT_CURSOR_MOVE),e.RT_CLICK&&(K(e.RT_CLICK.x,e.RT_CLICK.y,"#3b82f6"),d="clicking",C=Date.now(),setTimeout(()=>{d==="clicking"&&(d="idle")},300),delete e.RT_CLICK),e.RT_SCROLL&&(q=e.RT_SCROLL.y,w=e.RT_SCROLL.ratio,delete e.RT_SCROLL);let t=W.length>0||y.length>0||S||d!=="idle"||Math.abs(g-U)>.5||Math.abs(u-P)>.5;if(U=g,P=u,!t){w>0&&w<1&&(s.clearRect(0,0,c.width,c.height),I()),requestAnimationFrame(E);return}s.clearRect(0,0,c.width,c.height),v+=(g-D)*H,T+=(u-L)*H,v*=A,T*=A;let o=Date.now();if(S&&d!=="typing"&&d!=="clicking"){Y+=.016,x+=.03;let n=3;g+=Math.sin(x)*n,u+=Math.cos(x*.7)*n,Math.random()<.02&&(x+=.5)}if(d==="clicking"&&o-C<300){let r=(Math.random()-.5)*2.5,h=(Math.random()-.5)*2.5;g+=r,u+=h;let l=(o-C)/50;g+=Math.sin(l)*1,u+=Math.cos(l)*1}D+=v,L+=T,_&&N(),_&&I(),requestAnimationFrame(E)}function K(e,t,o){for(let n=0;n<15;n++){let r=Math.random()*Math.PI*2,h=Math.random()*4+1;W.push({x:e,y:t,vx:Math.cos(r)*h,vy:Math.sin(r)*h,life:1,color:o})}for(let n=0;n<3;n++)setTimeout(()=>{y.push({x:e,y:t,radius:0,alpha:1})},n*100)}function N(){for(let e=y.length-1;e>=0;e--){let t=y[e];if(t.radius+=3,t.alpha-=.015,t.alpha<=0){y.splice(e,1);continue}s.beginPath(),s.arc(t.x,t.y,t.radius,0,Math.PI*2),s.strokeStyle=`rgba(59, 130, 246, ${t.alpha})`,s.lineWidth=3,s.shadowColor="#3b82f6",s.shadowBlur=10,s.stroke()}}function I(){if(w<=0||w>=1)return;let e=4,t=60,o=c.width-e-10,n=10+(c.height-t-20)*w;s.fillStyle="rgba(59, 130, 246, 0.5)",s.beginPath(),s.roundRect(o,n,e,t,2),s.fill()}requestAnimationFrame(E);var p=!0;function B(){window.addEventListener("message",e=>{e.data.type==="TOGGLE_HUD"&&F()}),window.toggleHUD=F}function F(){p=!p;let e=document.getElementById("rt-canvas"),t=document.getElementById("widgets");e&&(e.style.display=p?"block":"none"),t&&(t.style.display=p?"block":"none"),window.parent.postMessage({type:"HUD_STATE_CHANGED",state:{hudVisible:p}},"*")}function G(e){p=e;let t=document.getElementById("rt-canvas"),o=document.getElementById("widgets");t&&(t.style.display=p?"block":"none"),o&&(o.style.display=p?"block":"none")}var b=!1,a=null,i=null,X="console";function V(){console.log("[Weavetab HUD] Debug menu initialized"),window.addEventListener("message",e=>{console.log("[Weavetab HUD] Received message:",e.data.type),e.data.type==="TOGGLE_DEBUG"&&(console.log("[Weavetab HUD] Toggling debug menu"),z())}),window.toggleDebugMenu=z,console.log("[Weavetab HUD] Debug menu ready - use Ctrl+F3 or WeaveTabHUD.toggleDebugMenu()")}function z(){console.log("[Weavetab HUD] toggleDebugMenu called, current state:",b),b=!b,a||(console.log("[Weavetab HUD] Creating debug menu container"),J()),a&&(a.style.display=b?"flex":"none",console.log("[Weavetab HUD] Debug menu visibility set to:",b)),window.parent.postMessage({type:"HUD_STATE_CHANGED",state:{debugMenuVisible:b}},"*")}function J(){a=document.createElement("div"),a.id="wt-debug-menu",a.style.cssText=`
     position: fixed;
     top: 50%;
     left: 50%;
@@ -40,25 +40,25 @@
       cursor: pointer;
       font-size: 11px;
       font-family: inherit;
-    `,m.onclick=()=>ee(l.toLowerCase()),t.appendChild(m)}),a.appendChild(t);let n=document.createElement("div");n.id="wt-debug-content",n.style.cssText=`
+    `,m.onclick=()=>Q(l.toLowerCase()),t.appendChild(m)}),a.appendChild(t);let n=document.createElement("div");n.id="wt-debug-content",n.style.cssText=`
     flex: 1;
     overflow-y: auto;
     padding: 12px 16px;
     min-height: 300px;
-  `,o=document.createElement("div"),o.id="wt-debug-console",o.style.cssText=`
+  `,i=document.createElement("div"),i.id="wt-debug-console",i.style.cssText=`
     font-family: 'IBM Plex Mono', monospace;
     font-size: 11px;
     line-height: 1.4;
-  `,o.innerHTML=`
+  `,i.innerHTML=`
     <div style="color: #6b7280;">[Debug Console Ready]</div>
     <div style="color: #6b7280;">Press Ctrl+F3 to close this menu</div>
     <div style="color: #6b7280; margin-top: 8px;">Use browserAsk to test messaging system</div>
-  `,n.appendChild(o),a.appendChild(n);let r=document.createElement("div");r.style.cssText=`
+  `,n.appendChild(i),a.appendChild(n);let r=document.createElement("div");r.style.cssText=`
     padding: 8px 16px;
     border-top: 1px solid #2a2a30;
     display: flex;
     gap: 8px;
-  `,[{label:"Clear",color:"#6b7280",action:()=>te()},{label:"Test Ask",color:"#3b82f6",action:()=>ne()},{label:"Export",color:"#22c55e",action:()=>ie()}].forEach(l=>{let f=document.createElement("button");f.textContent=l.label,f.style.cssText=`
+  `,[{label:"Clear",color:"#6b7280",action:()=>Z()},{label:"Test Ask",color:"#3b82f6",action:()=>ee()},{label:"Export",color:"#22c55e",action:()=>te()}].forEach(l=>{let f=document.createElement("button");f.textContent=l.label,f.style.cssText=`
       padding: 4px 12px;
       background: transparent;
       border: 1px solid ${l.color};
@@ -67,7 +67,7 @@
       cursor: pointer;
       font-size: 10px;
       font-family: inherit;
-    `,f.onclick=l.action,r.appendChild(f)}),a.appendChild(r),document.getElementById("widgets").appendChild(a)}function ee(e){Q=e,a?.querySelectorAll("button[dataset-tab]")?.forEach(i=>{let n=i.dataset.tab===e;i.style.background=n?"#3b82f6":"transparent",i.style.color=n?"#fff":"#9ca3af"}),o&&(e==="console"?o.style.display="block":(o.style.display="none",o.innerHTML=`<div style="color: #6b7280;">[${e.charAt(0).toUpperCase()+e.slice(1)} Tab - Coming Soon]</div>`))}function te(){o&&(o.innerHTML='<div style="color: #6b7280;">[Console Cleared]</div>')}function ne(){R("Testing ask system...","info"),window.parent.postMessage({type:"TEST_ASK_SYSTEM"},"*")}function ie(){if(R("Exporting logs...","info"),o){let e=o.innerText,t=new Blob([e],{type:"text/plain"}),i=URL.createObjectURL(t),n=document.createElement("a");n.href=i,n.download="weavetab-debug-logs.txt",n.click(),URL.revokeObjectURL(i),R("Logs exported successfully","info")}}function R(e,t="info"){if(!o)return;let i={info:"#60a5fa",warn:"#f59e0b",error:"#ef4444"},n=new Date().toLocaleTimeString(),r=document.createElement("div");r.style.cssText=`
+    `,f.onclick=l.action,r.appendChild(f)}),a.appendChild(r),document.getElementById("widgets").appendChild(a)}function Q(e){X=e,a?.querySelectorAll("button[dataset-tab]")?.forEach(o=>{let n=o.dataset.tab===e;o.style.background=n?"#3b82f6":"transparent",o.style.color=n?"#fff":"#9ca3af"}),i&&(e==="console"?i.style.display="block":(i.style.display="none",i.innerHTML=`<div style="color: #6b7280;">[${e.charAt(0).toUpperCase()+e.slice(1)} Tab - Coming Soon]</div>`))}function Z(){i&&(i.innerHTML='<div style="color: #6b7280;">[Console Cleared]</div>')}function ee(){M("Testing ask system...","info"),window.parent.postMessage({type:"TEST_ASK_SYSTEM"},"*")}function te(){if(M("Exporting logs...","info"),i){let e=i.innerText,t=new Blob([e],{type:"text/plain"}),o=URL.createObjectURL(t),n=document.createElement("a");n.href=o,n.download="weavetab-debug-logs.txt",n.click(),URL.revokeObjectURL(o),M("Logs exported successfully","info")}}function M(e,t="info"){if(!i)return;let o={info:"#60a5fa",warn:"#f59e0b",error:"#ef4444"},n=new Date().toLocaleTimeString(),r=document.createElement("div");r.style.cssText=`
     margin-bottom: 4px;
-    color: ${i[t]};
-  `,r.innerHTML=`<span style="color: #6b7280;">[${n}]</span> ${e}`,o.appendChild(r),o.scrollTop=o.scrollHeight}function j(e){b=e,a&&(a.style.display=b?"flex":"none")}var oe=!1;function k(){try{oe=window.parent.__wt_devMode===!0}catch(e){console.log("[Weavetab HUD] Could not check devMode:",e)}}B();q();k();window.addEventListener("message",e=>{e.data.type==="WT_CONFIG_UPDATE"&&k()});window.addEventListener("message",e=>{if(e.data.type==="REHYDRATE"){let t=e.data.state||{};t.hudVisible!==void 0&&G(t.hudVisible),t.debugMenuVisible!==void 0&&j(t.debugMenuVisible),k(),window.dispatchEvent(new CustomEvent("wt-rehydrate",{detail:t}))}});window.WeaveTabHUD={};})();
+    color: ${o[t]};
+  `,r.innerHTML=`<span style="color: #6b7280;">[${n}]</span> ${e}`,i.appendChild(r),i.scrollTop=i.scrollHeight}function j(e){b=e,a&&(a.style.display=b?"flex":"none")}var ne=!1;function k(){try{ne=window.parent.__wt_devMode===!0}catch(e){console.log("[Weavetab HUD] Could not check devMode:",e)}}B();V();k();window.addEventListener("message",e=>{e.data.type==="WT_CONFIG_UPDATE"&&k()});window.addEventListener("message",e=>{if(e.data.type==="REHYDRATE"){let t=e.data.state||{};t.hudVisible!==void 0&&G(t.hudVisible),t.debugMenuVisible!==void 0&&j(t.debugMenuVisible),k(),window.dispatchEvent(new CustomEvent("wt-rehydrate",{detail:t}))}});window.WeaveTabHUD={};})();

package/ext-dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Weavetab Agent",
-  "version": "1.0.63031",
+  "version": "1.0.62054",
   "description": "Native browser agent for Weavetab MCP",
   "permissions": [
     "tabs",
@@ -16,8 +16,7 @@
     "alarms",
     "contextMenus",
     "downloads",
-    "browsingData",
-    "sidePanel"
+    "browsingData"
   ],
   "host_permissions": [
     "<all_urls>"
@@ -25,9 +24,6 @@
   "background": {
     "service_worker": "background.js"
   },
-  "side_panel": {
-    "default_path": "sidepanel.html"
-  },
   "content_scripts": [
     {
       "matches": [

package/ext-dist/styles.css

@@ -1,6 +1,5 @@
 /* ═══════════════════════════════════════════════════════════════
    Weavetab · UI Design System
-   Claude Chrome-inspired sidepanel + floating elements
    ═══════════════════════════════════════════════════════════════ */
 
 /* ── SHARED TOKENS (Light theme default) ─────────────────────── */
@@ -216,3 +215,9 @@
     max-width: 280px !important;
   }
 }
+
+/* ── ACTION RIPPLE ANIMATION ─────────────────────────────────── */
+@keyframes __wt_ripple_expand {
+  0%   { transform: scale(1); opacity: 1; }
+  100% { transform: scale(7.5); opacity: 0; }
+}

package/mcp.json

@@ -1,7 +1,7 @@
 {
   "name": "@weavetab/mcp",
-  "mcpName": "io.github.weavetab/mcp",
-  "version": "2.5.0-beta.2",
+  "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.",
   "icon": "icon.png",
   "author": "fy2ne",
@@ -38,13 +38,15 @@
     "tools": {
       "browser_map": {
         "category": "vision",
-        "description": "Snapshot interactive DOM with stable ref IDs (w:NN). For complex SPAs, use scope or query to constrain tokens. Supports delta temporal diffing (up to 97% token reduction), semantic pruning (dropping hidden elements), AX tree fallback (Shadow DOM traversal), scope filtering, query filtering, and forced rebuilds.",
+        "description": "Snapshot interactive DOM with stable ref IDs (w:NN). For complex SPAs, use scope or query to constrain tokens. Supports delta temporal diffing (up to 97% token reduction), semantic pruning (dropping hidden elements), Set-of-Marks visual grounding (visual: true / \"auto\" for canvas/WebGL pages), AX tree fallback (Shadow DOM traversal), scope filtering, query filtering, and forced rebuilds with automatic loop strike reset (force: true).",
         "features": [
           "Semantic DOM pruning (up to 97% token reduction with delta)",
+          "Set-of-Marks visual grounding (visual: true / \"auto\")",
           "Per-tab snapshot temporal diffing (delta mode)",
           "Shadow DOM / AX tree fallback parsing",
           "Scope and query filtering for complex SPAs",
-          "Framework auto-detection injection"
+          "Framework auto-detection injection",
+          "Loop strike counter reset on forced re-mapping (force: true)"
         ]
       },
       "browser_navigate": {
@@ -59,8 +61,9 @@
       },
       "browser_click": {
         "category": "input",
-        "description": "Click a DOM element. Physical click engine incorporating Bézier curve trajectory kinematics (Ghost Cursor). Multi-stage targeting fallback: ref ID -> selector -> label -> intent -> coordinates -> backendNodeId.",
+        "description": "Click a DOM element. Physical click engine incorporating Bézier curve trajectory kinematics (Ghost Cursor). Multi-stage targeting fallback: mark number (SoM visual grounding) -> ref ID -> selector -> label -> intent -> coordinates -> backendNodeId.",
         "features": [
+          "Direct mark number targeting (mark: N) from visual mode",
           "Bézier curve trajectory kinematics",
           "Humanized acceleration and velocity curves",
           "Multi-stage fallback targeting resolution",
@@ -119,16 +122,18 @@
       },
       "browser_burst": {
         "category": "mission_execution",
-        "description": "Chain multiple tool calls in one round-trip. High-throughput macro execution engine executing serial action pipelines in a single MCP request, bypassing JSON-RPC serialization overhead. Supports macro steps: type_and_send, navigate_and_read, click_and_wait, scroll_and_read, fill_form, drag_and_drop (ref -> end_ref), and hover_and_read.",
+        "description": "HIGH-SPEED MULTI-ACTION PIPELINE: Executes 2 or more sequential browser actions in a single round-trip without waiting for LLM turns between steps. PREFER THIS over individual single-action calls to slash latency and token burn. Supports native primitives (browser_click, browser_fill, browser_type, browser_type_secret, browser_navigate, browser_key, browser_scroll, browser_wait, browser_map) plus compound macros (type_and_send, click_and_wait, navigate_and_read, scroll_and_read, fill_form). If compile_from_history: true is passed, automatically compiles and executes recent successful session trail actions into a burst macro.",
         "features": [
-          "Single-request multi-action pipeline execution",
-          "Compound macro step abstractions (type_and_send, navigate_and_read, click_and_wait, scroll_and_read, fill_form, drag_and_drop, hover_and_read)",
+          "Single-request multi-action pipeline execution with zero intermediate LLM round-trips",
+          "Compound macro abstractions (type_and_send, click_and_wait, navigate_and_read, scroll_and_read, fill_form, drag_and_drop, hover_and_read)",
+          "Automatic session history compilation into replayable burst macros (compile_from_history: true)",
+          "Fail-fast execution guard (stop_on_error: true) to prevent cascading errors",
           "Automatic loop counter reset on execution start"
         ]
       },
       "browser_tabs": {
         "category": "tabs",
-        "description": "Manage browser tabs (open, switch, close, list, consolidate, heal, list_windows, focus_window). Full CRUD lifecycle management for tabs and windows.",
+        "description": "Manage browser and Electron app tabs/windows (open, switch, close, list). Specify 'app' when targeting desktop apps (e.g. app: 'discord') to avoid opening web browser.",
         "features": [
           "Single and batch tab operations",
           "Duplicate tab consolidation",
@@ -147,15 +152,24 @@
           "Heuristic auto-condition resolution"
         ]
       },
+      "browser_captcha": {
+        "category": "safety",
+        "description": "Autonomous zero-API detection and solving of Turnstile, reCAPTCHA, GeeTest, and hCaptcha bot challenges using local CDP behavioral solvers.",
+        "features": [
+          "Zero-API autonomous solving",
+          "Cloudflare Turnstile, reCAPTCHA v2/v3, GeeTest, and hCaptcha support",
+          "Human oversight fallback via wait_for_user"
+        ]
+      },
       "browser_thoughts": {
         "category": "dialog_and_interaction",
-        "description": "Agent-to-user communication layer rendered as a Shadow DOM overlay. Supports 'question' mode (two-way blocking prompt) and 'feedback' mode (one-way green sticky status update). Consolidates former ask/feedback tools.",
+        "description": "Agent-to-user communication layer rendered in the middle down of the page. Supports question mode (interactive prompt with answer submission) and feedback mode (status, observation, decision, or warning update). Supports contextual element anchoring (anchor: 'w:NN') and visual styles ('observation', 'decision', 'warning', 'question').",
         "features": [
-          "Shadow DOM HUD thought bubble overlay",
-          "Feedback mode (asynchronous status notification)",
-          "Question mode (blocking interactive user response)",
-          "Sentence and paragraph user input modes",
-          "Configurable response timeout"
+          "Middle-down floating card HUD with precision dark styling",
+          "Contextual element anchoring (anchor: 'w:NN') with auto-highlighting",
+          "Feedback mode (observation, decision, warning updates)",
+          "Question mode (interactive user response directly on page)",
+          "Configurable auto-fade and response timeout"
         ]
       },
       "browser_pointer": {
@@ -170,7 +184,7 @@
       },
       "browser_select": {
         "category": "input",
-        "description": "Select an option from a native dropdown by visible text or value. Utilizes native property setters and dispatches input/change events for framework compatibility (React, Vue, Angular).",
+        "description": "Select an option from a native dropdown by visible text or value. Uses native property setters and dispatches input/change events for framework compatibility (React, Vue, Angular).",
         "features": [
           "Option matching by visible text or value",
           "Framework-safe prototype property setter invocation",
@@ -189,11 +203,13 @@
       },
       "browser_highlight": {
         "category": "canvas_and_visual",
-        "description": "Highlight an element with a colored overlay. Renders temporary visual CDP overlay highlights over target elements without DOM tree mutations.",
+        "description": "Highlight elements on page. Renders temporary visual overlays over target elements without DOM tree mutations. Supports multi-element consideration overlays (refs: ['w:12', 'w:15']), presentation styles ('consideration', 'target', 'danger', 'success', 'shimmer'), floating badges, and configurable durations.",
         "features": [
-          "CDP visual overlay highlighting",
-          "Configurable overlay color and duration",
-          "Targeting via ref ID, selector, or nodeId"
+          "Multi-candidate consideration overlay (refs array)",
+          "Five visual styles: consideration, target lock, danger, success, shimmer",
+          "Floating label badge display above highlighted elements",
+          "Configurable duration and color override",
+          "Targeting via ref IDs (w:NN), CSS selectors, or CDP backendNodeId"
         ]
       },
       "browser_upload": {
@@ -223,6 +239,17 @@
           "Origin storage purging"
         ]
       },
+      "browser_checkpoint": {
+        "category": "storage_and_cookies",
+        "description": "Snapshot and restore browser state (cookies, localStorage, sessionStorage, and scroll/URL) into named checkpoints to time-travel and rollback failed automation branches.",
+        "features": [
+          "Session state time-travel and rollback",
+          "Cookies backup and restoration (HttpOnly and Secure via CDP)",
+          "LocalStorage and SessionStorage snapshotting",
+          "URL, page title, and viewport scroll position persistence",
+          "Optional lightweight DOM snapshot capture"
+        ]
+      },
       "browser_network_intercept": {
         "category": "network",
         "description": "Intercept/stub network responses (mock APIs, block tracking) and capture raw protocol network telemetry (TLS/SSL certificate metadata, microsecond timing breakdown, and OS-level network failure reasons).",
@@ -369,17 +396,9 @@
           "Automated raw frame cleanup"
         ]
       },
-      "browser_reset_loop_counter": {
-        "category": "wait_and_timing",
-        "description": "Reset the loop detection strike counter to zero when legitimate repetitive actions flag automated safeguards.",
-        "features": [
-          "Atomic strike counter reset",
-          "Explicit reset reason logging"
-        ]
-      },
       "browser_detect": {
         "category": "tabs",
-        "description": "Detect available browsers on the machine and report CDP feature coverage per engine (Chromium, Firefox, WebKit).",
+        "description": "CRITICAL INITIALIZATION TOOL. Detect available browsers and configured desktop apps (Discord, Slack, etc.). Call this FIRST before interacting with the environment to know if apps are online/offline and what tabs they have open.",
         "features": [
           "Local browser engine discovery",
           "Engine CDP API coverage analysis",
@@ -395,60 +414,57 @@
           "Resource loading timing distributions"
         ]
       },
-      "browser_macro_compile": {
-        "category": "macro",
-        "description": "Compile a recent action trail into a reusable browser_burst macro sequence for deterministic replay.",
-        "features": [
-          "Interaction trail analysis and compilation",
-          "Reusable macro structure generation",
-          "Full compatibility with browser_burst engine"
-        ]
-      },
-      "github_analyze": {
-        "category": "github",
-        "description": "Analyze a GitHub repository structure, file tree, and README snippet directly via raw endpoints without API key rate limits.",
+      "browser_pattern_learn": {
+        "category": "memory",
+        "description": "Read (action=get), register (action=learn), update, or record execution outcome for a named workflow pattern on a given origin in ~/.weavetab-system/memory/sites/. Use action=get at session start to inspect site profiles and reliability scores. Use learn after completing a flow to persist it for future fast-path replay.",
         "features": [
-          "Repository metadata parsing",
-          "Directory tree listing",
-          "README payload extraction",
-          "Zero GitHub API token requirement"
+          "Site profile inspection via action=get (reads ~/.weavetab-system/memory/sites/)",
+          "Named pattern creation and update (merge-on-write, no duplicates)",
+          "Volatile selector stabilization before persistence",
+          "EWMA reliability score update on execution outcome",
+          "3-strike degradation and re-learn flagging",
+          "Site quirk registration (cookie_banner, rate_limit, modal_popup)"
         ]
       },
-      "github_read": {
+      "browser_github": {
         "category": "github",
-        "description": "Read file contents from a GitHub repository via raw content endpoints.",
+        "description": "Interact with GitHub repositories without burning browser turns. Analyze repo trees, read raw source files, search/inspect issues, and examine PR diffs and review comments.",
         "features": [
-          "Raw file content retrieval",
-          "Branch, tag, and commit ref targeting",
-          "Line range subset reading"
+          "Action-based repo analysis, file reading, issues, and PR review",
+          "Zero GitHub API token requirement for raw reads",
+          "Automated active tab repository context resolution",
+          "Line range subset reading and issue/PR search"
         ]
       },
-      "github_issues": {
-        "category": "github",
-        "description": "Interact with GitHub issues. List, search, and fetch issue details with comment threads.",
+      "browser_office": {
+        "category": "documents",
+        "description": "Read and extract structured content from office documents (Excel, Word, PDF, CSV) via live browser session cookies or local downloads directory.",
         "features": [
-          "Issue state filtering (open, closed, all)",
-          "Full-text issue search",
-          "Comment thread extraction"
+          "In-session authenticated document fetching",
+          "Structured tabular extraction (.xlsx, .csv)",
+          "Document text and metadata extraction (.docx, .pdf)"
         ]
       },
-      "github_get_pr": {
-        "category": "github",
-        "description": "Interact with GitHub pull requests. Retrieve metadata, changed files, diff summaries, and review comments.",
+      "browser_emulate": {
+        "category": "environment",
+        "description": "Emulate browser environmental conditions over CDP: network throttling profiles, CPU slowdown multipliers, geolocation overrides, timezone IDs, and custom User-Agent strings.",
         "features": [
-          "Pull request metadata parsing",
-          "Changed file list enumeration",
-          "Review comment thread extraction"
+          "Network throttling (Offline, Slow 3G, Fast 3G, 4G)",
+          "CPU throttling multipliers",
+          "Geolocation and timezone overrides"
         ]
       }
     },
     "resources": {
       "session_memory": {
-        "description": "Per-domain persistent profile store (~/.weavetab-system/memory/) tracking detected web frameworks, Shadow DOM utilization, and interaction strategies across sessions.",
+        "description": "Two-tier persistent memory system. Tier 1 (~/.weavetab-system/memory/): per-domain selector confidence cache tracking detected web frameworks, Shadow DOM utilization, and interaction strategies. Tier 2 (~/.weavetab-system/memory/sites/): named workflow patterns with EWMA reliability scores, site quirks (cookie banners, rate limits), and fast-path eligibility flags — all accumulated and refined across sessions.",
         "features": [
           "Framework detection (React, Vue, Angular, Lit, Svelte, Next, Nuxt, Gatsby)",
-          "Successful selector strategy caching",
-          "Interaction history accumulation"
+          "Successful selector strategy caching with confidence decay (Tier 1)",
+          "Named workflow pattern compilation with EWMA reliability scoring (Tier 2)",
+          "Site quirk registration: cookie banners, rate limits, modal popups (Tier 2)",
+          "3-strike pattern degradation with re-learn flagging (Tier 2)",
+          "Fast-path eligibility: patterns with reliability ≥ 0.8 skip exploratory DOM navigation"
         ]
       },
       "knowledge_hints": {
@@ -502,7 +518,7 @@
         ]
       },
       "vision_fallback": {
-        "description": "Local pixel analysis pipeline utilizing sharp for visual layout evaluation when accessibility trees return zero nodes.",
+        "description": "Local pixel analysis pipeline using sharp for visual layout evaluation when accessibility trees return zero nodes.",
         "pipeline": "AX Tree Check -> Screenshot -> Grayscale -> 4x4 Grid Heatmap -> Text Density -> Clickable Region Analysis",
         "features": [
           "Local execution (zero external API dependencies)",
@@ -520,7 +536,7 @@
         "features": [
           "Rolling action window evaluation",
           "Escalating alert tiers",
-          "Manual reset via browser_reset_loop_counter"
+          "Manual reset via browser_map({ force: true }) or browser_wait({ reset_loop: true })"
         ]
       },
       "framework_detection": {
@@ -554,9 +570,9 @@
       "rbac": {
         "description": "Role-Based Access Control enforcing tool execution boundaries based on configured session role.",
         "roles": {
-          "admin": "Full access to all 42 tools and system operations",
+          "admin": "Full access to all 44 tools and system operations",
           "system": "Full tool access excluding system-level operations",
-          "viewer": "Read-only access (browser_map, browser_find, browser_scrape, browser_screenshot, browser_inspect, browser_snapshot, browser_console, browser_pdf, browser_storage, browser_cookies, browser_tabs, browser_wait, github_*)",
+          "viewer": "Read-only access (browser_map, browser_find, browser_scrape, browser_screenshot, browser_inspect, browser_snapshot, browser_console, browser_pdf, browser_storage, browser_cookies, browser_tabs, browser_wait, browser_github)",
           "automation": "Restricted execution set for non-interactive automated workflows"
         }
       },
@@ -771,7 +787,7 @@
     }
   },
   "metadata": {
-    "total_tools": 42,
+    "total_tools": 50,
     "tool_categories": 15,
     "latency": "3-8ms mean",
     "token_efficiency": "Up to 97% reduction via semantic delta engine + DOM pruner",
@@ -786,4 +802,4 @@
       "weavetab"
     ]
   }
-}
+}