pi-cursor-bridge 0.2.8 → 0.2.9

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-bridge",
-  "version": "6.0.8",
+  "version": "6.0.9",
   "description": "Evidence-backed Cursor Context Engine search and bounded Cursor Agent execution, including a UI-suppressed minimal runtime.",
   "author": {
     "name": "Vanyangyang"

package/README.md

@@ -12,6 +12,6 @@ pi install npm:pi-cursor-bridge
 
 Restart Pi after installation. Initialize the current project by asking Pi to initialize Cursor Bridge for the absolute project path, then use it normally. The package includes the `cce-routing` and `cursor-delegate` Skills and registers the native Cursor Bridge MCP tools directly in Pi.
 
-Pi wrapper 0.2.8 embeds Cursor Bridge 6.0.8, including Cursor 3.21 model-provider alias matching and `reasoning_effort` verification for Grok 4.7/high. Its result contract returns a compact receipt for background `cursor_do` work: poll `cursor_status(task_id)` normally, retrieve the terminal raw reply with `cursor_status(task_id, detail="result")`, check `isError` before using its content, and use `detail="full"` only when diagnostics are needed. Cursor must be installed and signed in. Current end-to-end compatibility claims remain scoped to the environments documented in the main repository.
+Pi wrapper 0.2.9 embeds Cursor Bridge 6.0.9, including Cursor 3.21 model-provider alias matching and `reasoning_effort` verification for Grok 4.7/high. Its result contract returns a compact receipt for background `cursor_do` work: poll `cursor_status(task_id)` normally, retrieve the terminal raw reply with `cursor_status(task_id, detail="result")`, check `isError` before using its content, and use `detail="full"` only when diagnostics are needed. Cursor must be installed and signed in. Current end-to-end compatibility claims remain scoped to the environments documented in the main repository.
 
 Full documentation: [English](https://github.com/Vanyangyang/cursor-bridge#readme) · [简体中文](https://github.com/Vanyangyang/cursor-bridge/blob/main/README.zh-CN.md)

package/dist/cursor-bridge.mjs

@@ -3115,7 +3115,6 @@ var require_utils = __commonJS({
     "use strict";
     var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
     var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
-    var isPort = RegExp.prototype.test.bind(/^\d*$/u);
     var isHexPair = RegExp.prototype.test.bind(/^[\da-f]{2}$/iu);
     var isUnreserved = RegExp.prototype.test.bind(/^[\da-z\-._~]$/iu);
     var isPathCharacter = RegExp.prototype.test.bind(/^[A-Za-z0-9\-._~!$&'()*+,;=:@/]$/u);
@@ -3581,12 +3580,8 @@ var require_utils = __commonJS({
         uriTokens.push(host);
       }
       if (typeof component.port === "number" || typeof component.port === "string") {
-        const port = String(component.port);
-        if (!isPort(port)) {
-          throw new TypeError("URI port is malformed.");
-        }
         uriTokens.push(":");
-        uriTokens.push(port);
+        uriTokens.push(String(component.port));
       }
       return uriTokens.length ? uriTokens.join("") : void 0;
     }
@@ -4029,15 +4024,12 @@ var require_fast_uri = __commonJS({
       }
       return false;
     }
-    function isIPLiteral(host) {
-      return host[0] === "[" && host[host.length - 1] === "]";
-    }
     function hasMalformedComponentPercentEncoding(matches) {
       const host = matches[4];
-      return hasMalformedPercentEncoding(matches[3]) || host !== void 0 && !isIPLiteral(host) && hasMalformedPercentEncoding(host) || hasMalformedPercentEncoding(matches[6]) || hasMalformedPercentEncoding(matches[7]) || hasMalformedPercentEncoding(matches[8]);
+      return hasMalformedPercentEncoding(matches[3]) || host !== void 0 && !(host[0] === "[" && host[host.length - 1] === "]") && hasMalformedPercentEncoding(host) || hasMalformedPercentEncoding(matches[6]) || hasMalformedPercentEncoding(matches[7]) || hasMalformedPercentEncoding(matches[8]);
     }
     function canonicalizeHost(parsed, options, schemeHandler, isIP) {
-      if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport) && parsed.host && !isIPLiteral(parsed.host) && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
+      if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport) && parsed.host && parsed.host[0] !== "[" && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
         try {
           parsed.host = new URL("http://" + parsed.host).hostname;
         } catch (e) {
@@ -4124,11 +4116,10 @@ var require_fast_uri = __commonJS({
         if (parsed.host) {
           const ipv4result = isIPv4(parsed.host);
           if (ipv4result === false) {
-            const bracketedIPLiteral = isIPLiteral(parsed.host);
-            const hasIPLiteralBracket = parsed.host.indexOf("[") !== -1 || parsed.host.indexOf("]") !== -1;
+            const bracketedIPLiteral = parsed.host[0] === "[" && parsed.host[parsed.host.length - 1] === "]";
             const ipv6result = normalizeIPv6(parsed.host);
             isIP = ipv6result.isIPV6 || ipv6result.isIPVFuture === true;
-            malformedIPLiteral = hasIPLiteralBracket && (!bracketedIPLiteral || ipv6result.error === true);
+            malformedIPLiteral = bracketedIPLiteral && ipv6result.error === true;
             parsed.host = isIP ? ipv6result.host : ipv6result.host.toLowerCase();
             if (malformedIPLiteral) {
               parsed.error = parsed.error || "URI host is malformed.";
@@ -4151,17 +4142,14 @@ var require_fast_uri = __commonJS({
           parsed.error = parsed.error || "URI is not a " + options.reference + " reference.";
         }
         const schemeHandler = getSchemeHandler(options.scheme || parsed.scheme);
-        if (!malformedIPLiteral) {
-          malformedHost = canonicalizeHost(parsed, options, schemeHandler, isIP);
-        }
-        if (uri.indexOf("%") !== -1 && parsed.host !== void 0 && !malformedIPLiteral) {
-          let host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
-          if (!isIP) {
-            host = normalizePercentEncoding(host.toLowerCase());
-          }
-          parsed.host = reescapeHostDelimiters(host, isIP);
-        }
+        malformedHost = canonicalizeHost(parsed, options, schemeHandler, isIP);
         if (!schemeHandler || schemeHandler && !schemeHandler.skipNormalize) {
+          if (uri.indexOf("%") !== -1) {
+            if (parsed.host !== void 0 && !malformedIPLiteral) {
+              const host = isIP ? parsed.host : normalizePercentEncoding(parsed.host, true);
+              parsed.host = reescapeHostDelimiters(host, isIP);
+            }
+          }
           if (parsed.path) {
             parsed.path = normalizePathEncoding(parsed.path);
           }
@@ -11402,6 +11390,36 @@ import { mkdirSync as mkdirSync6, readFileSync as readFileSync5, renameSync as r
 import { createHash as createHash2 } from "node:crypto";
 import { homedir as homedir6 } from "node:os";
 import { dirname as dirname5, join as join6, resolve as resolve5 } from "node:path";
+import * as startupModule from "node:module";
+function readCursorStartupPreference(options = {}) {
+  let database;
+  try {
+    const { DatabaseSync } = (options.requireImpl || requireOptional)("node:sqlite");
+    const file = join6(dirname5(options.file || cursorWindowStatePath(options)), "state.vscdb");
+    database = new DatabaseSync(file, { readOnly: true });
+    const rows = database.prepare("SELECT key, value FROM ItemTable WHERE key IN (?, ?)").all(STARTUP_PREFERENCE_KEY, LEGACY_STARTUP_PREFERENCE_KEY);
+    const values = new Map(rows.map(({ key, value }) => {
+      try {
+        return [key, JSON.parse(value)];
+      } catch {
+        return [key, value];
+      }
+    }));
+    const preference = values.get(STARTUP_PREFERENCE_KEY);
+    if (["default", "agentWindow", "lastUsedWindows"].includes(preference)) return preference;
+    const legacy = values.get(LEGACY_STARTUP_PREFERENCE_KEY);
+    if (legacy === true || legacy === "true" || legacy === "agentWindow") return "agentWindow";
+    if (legacy === false || legacy === "false" || legacy === "lastUsedWindows") return "lastUsedWindows";
+    return "default";
+  } catch {
+    return null;
+  } finally {
+    try {
+      database?.close();
+    } catch {
+    }
+  }
+}
 function cursorWindowStatePath(options = {}) {
   const env = options.env || process.env;
   const home = options.home || homedir6();
@@ -11431,6 +11449,12 @@ function stateSignature(last) {
   return createHash2("sha256").update(JSON.stringify(last)).digest("hex");
 }
 function readCursorStartupWindow(options = {}) {
+  let preference = null;
+  try {
+    preference = (options.readStartupPreferenceImpl || readCursorStartupPreference)(options);
+  } catch {
+  }
+  if (preference === "agentWindow") return { uiFlavor: "agents_v2", source: "cursor-startup-preference" };
   const file = options.file || cursorWindowStatePath(options);
   const last = nativeWindowState(options);
   try {
@@ -11449,8 +11473,12 @@ function cursorStartupWindowArgs(startupWindow, projectPath) {
   if (startupWindow.uiFlavor !== "legacy") return ["--glass"];
   return ["--classic", ...projectPath ? [projectPath] : ["--new-window"]];
 }
+var requireOptional, STARTUP_PREFERENCE_KEY, LEGACY_STARTUP_PREFERENCE_KEY;
 var init_cursor_startup_window = __esm({
   "cursor-startup-window.mjs"() {
+    requireOptional = startupModule.createRequire(import.meta.url);
+    STARTUP_PREFERENCE_KEY = "cursor/userWindowRestorationPreference";
+    LEGACY_STARTUP_PREFERENCE_KEY = "cursor/userOpenAgentsWindowOnStartupPreference";
   }
 });
 
@@ -22990,7 +23018,7 @@ function updateCursorSessionRegistry(filePath, mutator, options = {}) {
 // server.mjs
 init_cursor_ensure_core();
 init_lifecycle_paths();
-var PLUGIN_VERSION = "6.0.8";
+var PLUGIN_VERSION = "6.0.9";
 var CDP_PORT2 = Number(process.env.CURSOR_BRIDGE_CDP_PORT || 9223);
 var ORIGIN = `http://localhost:${CDP_PORT2}`;
 var QUERY_TIMEOUT = Number(process.env.CURSOR_BRIDGE_TIMEOUT || 3e5);
@@ -23500,11 +23528,20 @@ var EXPR_MODEL_PICKER_TRIGGER = `(function(){
   const text=String(trigger.querySelector('.ui-model-picker__trigger-text,.vscode-model-picker__trigger-text')?.innerText||trigger.innerText||'').replace(/\\s+/g,' ').trim();
   const detail=String(trigger.querySelector('.ui-model-picker__trigger-variant-suffix,.vscode-model-picker__trigger-variant-suffix')?.innerText||'').replace(/\\s+/g,' ').trim();
   const x=Math.round(rect.x+rect.width/2),y=Math.round(rect.y+rect.height/2);
-  let state='ready';
+  let state='ready',occluder=null;
   if(trigger.disabled||trigger.getAttribute('aria-disabled')==='true'||trigger.closest('[inert]')||getComputedStyle(trigger).pointerEvents==='none')state='trigger_disabled';
   else if(!Number.isFinite(x)||!Number.isFinite(y)||rect.width<=0||rect.height<=0||x<0||y<0||x>=innerWidth||y>=innerHeight)state='trigger_offscreen';
-  else {const hit=document.elementFromPoint(x,y);if(!hit||hit!==trigger&&!trigger.contains(hit))state='trigger_occluded';}
-  return JSON.stringify({found:true,state,interactive:state==='ready',expanded:trigger.getAttribute('aria-expanded'),text,detail,x,y,...owner});
+  else {
+    const hit=document.elementFromPoint(x,y);
+    if(!hit||hit!==trigger&&!trigger.contains(hit)){
+      state='trigger_occluded';
+      const menu=hit&&hit.closest('[data-component="menu-popup"]');
+      // A transient Cursor menu can consume/block a click on the composer.
+      // Never dismiss dialogs, arbitrary overlays, or offscreen controls.
+      if(menu&&!hit.closest('[role="dialog"],[aria-modal="true"]'))occluder={kind:'menu',id:menu.getAttribute('id')||null};
+    }
+  }
+  return JSON.stringify({found:true,state,interactive:state==='ready',expanded:trigger.getAttribute('aria-expanded'),occluder,text,detail,x,y,...owner});
 })()`;
 function exprActivateClosedModelPicker(expected) {
   return `(function(){
@@ -23872,19 +23909,24 @@ function exprSelectAgentWorkspace(projectPath) {
     const fail=(state,extra={})=>JSON.stringify({ok:false,state,wanted,...extra,
       nextStep:'Select the exact local workspace '+${JSON.stringify(String(projectPath || ""))}+' in the new Agent project picker before retrying.'});
     if(triggers.length!==1)return fail(triggers.length?'workspace_project_selector_ambiguous':'workspace_project_selector_unavailable',{triggerCount:triggers.length});
-    triggers[0].click();
+    if(triggers[0].getAttribute?.('aria-expanded')!=='true')triggers[0].click();
     await new Promise(resolve=>setTimeout(resolve,350));
-    const menus=[...new Set([...document.querySelectorAll('[data-component="menu-popup"],[role="menu"]')].filter(visible)
+    const readMenus=()=>[...new Set([...document.querySelectorAll('[data-component="menu-popup"],[role="menu"]')].filter(visible)
       .map(menu=>menu.getAttribute('role')==='menu'&&menu.getAttribute('aria-label')==='Select a project'
         ?menu:menu.querySelector('[role="menu"][aria-label="Select a project"]')).filter(visible))];
+    let menus=readMenus();
     if(menus.length!==1)return fail(menus.length?'workspace_project_option_ambiguous':'workspace_project_option_unavailable',{menuCount:menus.length});
-    const rows=[];const seen=new Set();
-    for(const menu of menus){
-      for(const row of menu.querySelectorAll('[data-component="menu-row"][role="menuitem"],[role="option"]')){
-        if(!visible(row)||seen.has(row))continue;seen.add(row);rows.push(row);
+    const readRows=()=>{
+      const rows=[];const seen=new Set();
+      for(const menu of menus){
+        for(const row of menu.querySelectorAll('[data-component="menu-row"][role="menuitem"],[role="option"]')){
+          if(!visible(row)||seen.has(row))continue;seen.add(row);rows.push(row);
+        }
       }
-    }
-    const available=rows.map(row=>String(row.innerText||row.textContent||'').replace(/\s+/g,' ').trim());
+      return rows;
+    };
+    let rows=readRows();
+    let available=rows.map(row=>String(row.innerText||row.textContent||'').replace(/\s+/g,' ').trim());
     const rowWorkspace=row=>{
       const key=Object.keys(row).find(key=>key.startsWith('__reactFiber$'));
       const levels=[];const visited=new Set();
@@ -23944,7 +23986,26 @@ function exprSelectAgentWorkspace(projectPath) {
       const [workspaceId,path]=JSON.parse([...identities][0]);
       return {path,workspaceId,root,currentRoot};
     };
-    const matches=rows.map(row=>({row,identity:rowWorkspace(row)})).filter(match=>match.identity&&match.identity.path===wanted);
+    const findMatches=()=>rows.map(row=>({row,identity:rowWorkspace(row)})).filter(match=>match.identity&&match.identity.path===wanted);
+    let matches=findMatches();
+    if(!matches.length){
+      // Cursor's Recents view omits older registered workspaces. Search the
+      // full path, then apply the same committed local-identity checks.
+      const searches=[...menus[0].querySelectorAll('input[aria-label="Search menu items"]')].filter(visible);
+      if(searches.length===1&&typeof HTMLInputElement!=='undefined'){
+        const setter=Object.getOwnPropertyDescriptor(HTMLInputElement.prototype,'value')?.set;
+        if(setter){
+          setter.call(searches[0],${JSON.stringify(String(projectPath || ""))});
+          searches[0].dispatchEvent(new Event('input',{bubbles:true}));
+          await new Promise(resolve=>setTimeout(resolve,350));
+          menus=readMenus();
+          if(menus.length!==1)return fail(menus.length?'workspace_project_option_ambiguous':'workspace_project_option_unavailable',{menuCount:menus.length});
+          rows=readRows();
+          available=rows.map(row=>String(row.innerText||row.textContent||'').replace(/\s+/g,' ').trim());
+          matches=findMatches();
+        }
+      }
+    }
     if(matches.length!==1)return fail(matches.length?'workspace_project_option_ambiguous':'workspace_project_option_unavailable',{available});
     const selected=matches[0];
     if(selected.identity.root&&selected.identity.root.current!==selected.identity.currentRoot)return fail('workspace_project_option_unavailable',{available});
@@ -25925,6 +25986,7 @@ var CursorBridge = class {
     let trigger = null, snapshot = { open: false, rows: [] };
     let stableSignature = null, stableSince = 0, clicked = false, clickedOwner = null;
     let clickedAt = 0, recoveryAttempted = false, lastPollError = null;
+    let dismissedMenus = 0, dismissalOwner = null;
     const attempts = [];
     do {
       this._throwIfCancelledBeforeSend(job);
@@ -25940,8 +26002,23 @@ var CursorBridge = class {
       }
       this._throwIfCancelledBeforeSend(job);
       const sameOwner = modelPickerOwnerKey(snapshot.owner) === modelPickerOwnerKey(trigger);
+      if (dismissalOwner !== null && dismissalOwner !== modelPickerOwnerKey(trigger)) {
+        attempts.push("owner_changed_after_menu_dismissal");
+        break;
+      }
       if (snapshot.open && trigger.found && sameOwner && (!clicked || clickedOwner === modelPickerOwnerKey(trigger))) return { trigger, ...snapshot };
       if (snapshot.open && !sameOwner && !attempts.includes("owner_changed")) attempts.push("owner_changed");
+      if (!clicked && !snapshot.open && trigger.found && trigger.state === "trigger_occluded" && trigger.expanded === "false" && trigger.occluder?.kind === "menu" && dismissedMenus < 3) {
+        this._throwIfCancelledBeforeSend(job);
+        dismissalOwner = modelPickerOwnerKey(trigger);
+        dismissedMenus++;
+        attempts.push("dismiss_occluding_menu");
+        await c.send("Input.dispatchKeyEvent", { type: "keyDown", key: "Escape", code: "Escape", windowsVirtualKeyCode: 27, nativeVirtualKeyCode: 27 });
+        await c.send("Input.dispatchKeyEvent", { type: "keyUp", key: "Escape", code: "Escape", windowsVirtualKeyCode: 27, nativeVirtualKeyCode: 27 });
+        stableSignature = null;
+        await sleep2(Math.min(150, Math.max(0, deadline - Date.now())));
+        continue;
+      }
       if (!clicked) {
         const interactive = trigger.found && trigger.interactive !== false;
         const signature = interactive ? JSON.stringify([trigger.triggerId, trigger.composerId, trigger.agentId, trigger.x, trigger.y]) : null;

package/dist/cursor-lifecycle-supervisor.mjs

@@ -3713,6 +3713,36 @@ import { mkdirSync, readFileSync, renameSync, writeFileSync, rmSync } from "node
 import { createHash } from "node:crypto";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
+import * as startupModule from "node:module";
+function readCursorStartupPreference(options = {}) {
+  let database;
+  try {
+    const { DatabaseSync } = (options.requireImpl || requireOptional)("node:sqlite");
+    const file = join(dirname(options.file || cursorWindowStatePath(options)), "state.vscdb");
+    database = new DatabaseSync(file, { readOnly: true });
+    const rows = database.prepare("SELECT key, value FROM ItemTable WHERE key IN (?, ?)").all(STARTUP_PREFERENCE_KEY, LEGACY_STARTUP_PREFERENCE_KEY);
+    const values = new Map(rows.map(({ key, value }) => {
+      try {
+        return [key, JSON.parse(value)];
+      } catch {
+        return [key, value];
+      }
+    }));
+    const preference = values.get(STARTUP_PREFERENCE_KEY);
+    if (["default", "agentWindow", "lastUsedWindows"].includes(preference)) return preference;
+    const legacy = values.get(LEGACY_STARTUP_PREFERENCE_KEY);
+    if (legacy === true || legacy === "true" || legacy === "agentWindow") return "agentWindow";
+    if (legacy === false || legacy === "false" || legacy === "lastUsedWindows") return "lastUsedWindows";
+    return "default";
+  } catch {
+    return null;
+  } finally {
+    try {
+      database?.close();
+    } catch {
+    }
+  }
+}
 function cursorWindowStatePath(options = {}) {
   const env = options.env || process.env;
   const home = options.home || homedir();
@@ -3742,6 +3772,12 @@ function stateSignature(last) {
   return createHash("sha256").update(JSON.stringify(last)).digest("hex");
 }
 function readCursorStartupWindow(options = {}) {
+  let preference = null;
+  try {
+    preference = (options.readStartupPreferenceImpl || readCursorStartupPreference)(options);
+  } catch {
+  }
+  if (preference === "agentWindow") return { uiFlavor: "agents_v2", source: "cursor-startup-preference" };
   const file = options.file || cursorWindowStatePath(options);
   const last = nativeWindowState(options);
   try {
@@ -3779,8 +3815,12 @@ function cursorStartupWindowArgs(startupWindow, projectPath) {
   if (startupWindow.uiFlavor !== "legacy") return ["--glass"];
   return ["--classic", ...projectPath ? [projectPath] : ["--new-window"]];
 }
+var requireOptional, STARTUP_PREFERENCE_KEY, LEGACY_STARTUP_PREFERENCE_KEY;
 var init_cursor_startup_window = __esm({
   "cursor-startup-window.mjs"() {
+    requireOptional = startupModule.createRequire(import.meta.url);
+    STARTUP_PREFERENCE_KEY = "cursor/userWindowRestorationPreference";
+    LEGACY_STARTUP_PREFERENCE_KEY = "cursor/userOpenAgentsWindowOnStartupPreference";
   }
 });
 

package/extensions/index.ts

@@ -10,7 +10,7 @@ const hostWorkspaceId = hostCwd.replace(/\\/g, "/").toLowerCase();
 export default createStdioMcpExtension({
   label: "Cursor Bridge",
   clientName: "pi-cursor-bridge",
-  packageVersion: "0.2.8",
+  packageVersion: "0.2.9",
   serverName: "cursor-bridge",
   serverScript: join(packageRoot, "dist", "cursor-bridge.mjs"),
   cwd: hostCwd,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cursor-bridge",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Windows only. Use Cursor Context Engine and bounded, explicitly continuous Cursor Agent execution from the Pi coding agent.",
   "type": "module",
   "license": "MIT",
@@ -47,6 +47,6 @@
   },
   "piPackage": {
     "embeddedProduct": "Cursor Bridge",
-    "embeddedProductVersion": "6.0.8"
+    "embeddedProductVersion": "6.0.9"
   }
 }