pi-cursor-bridge 0.1.10 → 0.1.11

package/.codex-plugin/plugin.json

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

package/README.md

@@ -2,12 +2,14 @@
 
 Use Cursor's project index and Agent search from Pi, with compact `path:line` evidence and optional bounded Cursor task execution.
 
+⭐ If Cursor Bridge helps you, please consider giving it a [Star on GitHub](https://github.com/Vanyangyang/cursor-bridge)—it helps others discover the project.
+
 ```powershell
 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.
 
-This Pi package embeds Cursor Bridge 5.8.0. Cursor must be installed and signed in. Current end-to-end compatibility claims remain scoped to the environments documented in the main repository.
+This Pi package embeds Cursor Bridge 5.8.1. 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/master/README.zh-CN.md)
+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

@@ -22604,7 +22604,7 @@ function updateCursorSessionRegistry(filePath, mutator, options = {}) {
 // server.mjs
 init_cursor_ensure_core();
 init_lifecycle_paths();
-var PLUGIN_VERSION = "5.8.0";
+var PLUGIN_VERSION = "5.8.1";
 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);
@@ -22744,11 +22744,6 @@ function summarizeCdpPages(list) {
     page: first && first.url ? String(first.url).slice(0, 60) : ""
   };
 }
-function isBlankAgentsWindow(page) {
-  if (!page || !isAgentsWindowTitle(page.title)) return false;
-  if (page.probeError || !page.capabilities) return true;
-  return page.capabilities.uiFlavor !== "agents_v2" && !page.capabilities.hasWritableInput;
-}
 var NORMAL_AGENTS_PRESENTATION_REFRESH_MS = 5 * 60 * 1e3;
 function shouldRecoverNormalAgentsPresentation({
   runtimeMode,
@@ -22769,25 +22764,6 @@ function shouldRecoverNormalAgentsPresentation({
   if (!Number.isFinite(previousAt)) return true;
   return Number(now) - previousAt >= Math.max(0, Number(refreshMs) || 0);
 }
-async function reloadPageTarget(page, timeoutMs = 5e3) {
-  if (!page || !page.webSocketDebuggerUrl) return false;
-  const c = makeClient(page.webSocketDebuggerUrl);
-  try {
-    await Promise.race([
-      c.ready,
-      new Promise((_, reject) => setTimeout(() => reject(new Error("Timed out connecting to the CDP target")), timeoutMs))
-    ]);
-    await Promise.race([
-      c.send("Page.reload", { ignoreCache: true }),
-      new Promise((_, reject) => setTimeout(() => reject(new Error("Timed out reloading the CDP target")), timeoutMs))
-    ]);
-    return true;
-  } catch {
-    return false;
-  } finally {
-    c.close();
-  }
-}
 async function inspectPageTarget(page) {
   const c = makeClient(page.webSocketDebuggerUrl);
   const probeMs = Number(process.env.CURSOR_BRIDGE_PAGE_PROBE_TIMEOUT || 5e3);
@@ -22807,24 +22783,6 @@ async function inspectPageTarget(page) {
     c.close();
   }
 }
-async function recoverBlankAgentsWindows(inspected) {
-  const pages = Array.isArray(inspected) ? inspected : [];
-  const recovered = [];
-  for (const page of pages) {
-    if (!isBlankAgentsWindow(page)) {
-      recovered.push(page);
-      continue;
-    }
-    const reloaded = await reloadPageTarget(page);
-    if (!reloaded) {
-      recovered.push(page);
-      continue;
-    }
-    await sleep2(800);
-    recovered.push(await inspectPageTarget(page));
-  }
-  return recovered;
-}
 function pagesWithFlavor(pages, flavor) {
   return (Array.isArray(pages) ? pages : []).filter((page) => page && page.capabilities && page.capabilities.uiFlavor === flavor);
 }
@@ -22855,7 +22813,7 @@ async function findPage(options = {}) {
   if (options.targetId && options.preferAgentsV2 !== true && options.preferLegacy !== true) {
     return selectCursorPageCandidate(pages, options);
   }
-  const inspected = await recoverBlankAgentsWindows(await Promise.all(pages.map(inspectPageTarget)));
+  const inspected = await Promise.all(pages.map(inspectPageTarget));
   return selectPageForUiPreference(inspected, options) || pages[0];
 }
 function makeClient(wsUrl) {
@@ -22941,6 +22899,70 @@ var INPUT_PICKER_BODY = `
     .filter(e=>e.offsetParent!==null&&!e.disabled&&e.getAttribute('aria-disabled')!=='true'&&e.getAttribute('contenteditable')!=='false')
     .sort((a,b)=>(b.classList&&b.classList.contains('ui-prompt-input-editor__input')?1:0)-(a.classList&&a.classList.contains('ui-prompt-input-editor__input')?1:0))[0]||null;`;
 var EXPR_VISIBLE = `(function(){${INPUT_PICKER_BODY}return !!pickInput();})()`;
+var CHAT_PANEL_NEXT_STEP = "Complete or close the current Customize/Settings dialog, open Cursor's main Agent/Chat panel or New Chat, then retry the same request.";
+function classifyChatPanelDiagnostic(snapshot = {}) {
+  const evidence = {
+    writableInputVisible: snapshot.writableInputVisible === true || snapshot.hasWritableInput === true,
+    inputCandidateCount: Number.isFinite(Number(snapshot.inputCandidateCount)) ? Number(snapshot.inputCandidateCount) : 0,
+    settingsOrCustomizeVisible: snapshot.settingsOrCustomizeVisible === true,
+    modalVisible: snapshot.modalVisible === true,
+    modalLabel: snapshot.modalLabel ? String(snapshot.modalLabel) : null,
+    signInControlVisible: snapshot.signInControlVisible === true,
+    signInVisible: snapshot.signInVisible === true,
+    agentSurfaceVisible: snapshot.agentSurfaceVisible === true,
+    composerCount: Number.isFinite(Number(snapshot.composerCount)) ? Number(snapshot.composerCount) : 0,
+    visibilityState: String(snapshot.visibilityState || "unknown"),
+    focused: typeof snapshot.focused === "boolean" ? snapshot.focused : null,
+    pageTitle: snapshot.pageTitle ? String(snapshot.pageTitle) : null,
+    probeError: snapshot.probeError ? String(snapshot.probeError) : null,
+    inputStateChanged: snapshot.inputStateChanged === true
+  };
+  let state = "composer_input_unavailable";
+  let needsAction = "open_new_chat";
+  let message = "Cursor shows an Agent/Chat surface, but no writable input was detected.";
+  if (evidence.signInVisible) {
+    state = "sign_in_required";
+    needsAction = "sign_in_to_cursor";
+    message = "Cursor is showing a sign-in surface instead of a writable Agent/Chat input.";
+  } else if (evidence.settingsOrCustomizeVisible) {
+    state = "settings_or_customize_open";
+    needsAction = "complete_or_close_configuration";
+    message = "Cursor is showing Customize/Settings instead of a writable Agent/Chat input.";
+  } else if (evidence.modalVisible) {
+    state = "modal_dialog_open";
+    needsAction = "complete_or_close_dialog";
+    message = "A visible Cursor dialog is blocking access to the Agent/Chat input.";
+  } else if (evidence.probeError || ["hidden", "prerender", "unloaded"].includes(evidence.visibilityState)) {
+    state = "cursor_window_unavailable";
+    needsAction = "make_cursor_window_available";
+    message = "The selected Cursor page is unavailable or not visible.";
+  } else if (evidence.inputStateChanged) {
+    state = "input_state_changed";
+    needsAction = "open_new_chat";
+    message = "Cursor's Agent/Chat input changed while the request was being prepared.";
+  } else if (!evidence.agentSurfaceVisible && evidence.composerCount === 0) {
+    state = "agent_chat_panel_not_open";
+    needsAction = "open_agent_chat_panel";
+    message = "Cursor's main Agent/Chat panel is not open.";
+  }
+  return {
+    schemaVersion: 1,
+    code: "CURSOR_CHAT_PANEL_UNAVAILABLE",
+    state,
+    message,
+    needsAction,
+    nextStep: CHAT_PANEL_NEXT_STEP,
+    retryable: true,
+    evidence
+  };
+}
+function createChatPanelUnavailableError(snapshot) {
+  const uiDiagnostic = classifyChatPanelDiagnostic(snapshot);
+  const error2 = new Error(`${uiDiagnostic.code}: ${uiDiagnostic.message} ${uiDiagnostic.nextStep}`);
+  error2.code = uiDiagnostic.code;
+  error2.uiDiagnostic = uiDiagnostic;
+  return error2;
+}
 function exprFill(text) {
   const js = JSON.stringify(text);
   return `(function(){${INPUT_PICKER_BODY}const inp=pickInput();if(!inp)return 'NO_INPUT';inp.focus();try{const s=getSelection();const r=document.createRange();r.selectNodeContents(inp);s.removeAllRanges();s.addRange(r);}catch(e){}const ok=document.execCommand('insertText',false,${js});try{inp.dispatchEvent(new InputEvent('input',{bubbles:true,inputType:'insertText',data:${js}}));}catch(e){inp.dispatchEvent(new Event('input',{bubbles:true}));}return ok?(inp.innerText||'').slice(0,30):'EXEC_FAIL';})()`;
@@ -23398,17 +23420,44 @@ var REACT_ADAPTER_BODY = `
   const a=findAdapter();`;
 var EXPR_AGENT_ADAPTER_READY = `(function(){${REACT_ADAPTER_BODY}return !!a;})()`;
 var EXPR_PAGE_CAPABILITIES = `(function(){${INPUT_PICKER_BODY}
+  const visible=node=>!!(node&&(node.offsetParent!==null||(typeof node.getClientRects==='function'&&node.getClientRects().length>0)));
+  const label=node=>String(node&&(node.getAttribute&&(
+    node.getAttribute('aria-label')||node.getAttribute('title'))||node.innerText||node.textContent)||'').replace(/\\s+/g,' ').trim();
   const input=pickInput();
+  const inputCandidateCount=[...document.querySelectorAll(${JSON.stringify(CURSOR_INPUT_SELECTOR)})].filter(visible).length;
   const hasV2Sidebar=!!document.querySelector('.glass-sidebar-agent-list-container');
   const hasLegacyInput=!!document.querySelector('.aislash-editor-input');
   const hasLegacyHistory=!!document.querySelector('.compact-agent-history-react-menu-label')||
     [...document.querySelectorAll('button,[role=button],a.action-label,.codicon')].some(e=>/Show Chat History|Chat History|Agent History/i.test((e.getAttribute('aria-label')||'')+' '+(e.getAttribute('title')||'')));
+  const dialogs=[...document.querySelectorAll('[role="dialog"],dialog[open],.monaco-dialog-box,.quick-input-widget')].filter(visible);
+  const dialog=dialogs[dialogs.length-1]||null;
+  const dialogHeading=dialog&&dialog.querySelector('h1,h2,h3,[role="heading"]');
+  const dialogLabel=dialog?String(dialog.getAttribute('aria-label')||dialog.getAttribute('title')||label(dialogHeading)||'').slice(0,120):null;
+  const pageTitle=String(document.title||'').replace(/\\s+/g,' ').trim();
+  const pagePath=String(globalThis.location&&globalThis.location.pathname||'');
+  const headings=[...document.querySelectorAll('h1,h2,h3,[role="heading"]')]
+    .filter(node=>visible(node)&&!node.closest('.markdown-root,.composer-messages-container,.composer-react-transcript-root,.aichat-container'))
+    .map(label).filter(Boolean).slice(0,40);
+  const configurationText=[pageTitle,pagePath,...headings,label(dialogHeading)].join(' ');
+  const configurationSelector='.ui-customize-view,.settings-editor,.settings-body,.preferences-editor,[class*="settings-editor"],[class*="preferences-editor"],[data-testid*="customize"]';
+  const settingsOrCustomizeVisible=[...document.querySelectorAll(configurationSelector)].some(visible)||/(?:settings?|customize|preferences|\u8BBE\u7F6E|\u8A2D\u5B9A|\u81EA\u5B9A\u4E49|\u81EA\u8A02)/i.test(configurationText);
+  const authControls=[...document.querySelectorAll('button,a,[role="button"],[role="link"]')]
+    .filter(node=>visible(node)&&!node.closest('.markdown-root,.composer-messages-container,.composer-react-transcript-root'));
+  const signInPattern=/(?:sign|log)\\s*in(?:\\s+to\\s+cursor)?|authenticate(?:\\s+cursor)?|continue with (?:google|github|email|sso)|\u767B\u5F55|\u767B\u5165/i;
+  const signInControlVisible=authControls.some(node=>signInPattern.test(label(node)));
+  const signInVisible=authControls.some(node=>signInPattern.test(label(node))&&!node.closest(configurationSelector));
+  const composerCount=[...document.querySelectorAll('.composer-bar[data-composer-id],.composer-bar,.ui-prompt-input-root')].filter(visible).length;
+  const agentSurfaceVisible=composerCount>0||[...document.querySelectorAll('.glass-sidebar-agent-list-container,.compact-agent-history-react-menu-label,.aichat-container')].some(visible)||authControls.some(node=>/(?:New (?:Agent|Chat)|(?:Chat|Agent) History)/i.test(label(node)));
   const uiFlavor=hasV2Sidebar||(input&&input.classList&&input.classList.contains('ui-prompt-input-editor__input'))?'agents_v2':hasLegacyInput?'legacy':'unknown';
   return JSON.stringify({
-    hasWritableInput:!!input,uiFlavor,
+    hasWritableInput:!!input,inputCandidateCount,uiFlavor,
     agentAdapterKind:hasV2Sidebar?'agents_v2':hasLegacyHistory?'legacy':'none',
     hasComposer:!!document.querySelector('.composer-bar[data-composer-id]'),
-    visible:document.visibilityState==='visible',focused:typeof document.hasFocus==='function'&&document.hasFocus(),documentTitle:String(document.title||'')
+    modalVisible:!!dialog,modalLabel:dialogLabel,
+    settingsOrCustomizeVisible,signInControlVisible,signInVisible,agentSurfaceVisible,composerCount,
+    visibilityState:String(document.visibilityState||'unknown'),
+    visible:document.visibilityState==='visible',focused:typeof document.hasFocus==='function'&&document.hasFocus(),
+    documentTitle:pageTitle,pageTitle:pageTitle.slice(0,160)
   });
 })()`;
 var EXPR_HISTORY_ENTRIES = `(function(){${REACT_ADAPTER_BODY}
@@ -23826,6 +23875,7 @@ var CursorBridge = class {
         status: outcome,
         finishedAt: job.finishedAt || now,
         error: job.error || null,
+        uiDiagnostic: job.uiDiagnostic || null,
         terminalEvidence: job.terminalEvidence || null,
         resultUnavailable: job.resultUnavailable === true
       };
@@ -24426,6 +24476,7 @@ var CursorBridge = class {
       resultUnavailable: false,
       terminalEvidence: null,
       providerError: null,
+      uiDiagnostic: null,
       sendState: "not_sent",
       reservationScope: null,
       controlTail: Promise.resolve(),
@@ -24460,6 +24511,7 @@ var CursorBridge = class {
     const e = error2 instanceof Error ? error2 : new Error(String(error2));
     job.error = e.message;
     if (e.providerError) job.providerError = e.providerError;
+    if (e.uiDiagnostic) job.uiDiagnostic = e.uiDiagnostic;
     if (e.terminalEvidence) job.terminalEvidence = e.terminalEvidence;
     job.status = "failed";
     job.phase = "failed";
@@ -24770,6 +24822,7 @@ var CursorBridge = class {
         await this._applyModelPreference(c, options.modelPreference, options);
         this._throwIfCancelledBeforeSend(options);
         const filled = await evalJS(c, exprFill(prompt));
+        if (filled === "NO_INPUT") await this._throwChatPanelUnavailableAfterNoInput(c);
         if (filled === "NO_INPUT" || filled === "EXEC_FAIL") throw new Error("Failed to enter the query because the input state was invalid");
         await sleep2(450);
         this._throwIfCancelledBeforeSend(options);
@@ -24985,19 +25038,24 @@ var CursorBridge = class {
     if (job) job.modelSelection = result;
     return result;
   }
-  async _ensureChatPanel(c) {
-    let vis = await evalJS(c, EXPR_VISIBLE);
-    if (!vis) {
-      await chord(c, 2, "L", "KeyL", 76);
-      await sleep2(1300);
-      vis = await evalJS(c, EXPR_VISIBLE);
-    }
-    if (!vis) {
-      await chord(c, 2, "I", "KeyI", 73);
-      await sleep2(1300);
-      vis = await evalJS(c, EXPR_VISIBLE);
+  async _readChatPanelDiagnostic(c) {
+    try {
+      return JSON.parse(await evalJS(c, EXPR_PAGE_CAPABILITIES) || "{}");
+    } catch (error2) {
+      return { probeError: error2 instanceof Error ? error2.message : String(error2) };
     }
-    if (!vis) throw new Error("Unable to open the Cursor chat or agent input panel. Confirm that Cursor is signed in and its window is available.");
+  }
+  async _ensureChatPanel(c) {
+    const snapshot = await this._readChatPanelDiagnostic(c);
+    if (snapshot.modalVisible !== true && snapshot.hasWritableInput === true) return snapshot;
+    throw createChatPanelUnavailableError(snapshot);
+  }
+  async _throwChatPanelUnavailableAfterNoInput(c) {
+    const snapshot = await this._readChatPanelDiagnostic(c);
+    throw createChatPanelUnavailableError({
+      ...snapshot,
+      inputStateChanged: snapshot.hasWritableInput === true
+    });
   }
   // 清空对话上下文：定位 "New Agent" 钮后【Alt+click】——Alt 修饰使其执行 Replace Agent（清空旧对话），
   // 而非新建（aria 标注 "New Agent (Ctrl+N) / [Alt] Replace Agent"）。2026-06-08 实测回复区 markdown DOM 清空
@@ -25235,6 +25293,7 @@ var CursorBridge = class {
       await this._applyModelPreference(c, job.modelPreference, job);
       this._throwIfCancelledBeforeSend(job);
       const filled = await evalJS(c, exprFill(job.prompt));
+      if (filled === "NO_INPUT") await this._throwChatPanelUnavailableAfterNoInput(c);
       if (filled === "NO_INPUT" || filled === "EXEC_FAIL") throw new Error("Failed to enter the parallel_agent task");
       await sleep2(350);
       this._throwIfCancelledBeforeSend(job);
@@ -25354,6 +25413,7 @@ var CursorBridge = class {
       job.responseBaseline = await this._captureSessionResponseBaseline(c);
       const providerErrorBaseline = providerErrorSignature(await this._readProviderError(c));
       const filled = await evalJS(c, exprFill(job.prompt));
+      if (filled === "NO_INPUT") await this._throwChatPanelUnavailableAfterNoInput(c);
       if (filled === "NO_INPUT" || filled === "EXEC_FAIL") {
         throw cursorSessionError("SESSION_INPUT_FAILED", "failed to enter the continued task");
       }
@@ -26197,6 +26257,7 @@ var CursorBridge = class {
       resultUnavailable: job.resultUnavailable,
       terminalEvidence: job.terminalEvidence,
       providerError: job.providerError,
+      uiDiagnostic: job.uiDiagnostic,
       sendState: job.sendState,
       reservationScope: job.reservationScope,
       reservationHeld: this.activeParallel.has(job.id),
@@ -26412,6 +26473,21 @@ async function ensureBridgeCursor(targetBridge, reason) {
   }
   return r;
 }
+function toolErrorResult(error2) {
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  if (error2 && error2.uiDiagnostic) {
+    const payload = {
+      error: { code: error2.code || error2.uiDiagnostic.code || "CURSOR_BRIDGE_ERROR", message },
+      uiDiagnostic: error2.uiDiagnostic
+    };
+    return {
+      content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+      structuredContent: payload,
+      isError: true
+    };
+  }
+  return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
   tools: buildToolDefinitions(bridge)
 }));
@@ -26513,7 +26589,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request2) => {
     }
     throw new Error(`Unknown tool: ${name}`);
   } catch (error2) {
-    return { content: [{ type: "text", text: `Error: ${error2 instanceof Error ? error2.message : String(error2)}` }], isError: true };
+    return toolErrorResult(error2);
   }
 });
 async function main() {
@@ -26560,7 +26636,9 @@ export {
   bridge,
   buildContextEnginePrompt,
   buildToolDefinitions,
+  classifyChatPanelDiagnostic,
   classifyParallelTerminalIcon,
+  createChatPanelUnavailableError,
   createProviderError,
   cursorStartupBehavior,
   exprClickBoundComposerStop,
@@ -26569,7 +26647,6 @@ export {
   exprFill,
   exprInspectWorkspaceRepository,
   exprOpenAgent,
-  isBlankAgentsWindow,
   isConfirmedCompletedReply,
   isDurablyRegisteredParallelEntry,
   isSessionTurnReplyReady,
@@ -26597,6 +26674,7 @@ export {
   shouldRecoverNormalAgentsPresentation,
   shouldScheduleParallelOriginRestore,
   summarizeCdpPages,
+  toolErrorResult,
   uncertainSubmissionReservationScope,
   updateStableEntryObservation
 };

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.1.10",
+  packageVersion: "0.1.11",
   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.1.10",
+  "version": "0.1.11",
   "description": "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": "5.8.0"
+    "embeddedProductVersion": "5.8.1"
   }
 }