@rallycry/conveyor-agent 7.2.18 → 7.3.0

package/dist/{chunk-5OMUMWQR.js → chunk-5MTPAVNZ.js}

@@ -4915,8 +4915,34 @@ async function handleAskUserQuestion(host, input) {
   }
   return { behavior: "allow", updatedInput: { questions: input.questions, answers } };
 }
+var EXPLORATION_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob"]);
+function trackExploration(tracker, toolName, input) {
+  if (!EXPLORATION_TOOLS.has(toolName)) return null;
+  if (toolName === "Read") {
+    const filePath = String(input.file_path ?? "");
+    if (filePath) return tracker.recordFileRead(filePath);
+  }
+  if (toolName === "Grep" || toolName === "Glob") {
+    const pattern = String(input.pattern ?? "");
+    if (pattern) return tracker.recordSearch(pattern);
+  }
+  return null;
+}
 var DENIAL_WARNING_THRESHOLD = 3;
 var DENIAL_FORCE_STOP_THRESHOLD = 8;
+function handleDenialEscalation(host, consecutiveDenials) {
+  if (consecutiveDenials === DENIAL_WARNING_THRESHOLD) {
+    host.connection.postChatMessage(
+      `\u26A0\uFE0F Multiple tool denials detected. You are in ${host.agentMode} mode \u2014 file writes outside .claude/plans/ are not permitted. Focus on creating a plan instead of implementing code changes.`
+    );
+  }
+  if (consecutiveDenials >= DENIAL_FORCE_STOP_THRESHOLD) {
+    host.connection.postChatMessage(
+      `Agent force-stopped after ${DENIAL_FORCE_STOP_THRESHOLD} consecutive tool denials. The agent appears stuck \u2014 send a message to resume.`
+    );
+    host.requestStop();
+  }
+}
 function resolveToolAccess(host, toolName, input) {
   switch (host.agentMode) {
     case "discovery":
@@ -4947,19 +4973,15 @@ function buildCanUseTool(host) {
       return await handleAskUserQuestion(host, input);
     }
     const result = resolveToolAccess(host, toolName, input);
+    if (result.behavior === "allow" && host.explorationTracker && !host.hasExitedPlanMode) {
+      const signal = trackExploration(host.explorationTracker, toolName, input);
+      if (signal) {
+        host.connection.postChatMessage(signal.message);
+      }
+    }
     if (result.behavior === "deny") {
       consecutiveDenials++;
-      if (consecutiveDenials === DENIAL_WARNING_THRESHOLD) {
-        host.connection.postChatMessage(
-          `\u26A0\uFE0F Multiple tool denials detected. You are in ${host.agentMode} mode \u2014 file writes outside .claude/plans/ are not permitted. Focus on creating a plan instead of implementing code changes.`
-        );
-      }
-      if (consecutiveDenials >= DENIAL_FORCE_STOP_THRESHOLD) {
-        host.connection.postChatMessage(
-          `Agent force-stopped after ${DENIAL_FORCE_STOP_THRESHOLD} consecutive tool denials. The agent appears stuck \u2014 send a message to resume.`
-        );
-        host.requestStop();
-      }
+      handleDenialEscalation(host, consecutiveDenials);
     } else {
       consecutiveDenials = 0;
     }
@@ -5383,6 +5405,108 @@ var CostTracker = class {
   }
 };
 
+// src/execution/exploration-tracker.ts
+var FILE_REREAD_NUDGE_L1 = 3;
+var FILE_REREAD_NUDGE_L2 = 5;
+var SEARCH_REPEAT_NUDGE_L1 = 3;
+var SEARCH_REPEAT_NUDGE_L2 = 5;
+var RATIO_MIN_READS_L1 = 10;
+var RATIO_THRESHOLD_L1 = 0.4;
+var RATIO_MIN_READS_L2 = 15;
+var RATIO_THRESHOLD_L2 = 0.3;
+function normalizePath(filePath) {
+  let normalized = filePath.replace(/^\.\//, "");
+  normalized = normalized.replace(/\/+/g, "/");
+  return normalized;
+}
+var ExplorationTracker = class {
+  fileReadCounts = /* @__PURE__ */ new Map();
+  searchCounts = /* @__PURE__ */ new Map();
+  totalReads = 0;
+  highestNudgeEmitted = 0;
+  complexityMultiplier;
+  constructor(isParentTask) {
+    this.complexityMultiplier = isParentTask ? 1.5 : 1;
+  }
+  /** Record a file read and return a staleness signal if thresholds are crossed. */
+  recordFileRead(filePath) {
+    const normalized = normalizePath(filePath);
+    const count = (this.fileReadCounts.get(normalized) ?? 0) + 1;
+    this.fileReadCounts.set(normalized, count);
+    this.totalReads++;
+    return this.checkFileRereadSignal(normalized, count) ?? this.checkExplorationRatio();
+  }
+  /** Record a search pattern and return a staleness signal if thresholds are crossed. */
+  recordSearch(pattern) {
+    const count = (this.searchCounts.get(pattern) ?? 0) + 1;
+    this.searchCounts.set(pattern, count);
+    return this.checkSearchRepeatSignal(pattern, count);
+  }
+  scaledThreshold(base) {
+    return Math.ceil(base * this.complexityMultiplier);
+  }
+  checkFileRereadSignal(filePath, count) {
+    const l2 = this.scaledThreshold(FILE_REREAD_NUDGE_L2);
+    const l1 = this.scaledThreshold(FILE_REREAD_NUDGE_L1);
+    if (count >= l2 && this.highestNudgeEmitted < 2) {
+      this.highestNudgeEmitted = 2;
+      return {
+        level: 2,
+        message: `\u26A0\uFE0F Exploration warning: You've read "${filePath}" ${count} times, suggesting analysis paralysis. Write your plan with the context you have and call ExitPlanMode. If something specific is blocking you, describe the blocker in your plan.`
+      };
+    }
+    if (count >= l1 && this.highestNudgeEmitted < 1) {
+      this.highestNudgeEmitted = 1;
+      return {
+        level: 1,
+        message: `Exploration note: You've read "${filePath}" ${count} times. Consider whether you have enough context to start writing your plan. If you're still exploring, try looking at different files.`
+      };
+    }
+    return null;
+  }
+  checkSearchRepeatSignal(pattern, count) {
+    const l2 = this.scaledThreshold(SEARCH_REPEAT_NUDGE_L2);
+    const l1 = this.scaledThreshold(SEARCH_REPEAT_NUDGE_L1);
+    const displayPattern = pattern.length > 60 ? pattern.slice(0, 57) + "..." : pattern;
+    if (count >= l2 && this.highestNudgeEmitted < 2) {
+      this.highestNudgeEmitted = 2;
+      return {
+        level: 2,
+        message: `\u26A0\uFE0F Exploration warning: You've searched for "${displayPattern}" ${count} times. Repeated searches for the same pattern suggest you may be stuck. Proceed with the information you have.`
+      };
+    }
+    if (count >= l1 && this.highestNudgeEmitted < 1) {
+      this.highestNudgeEmitted = 1;
+      return {
+        level: 1,
+        message: `Exploration note: You've searched for "${displayPattern}" ${count} times. If you're not finding what you need, try a different approach or broader pattern.`
+      };
+    }
+    return null;
+  }
+  checkExplorationRatio() {
+    const uniqueReads = this.fileReadCounts.size;
+    const ratio = this.totalReads > 0 ? uniqueReads / this.totalReads : 1;
+    const minReadsL2 = this.scaledThreshold(RATIO_MIN_READS_L2);
+    if (this.totalReads >= minReadsL2 && ratio < RATIO_THRESHOLD_L2 && this.highestNudgeEmitted < 2) {
+      this.highestNudgeEmitted = 2;
+      return {
+        level: 2,
+        message: `\u26A0\uFE0F Exploration warning: Only ${Math.round(ratio * 100)}% of your ${this.totalReads} file reads are unique. This indicates significant re-reading. Write your plan with the context you have.`
+      };
+    }
+    const minReadsL1 = this.scaledThreshold(RATIO_MIN_READS_L1);
+    if (this.totalReads >= minReadsL1 && ratio < RATIO_THRESHOLD_L1 && this.highestNudgeEmitted < 1) {
+      this.highestNudgeEmitted = 1;
+      return {
+        level: 1,
+        message: `Exploration note: ${Math.round(ratio * 100)}% of your ${this.totalReads} file reads are unique. You're re-reading files more than exploring new ones. Consider starting your plan.`
+      };
+    }
+    return null;
+  }
+};
+
 // src/runner/query-bridge.ts
 var logger3 = createServiceLogger("QueryBridge");
 var QueryBridge = class {
@@ -5474,6 +5598,7 @@ var QueryBridge = class {
       harness: this.harness,
       setupLog: [],
       costTracker: this.costTracker,
+      explorationTracker: bridge.mode.effectiveMode === "discovery" || bridge.mode.effectiveMode === "auto" && !bridge.mode.hasExitedPlanMode ? new ExplorationTracker(bridge._isParentTask) : null,
       sessionIds: this.sessionIds,
       pendingToolOutputs: this.pendingToolOutputs,
       // Live getters/setters delegating to ModeController + bridge state
@@ -7671,4 +7796,4 @@ export {
   loadForwardPorts,
   loadConveyorConfig
 };
-//# sourceMappingURL=chunk-5OMUMWQR.js.map
+//# sourceMappingURL=chunk-5MTPAVNZ.js.map