@rama_nigg/open-cursor 2.3.5 → 2.3.6

package/README.md

@@ -27,6 +27,9 @@ Add to `~/.config/opencode/opencode.json`:
     "cursor-acp": {
       "name": "Cursor ACP",
       "npm": "@ai-sdk/openai-compatible",
+      "options": {
+        "baseURL": "http://127.0.0.1:32124/v1"
+      },
       "models": {
         "cursor-acp/auto": { "name": "Auto" },
         "cursor-acp/composer-1.5": { "name": "Composer 1.5" },

package/dist/index.js

@@ -17448,13 +17448,13 @@ function createToolLoopGuard(messages, maxRepeat) {
       }
       const strictFingerprint = `${toolCall.function.name}|${argShape}|${errorClass}`;
       const coarseFingerprint = `${toolCall.function.name}|${errorClass}`;
-      return evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerprint, counts, coarseCounts, maxRepeat, coarseMaxRepeat);
+      return evaluateWithFingerprints(toolCall.function.name, errorClass, strictFingerprint, coarseFingerprint, counts, coarseCounts, maxRepeat, coarseMaxRepeat);
     },
     evaluateValidation(toolCall, validationSignature) {
       const normalizedSignature = normalizeValidationSignature(validationSignature);
       const strictFingerprint = `${toolCall.function.name}|schema:${normalizedSignature}|validation`;
       const coarseFingerprint = `${toolCall.function.name}|validation`;
-      return evaluateWithFingerprints("validation", strictFingerprint, coarseFingerprint, validationCounts, validationCoarseCounts, maxRepeat, coarseMaxRepeat);
+      return evaluateWithFingerprints(toolCall.function.name, "validation", strictFingerprint, coarseFingerprint, validationCounts, validationCoarseCounts, maxRepeat, coarseMaxRepeat);
     },
     resetFingerprint(fingerprint) {
       counts.delete(fingerprint);
@@ -17685,7 +17685,7 @@ function normalizeValidationSignature(signature) {
   const normalized = signature.trim().toLowerCase();
   return normalized.length > 0 ? normalized : "invalid";
 }
-function evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerprint, strictCounts, coarseCounts, maxRepeat, coarseMaxRepeat) {
+function evaluateWithFingerprints(toolName, errorClass, strictFingerprint, coarseFingerprint, strictCounts, coarseCounts, maxRepeat, coarseMaxRepeat) {
   if (errorClass === "success") {
     return {
       fingerprint: strictFingerprint,
@@ -17698,9 +17698,20 @@ function evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerpri
   }
   const strictRepeatCount = (strictCounts.get(strictFingerprint) ?? 0) + 1;
   strictCounts.set(strictFingerprint, strictRepeatCount);
+  const strictTriggered = strictRepeatCount > maxRepeat;
+  const isExplorationTool = EXPLORATION_TOOLS.has(toolName.toLowerCase());
+  if (isExplorationTool) {
+    return {
+      fingerprint: strictFingerprint,
+      repeatCount: strictRepeatCount,
+      maxRepeat,
+      errorClass,
+      triggered: strictTriggered,
+      tracked: true
+    };
+  }
   const coarseRepeatCount = (coarseCounts.get(coarseFingerprint) ?? 0) + 1;
   coarseCounts.set(coarseFingerprint, coarseRepeatCount);
-  const strictTriggered = strictRepeatCount > maxRepeat;
   const coarseTriggered = coarseRepeatCount > coarseMaxRepeat;
   const preferCoarseFingerprint = coarseTriggered && !strictTriggered;
   return {
@@ -17791,7 +17802,7 @@ function containsAny(text, patterns) {
 function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var UNKNOWN_AS_SUCCESS_TOOLS, COARSE_LIMIT_MULTIPLIER = 3;
+var UNKNOWN_AS_SUCCESS_TOOLS, EXPLORATION_TOOLS, COARSE_LIMIT_MULTIPLIER = 3;
 var init_tool_loop_guard = __esm(() => {
   UNKNOWN_AS_SUCCESS_TOOLS = new Set([
     "bash",
@@ -17803,9 +17814,19 @@ var init_tool_loop_guard = __esm(() => {
     "ls",
     "glob",
     "stat",
-    "webfetch",
     "mkdir",
-    "rm"
+    "rm",
+    "webfetch",
+    "semsearch",
+    "readlints"
+  ]);
+  EXPLORATION_TOOLS = new Set([
+    "read",
+    "grep",
+    "glob",
+    "ls",
+    "stat",
+    "semsearch"
   ]);
 });
 

package/dist/plugin-entry.js

@@ -17448,13 +17448,13 @@ function createToolLoopGuard(messages, maxRepeat) {
       }
       const strictFingerprint = `${toolCall.function.name}|${argShape}|${errorClass}`;
       const coarseFingerprint = `${toolCall.function.name}|${errorClass}`;
-      return evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerprint, counts, coarseCounts, maxRepeat, coarseMaxRepeat);
+      return evaluateWithFingerprints(toolCall.function.name, errorClass, strictFingerprint, coarseFingerprint, counts, coarseCounts, maxRepeat, coarseMaxRepeat);
     },
     evaluateValidation(toolCall, validationSignature) {
       const normalizedSignature = normalizeValidationSignature(validationSignature);
       const strictFingerprint = `${toolCall.function.name}|schema:${normalizedSignature}|validation`;
       const coarseFingerprint = `${toolCall.function.name}|validation`;
-      return evaluateWithFingerprints("validation", strictFingerprint, coarseFingerprint, validationCounts, validationCoarseCounts, maxRepeat, coarseMaxRepeat);
+      return evaluateWithFingerprints(toolCall.function.name, "validation", strictFingerprint, coarseFingerprint, validationCounts, validationCoarseCounts, maxRepeat, coarseMaxRepeat);
     },
     resetFingerprint(fingerprint) {
       counts.delete(fingerprint);
@@ -17685,7 +17685,7 @@ function normalizeValidationSignature(signature) {
   const normalized = signature.trim().toLowerCase();
   return normalized.length > 0 ? normalized : "invalid";
 }
-function evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerprint, strictCounts, coarseCounts, maxRepeat, coarseMaxRepeat) {
+function evaluateWithFingerprints(toolName, errorClass, strictFingerprint, coarseFingerprint, strictCounts, coarseCounts, maxRepeat, coarseMaxRepeat) {
   if (errorClass === "success") {
     return {
       fingerprint: strictFingerprint,
@@ -17698,9 +17698,20 @@ function evaluateWithFingerprints(errorClass, strictFingerprint, coarseFingerpri
   }
   const strictRepeatCount = (strictCounts.get(strictFingerprint) ?? 0) + 1;
   strictCounts.set(strictFingerprint, strictRepeatCount);
+  const strictTriggered = strictRepeatCount > maxRepeat;
+  const isExplorationTool = EXPLORATION_TOOLS.has(toolName.toLowerCase());
+  if (isExplorationTool) {
+    return {
+      fingerprint: strictFingerprint,
+      repeatCount: strictRepeatCount,
+      maxRepeat,
+      errorClass,
+      triggered: strictTriggered,
+      tracked: true
+    };
+  }
   const coarseRepeatCount = (coarseCounts.get(coarseFingerprint) ?? 0) + 1;
   coarseCounts.set(coarseFingerprint, coarseRepeatCount);
-  const strictTriggered = strictRepeatCount > maxRepeat;
   const coarseTriggered = coarseRepeatCount > coarseMaxRepeat;
   const preferCoarseFingerprint = coarseTriggered && !strictTriggered;
   return {
@@ -17791,7 +17802,7 @@ function containsAny(text, patterns) {
 function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var UNKNOWN_AS_SUCCESS_TOOLS, COARSE_LIMIT_MULTIPLIER = 3;
+var UNKNOWN_AS_SUCCESS_TOOLS, EXPLORATION_TOOLS, COARSE_LIMIT_MULTIPLIER = 3;
 var init_tool_loop_guard = __esm(() => {
   UNKNOWN_AS_SUCCESS_TOOLS = new Set([
     "bash",
@@ -17803,9 +17814,19 @@ var init_tool_loop_guard = __esm(() => {
     "ls",
     "glob",
     "stat",
-    "webfetch",
     "mkdir",
-    "rm"
+    "rm",
+    "webfetch",
+    "semsearch",
+    "readlints"
+  ]);
+  EXPLORATION_TOOLS = new Set([
+    "read",
+    "grep",
+    "glob",
+    "ls",
+    "stat",
+    "semsearch"
   ]);
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rama_nigg/open-cursor",
-  "version": "2.3.5",
+  "version": "2.3.6",
   "description": "No prompt limits. No broken streams. Full thinking + tool support. Your Cursor subscription, properly integrated.",
   "type": "module",
   "main": "dist/plugin-entry.js",

package/src/provider/tool-loop-guard.ts

@@ -10,6 +10,7 @@ type ToolLoopErrorClass =
   | "unknown";
 
 const UNKNOWN_AS_SUCCESS_TOOLS = new Set([
+  // Core filesystem tools
   "bash",
   "shell",
   "read",
@@ -19,9 +20,27 @@ const UNKNOWN_AS_SUCCESS_TOOLS = new Set([
   "ls",
   "glob",
   "stat",
-  "webfetch",
   "mkdir",
   "rm",
+  // Web/network tools
+  "webfetch",
+  // cursor-agent specific tools (passthrough, but should not trigger loop guard)
+  // Discovered via tests/experiments/ harness - see docs/cursor-agent-tools.md
+  "semsearch",   // semantic code search
+  "readlints",   // lint/diagnostic reader
+]);
+
+// Exploratory tools that commonly iterate over many files/patterns.
+// These are exempt from COARSE fingerprint tracking (tool|errorClass) to allow
+// legitimate multi-file exploration. Strict fingerprints (tool|args|errorClass)
+// still apply to catch identical repeated failures.
+const EXPLORATION_TOOLS = new Set([
+  "read",
+  "grep",
+  "glob",
+  "ls",
+  "stat",
+  "semsearch",
 ]);
 
 export interface ToolLoopGuardDecision {
@@ -125,6 +144,7 @@ export function createToolLoopGuard(
       const coarseFingerprint = `${toolCall.function.name}|${errorClass}`;
 
       return evaluateWithFingerprints(
+        toolCall.function.name,
         errorClass,
         strictFingerprint,
         coarseFingerprint,
@@ -140,6 +160,7 @@ export function createToolLoopGuard(
       const strictFingerprint = `${toolCall.function.name}|schema:${normalizedSignature}|validation`;
       const coarseFingerprint = `${toolCall.function.name}|validation`;
       return evaluateWithFingerprints(
+        toolCall.function.name,
         "validation",
         strictFingerprint,
         coarseFingerprint,
@@ -456,6 +477,7 @@ function normalizeValidationSignature(signature: string): string {
 }
 
 function evaluateWithFingerprints(
+  toolName: string,
   errorClass: ToolLoopErrorClass,
   strictFingerprint: string,
   coarseFingerprint: string,
@@ -477,9 +499,22 @@ function evaluateWithFingerprints(
 
   const strictRepeatCount = (strictCounts.get(strictFingerprint) ?? 0) + 1;
   strictCounts.set(strictFingerprint, strictRepeatCount);
+  const strictTriggered = strictRepeatCount > maxRepeat;
+
+  const isExplorationTool = EXPLORATION_TOOLS.has(toolName.toLowerCase());
+  if (isExplorationTool) {
+    return {
+      fingerprint: strictFingerprint,
+      repeatCount: strictRepeatCount,
+      maxRepeat,
+      errorClass,
+      triggered: strictTriggered,
+      tracked: true,
+    };
+  }
+
   const coarseRepeatCount = (coarseCounts.get(coarseFingerprint) ?? 0) + 1;
   coarseCounts.set(coarseFingerprint, coarseRepeatCount);
-  const strictTriggered = strictRepeatCount > maxRepeat;
   const coarseTriggered = coarseRepeatCount > coarseMaxRepeat;
   const preferCoarseFingerprint = coarseTriggered && !strictTriggered;
   return {