@cydm/pie 1.0.18 → 1.0.19

package/dist/chunks/{chunk-MHFUWY7I.js → chunk-KZ54RSWP.js}

@@ -8,10 +8,10 @@ import {
   createSharedWebSearchTool,
   interpretShellExit,
   requestInteraction
-} from "./chunk-G4GV2CRT.js";
+} from "./chunk-GZVSE44O.js";
 import {
   Type
-} from "./chunk-5DA2D3K2.js";
+} from "./chunk-Q2N6B5JN.js";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, renameSync } from "fs";

package/dist/chunks/{chunk-5DA2D3K2.js → chunk-Q2N6B5JN.js}

@@ -3107,6 +3107,27 @@ function calculateCost(model, usage) {
   };
 }
 
+// ../../packages/platform/src/text-hash.ts
+function createTextHasher() {
+  let hash = 2166136261;
+  return {
+    update(text) {
+      for (let index = 0; index < text.length; index++) {
+        hash ^= text.charCodeAt(index);
+        hash = Math.imul(hash, 16777619) >>> 0;
+      }
+    },
+    digest() {
+      return hash.toString(16).padStart(8, "0");
+    }
+  };
+}
+function hashText(text) {
+  const hasher = createTextHasher();
+  hasher.update(text);
+  return hasher.digest();
+}
+
 // ../../packages/platform/src/detector.ts
 function isPuerTS() {
   try {
@@ -3252,6 +3273,17 @@ function convertStats(stats) {
     mtime: stats.mtime
   };
 }
+function byteLength(text) {
+  return Buffer.byteLength(text, "utf-8");
+}
+function normalizeRangeOptions(options) {
+  return {
+    offsetLine: Math.max(0, Math.floor(options?.offsetLine ?? 0)),
+    limitLines: options?.limitLines === void 0 ? Number.POSITIVE_INFINITY : Math.max(0, Math.floor(options.limitLines)),
+    maxOutputLines: Math.max(0, Math.floor(options?.maxOutputLines ?? Number.POSITIVE_INFINITY)),
+    maxOutputBytes: Math.max(0, Math.floor(options?.maxOutputBytes ?? Number.POSITIVE_INFINITY))
+  };
+}
 var NodeFileSystem = class {
   platform = "node";
   sep;
@@ -3266,6 +3298,142 @@ var NodeFileSystem = class {
   readFileSync(path, encoding = "utf-8") {
     return getNodeFs().readFileSync(path, encoding);
   }
+  async readTextRange(path, options, signal) {
+    const fs = getNodeFs();
+    const range = normalizeRangeOptions(options);
+    const stat = await fs.promises.stat(path);
+    const fullHasher = createTextHasher();
+    const selectedHasher = createTextHasher();
+    const outputLines = [];
+    let lineStarted = false;
+    let currentLineSelected = false;
+    let currentLineBytes = 0;
+    let currentOutputLine = "";
+    let currentOutputLineBytes = 0;
+    let currentOutputPrefixBytes = 0;
+    let currentLineCanOutput = false;
+    let lineIndex = 0;
+    let selectedLines = 0;
+    let selectedBytes = 0;
+    let firstLineBytes = 0;
+    let outputBytes = 0;
+    let truncated = false;
+    let truncatedBy = null;
+    let firstLineExceedsLimit = false;
+    const selectedEndLine = Number.isFinite(range.limitLines) ? range.offsetLine + range.limitLines : Number.POSITIVE_INFINITY;
+    const startLine = () => {
+      if (lineStarted) return;
+      currentLineSelected = lineIndex >= range.offsetLine && lineIndex < selectedEndLine;
+      currentLineBytes = 0;
+      currentOutputLine = "";
+      currentOutputLineBytes = 0;
+      currentOutputPrefixBytes = outputLines.length > 0 ? 1 : 0;
+      currentLineCanOutput = false;
+      lineStarted = true;
+      if (!currentLineSelected) return;
+      if (selectedLines > 0) {
+        selectedHasher.update("\n");
+        selectedBytes += 1;
+      }
+      if (!truncated && !firstLineExceedsLimit) {
+        if (outputLines.length >= range.maxOutputLines) {
+          truncated = true;
+          truncatedBy = "lines";
+        } else {
+          currentLineCanOutput = true;
+        }
+      }
+    };
+    const scanLineChar = (char) => {
+      startLine();
+      if (!currentLineSelected) return;
+      selectedHasher.update(char);
+      const charBytes = byteLength(char);
+      currentLineBytes += charBytes;
+      selectedBytes += charBytes;
+      if (selectedLines === 0 && currentLineBytes > range.maxOutputBytes) {
+        firstLineExceedsLimit = true;
+        truncated = true;
+        truncatedBy = "bytes";
+        currentLineCanOutput = false;
+        currentOutputLine = "";
+        currentOutputLineBytes = 0;
+        return;
+      }
+      if (!currentLineCanOutput) return;
+      const candidateOutputBytes = outputBytes + currentOutputPrefixBytes + currentOutputLineBytes + charBytes;
+      if (candidateOutputBytes > range.maxOutputBytes) {
+        truncated = true;
+        truncatedBy = "bytes";
+        currentLineCanOutput = false;
+        currentOutputLine = "";
+        currentOutputLineBytes = 0;
+        return;
+      }
+      currentOutputLine += char;
+      currentOutputLineBytes += charBytes;
+    };
+    const finishLine = () => {
+      startLine();
+      if (currentLineSelected) {
+        if (selectedLines === 0) {
+          firstLineBytes = currentLineBytes;
+        }
+        if (currentLineCanOutput) {
+          const candidateOutputBytes = outputBytes + currentOutputPrefixBytes + currentOutputLineBytes;
+          if (candidateOutputBytes > range.maxOutputBytes) {
+            truncated = true;
+            truncatedBy = "bytes";
+            currentLineCanOutput = false;
+          } else {
+            outputLines.push(currentOutputLine);
+            outputBytes = candidateOutputBytes;
+          }
+        }
+        selectedLines++;
+      }
+      lineStarted = false;
+      lineIndex++;
+    };
+    const stream = fs.createReadStream(path, { encoding: "utf-8" });
+    try {
+      for await (const chunk of stream) {
+        if (signal?.aborted) {
+          stream.destroy();
+          throw new Error("Operation aborted");
+        }
+        const text = String(chunk);
+        fullHasher.update(text);
+        for (const char of text) {
+          if (char === "\n") {
+            finishLine();
+          } else {
+            scanLineChar(char);
+          }
+        }
+      }
+      finishLine();
+    } finally {
+      stream.destroy();
+    }
+    return {
+      content: outputLines.join("\n"),
+      contentHash: fullHasher.digest(),
+      selectedContentHash: selectedHasher.digest(),
+      totalLines: lineIndex,
+      totalBytes: stat.size,
+      selectedLines,
+      selectedBytes,
+      firstLineBytes,
+      outputLines: outputLines.length,
+      outputBytes,
+      truncated,
+      truncatedBy,
+      firstLineExceedsLimit,
+      mtimeMs: stat.mtime.getTime(),
+      size: stat.size
+    };
+  }
   async writeFile(path, data, encoding = "utf-8") {
     return getNodeFs().promises.writeFile(path, data, encoding);
   }
@@ -3392,6 +3560,87 @@ function convertBridgeStatResult(result) {
     mtime: new Date((Number(result?.LastWriteTicksUtc || 0) - 621355968e9) / 1e4)
   };
 }
+function normalizeOptionalNumber(value, fallback) {
+  if (value === void 0 || !Number.isFinite(value)) {
+    return fallback;
+  }
+  return Math.max(0, Math.floor(value));
+}
+function convertTextRangeResult(result) {
+  return {
+    content: String(result?.Content ?? ""),
+    contentHash: String(result?.ContentHash ?? ""),
+    selectedContentHash: String(result?.SelectedContentHash ?? ""),
+    totalLines: Number(result?.TotalLines ?? 0),
+    totalBytes: Number(result?.TotalBytes ?? 0),
+    selectedLines: Number(result?.SelectedLines ?? 0),
+    selectedBytes: Number(result?.SelectedBytes ?? 0),
+    firstLineBytes: Number(result?.FirstLineBytes ?? 0),
+    outputLines: Number(result?.OutputLines ?? 0),
+    outputBytes: Number(result?.OutputBytes ?? 0),
+    truncated: !!result?.Truncated,
+    truncatedBy: result?.TruncatedBy ? String(result.TruncatedBy) : null,
+    firstLineExceedsLimit: !!result?.FirstLineExceedsLimit,
+    mtimeMs: (Number(result?.LastWriteTicksUtc || 0) - 621355968e9) / 1e4,
+    size: Number(result?.Size ?? 0)
+  };
+}
+function byteLength2(text) {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.byteLength(text, "utf-8");
+  }
+  return unescape(encodeURIComponent(text)).length;
+}
+function buildTextRangeFallback(content, stat, offsetLine, limitLines, maxOutputLines, maxOutputBytes) {
+  const lines = content.split("\n");
+  const endLine = Number.isFinite(limitLines) ? Math.min(lines.length, offsetLine + limitLines) : lines.length;
+  const selectedLinesArray = offsetLine >= lines.length ? [] : lines.slice(offsetLine, endLine);
+  const selectedContent = selectedLinesArray.join("\n");
+  const outputLines = [];
+  let outputBytes = 0;
+  let truncated = false;
+  let truncatedBy = null;
+  let firstLineExceedsLimit = false;
+  for (const line of selectedLinesArray) {
+    const lineBytes = byteLength2(line);
+    if (outputLines.length === 0 && lineBytes > maxOutputBytes) {
+      firstLineExceedsLimit = true;
+      truncated = true;
+      truncatedBy = "bytes";
+      break;
+    }
+    if (outputLines.length >= maxOutputLines) {
+      truncated = true;
+      truncatedBy = "lines";
+      break;
+    }
+    const candidateBytes = lineBytes + (outputLines.length > 0 ? 1 : 0);
+    if (outputBytes + candidateBytes > maxOutputBytes) {
+      truncated = true;
+      truncatedBy = "bytes";
+      break;
+    }
+    outputLines.push(line);
+    outputBytes += candidateBytes;
+  }
+  return {
+    content: outputLines.join("\n"),
+    contentHash: hashText(content),
+    selectedContentHash: hashText(selectedContent),
+    totalLines: lines.length,
+    totalBytes: stat.size,
+    selectedLines: selectedLinesArray.length,
+    selectedBytes: byteLength2(selectedContent),
+    firstLineBytes: selectedLinesArray.length > 0 ? byteLength2(selectedLinesArray[0]) : 0,
+    outputLines: outputLines.length,
+    outputBytes,
+    truncated,
+    truncatedBy,
+    firstLineExceedsLimit,
+    mtimeMs: stat.mtime.getTime(),
+    size: stat.size
+  };
+}
 function convertDateTime(dateTime) {
   if (!dateTime) return /* @__PURE__ */ new Date(0);
   const ticks = dateTime.get_Ticks?.() || 0;
@@ -3457,6 +3706,33 @@ var PuerTSFileSystem = class {
     }
     return IO.File.ReadAllText(normalizedPath);
   }
+  async readTextRange(path, options, signal) {
+    if (signal?.aborted) {
+      throw new Error("Operation aborted");
+    }
+    const bridge = getPieFileBridge();
+    const normalizedPath = this.normalizePath(path);
+    if (typeof bridge.ReadTextRangeAsync !== "function") {
+      const content = await this.readFile(path, "utf-8");
+      const stat = await this.stat(path);
+      const offsetLine = normalizeOptionalNumber(options?.offsetLine, 0);
+      const limitLines = options?.limitLines === void 0 ? Number.POSITIVE_INFINITY : normalizeOptionalNumber(options.limitLines, 0);
+      const maxOutputLines = normalizeOptionalNumber(options?.maxOutputLines, Number.POSITIVE_INFINITY);
+      const maxOutputBytes = normalizeOptionalNumber(options?.maxOutputBytes, Number.POSITIVE_INFINITY);
+      return buildTextRangeFallback(content, stat, offsetLine, limitLines, maxOutputLines, maxOutputBytes);
+    }
+    const payload = await taskToPromise(bridge.ReadTextRangeAsync(
+      normalizedPath,
+      normalizeOptionalNumber(options?.offsetLine, 0),
+      options?.limitLines === void 0 ? -1 : normalizeOptionalNumber(options.limitLines, 0),
+      normalizeOptionalNumber(options?.maxOutputLines, -1),
+      normalizeOptionalNumber(options?.maxOutputBytes, -1)
+    ));
+    if (signal?.aborted) {
+      throw new Error("Operation aborted");
+    }
+    return convertTextRangeResult(JSON.parse(String(payload ?? "{}")));
+  }
   async writeFile(path, data, encoding = "utf-8") {
     const bridge = getPieFileBridge();
     const normalizedPath = this.normalizePath(path);
@@ -9121,6 +9397,7 @@ registerApiProvider({
 });
 
 export {
+  hashText,
   detectPlatform,
   createLogger,
   setLogger,

package/dist/chunks/{src-6WPNVGT2.js → src-7UV3KKGU.js}

@@ -3,8 +3,8 @@ import {
   Agent,
   agentLoop,
   agentLoopContinue
-} from "./chunk-VE2HDCNB.js";
-import "./chunk-5DA2D3K2.js";
+} from "./chunk-2R3XTLE2.js";
+import "./chunk-Q2N6B5JN.js";
 import "./chunk-TG2EQLX2.js";
 export {
   Agent,

package/dist/chunks/{test-stream-ZSKNLUEJ.js → test-stream-PP63L7MK.js}

@@ -1,7 +1,7 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   EventStream
-} from "./chunk-5DA2D3K2.js";
+} from "./chunk-Q2N6B5JN.js";
 import "./chunk-TG2EQLX2.js";
 
 // src/app/test-stream.ts

package/dist/cli.js

@@ -14,7 +14,7 @@ import {
   getSettingsPath,
   getThemesDir,
   migrateConfigFromAgentDir
-} from "./chunks/chunk-MHFUWY7I.js";
+} from "./chunks/chunk-KZ54RSWP.js";
 import {
   AGENTS_CONTEXT_FILE_NAME,
   AgentSessionController,
@@ -31,6 +31,7 @@ import {
   createEmptyExecutionState,
   createExecutionStateFromTodos,
   createExecutionStateStore,
+  createFileObservationState,
   createPolicyEnforcedTools,
   createReadFileUnderstandingHandler,
   createSessionManager,
@@ -55,8 +56,8 @@ import {
   selectToolsForRuntimePolicy,
   shouldPreserveExecutionStateForUserText,
   supersedeExecutionState
-} from "./chunks/chunk-G4GV2CRT.js";
-import "./chunks/chunk-VE2HDCNB.js";
+} from "./chunks/chunk-GZVSE44O.js";
+import "./chunks/chunk-2R3XTLE2.js";
 import {
   Deref,
   Errors,
@@ -90,7 +91,7 @@ import {
   setLogger,
   sortToolModelCandidatesByCapability,
   type_exports
-} from "./chunks/chunk-5DA2D3K2.js";
+} from "./chunks/chunk-Q2N6B5JN.js";
 import {
   resolveCliProjectRoot
 } from "./chunks/chunk-NTYHFBUA.js";
@@ -61258,6 +61259,7 @@ async function handleCompactCommand(host) {
     host.sessionManager.appendCompaction(summary, firstKeptEntryId, tokensBefore);
     const compactedMessages = host.sessionManager.getMessages();
     host.replaceAgentMessagesAndMarkSynced(compactedMessages);
+    host.resetFileObservationState();
     host.streamingComponent = void 0;
     host.pendingTools.clear();
     host.chatContainer.clear();
@@ -64017,6 +64019,10 @@ function buildCodingAgentGuidelinesSection(tools = []) {
   if (hasGrep || hasFind || hasList) {
     guidelines.push("Prefer grep_text, find_files, and list_dir for workspace exploration when they are sufficient.");
   }
+  if (hasGrep) {
+    guidelines.push("Use grep_text outputMode='files_with_matches' to find candidate files, outputMode='count' to estimate impact, and outputMode='content' when you need matching lines and context.");
+    guidelines.push("After a broad grep_text search, narrow the path, glob, pattern, outputMode, offset, or limit instead of repeating the same broad search.");
+  }
   if (hasWebResearch) {
     guidelines.push("Use web_research for general public web research, current information, official docs, news, releases, issues, or webpage summaries; it searches, fetches, and returns cited sources.");
     guidelines.push("When web_research returns fetched sources that answer the request, synthesize the answer from that pack instead of calling web_search or web_fetch again.");
@@ -64036,20 +64042,26 @@ function buildCodingAgentGuidelinesSection(tools = []) {
     guidelines.push("Read the current file before edit_file changes, then use a precise unique replacement.");
   }
   if (hasRead) {
+    guidelines.push("Use read_file offset/limit for large files; if read_file says a range is unchanged, do not repeat the same read and choose a different range or search instead.");
     guidelines.push("Use read_file directly for media and documents when the file-understanding route is available.");
   }
   if (hasEdit) {
-    guidelines.push("If edit_file fails because text is missing or not unique, read the current file and retry with a larger exact block.");
+    guidelines.push("If edit_file fails because text is missing, read the current file and retry with exact text copied from the latest file contents.");
+    guidelines.push("If edit_file fails because text is not unique, read the current file and retry with a larger exact block, or set replaceAll to true if every occurrence should be replaced.");
   }
   if (hasWrite) {
-    guidelines.push("Use write_file for new files or complete rewrites when a targeted edit is not appropriate.");
+    guidelines.push("Use write_file for new files or true complete rewrites; before overwriting an existing file, read the current full file with read_file, and prefer edit_file for targeted changes.");
   }
   if (hasBash) {
     guidelines.push("Pass only executable shell commands to bash, not numbered plan items, headings, or prose.");
+    if (hasWrite || hasEdit) {
+      guidelines.push("Do not use shell redirection, cat > file, tee, or heredoc to create or overwrite files when write_file or edit_file can do it; never use Bash to bypass write_file overwrite guards.");
+    }
     guidelines.push("If bash times out or truncates output, adjust the command or inspect the reported full output path instead of repeating the same command.");
   }
   if (hasTodo) {
-    guidelines.push("Use manage_todo_list for multi-step work: create the list, complete only the current item, then let the tool advance the next item.");
+    guidelines.push("Use manage_todo_list only for multi-step work: create the list, complete only the current item when it is genuinely done, and let the tool advance the next item.");
+    guidelines.push("Do not complete a todo item while implementation is partial, tests or verification are failing, or the required verification has not run.");
   }
   guidelines.push(
     "Once the root cause or required change is clear, make a small concrete edit instead of continuing unrelated exploration.",
@@ -65056,6 +65068,7 @@ function createInteractiveAgentSessionController(host) {
           host.footer.setState({ status: "ready" });
           return;
         }
+        host.resetFileObservationState();
         const contextUsage = host.calculateContextUsage();
         const contextWindow = host.options.model?.contextWindow ?? 0;
         const contextPercent = contextWindow > 0 && contextUsage.tokens !== null ? contextUsage.tokens / contextWindow * 100 : 0;
@@ -66810,6 +66823,7 @@ var InteractiveMode = class {
         allowlistedDirs
       }),
       configDir: this.options.configDir,
+      fileObservationState: this.options.fileObservationState,
       getAgentModel: () => this.options.model,
       getSessionId: () => this.sessionManager.getActiveSessionId() || void 0,
       resolveToolModel: (purpose) => this.options.modelRegistry.resolveToolModel(purpose, this.options.model),
@@ -66837,6 +66851,9 @@ var InteractiveMode = class {
       )
     };
   }
+  resetFileObservationState() {
+    this.options.fileObservationState.clear();
+  }
   getRuntimeModeState() {
     const pendingTransition = this.getPendingRuntimeModeTransition();
     const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || "local";
@@ -66945,7 +66962,7 @@ var InteractiveMode = class {
     if (savedLevel) {
       this.thinkingLevel = savedLevel;
     }
-    const { Agent } = await import("./chunks/src-6WPNVGT2.js");
+    const { Agent } = await import("./chunks/src-7UV3KKGU.js");
     const activeSession = this.sessionManager.getActiveSession();
     this.agent = new Agent({
       initialState: {
@@ -67375,6 +67392,7 @@ async function composeCliRuntime(params) {
   }
   syncSessionModelMetadata(sessionManager, model, settingsManager.getDefaultThinkingLevel() || "off");
   const sessionId = sessionManager.getActiveSession()?.id;
+  const fileObservationState = createFileObservationState();
   if (sessionId) {
     if (process.env.PIE_DEBUG && !fileLogger.isEnabled()) {
       fileLogger.enable();
@@ -67403,6 +67421,7 @@ async function composeCliRuntime(params) {
   const fileSystemToolOptions = {
     ...buildCliFileAccessOptions({ cwd, configDir: paths.configDir, skills, allowlistedDirs: [paths.configDir] }),
     configDir: paths.configDir,
+    fileObservationState,
     getAgentModel: getCurrentModel,
     getSessionId: () => sessionManager.getActiveSessionId() || void 0,
     resolveToolModel: (purpose) => modelRegistry.resolveToolModel(purpose, getCurrentModel()),
@@ -67475,6 +67494,7 @@ async function composeCliRuntime(params) {
     skillsSection,
     knowledgeSection,
     tools,
+    fileObservationState,
     extensionPaths: params.extensionPaths,
     compositionTrace,
     createInteractiveOptions() {
@@ -67482,6 +67502,7 @@ async function composeCliRuntime(params) {
         model,
         apiKey,
         tools,
+        fileObservationState,
         sessionManager,
         skills,
         cwd,
@@ -67612,7 +67633,7 @@ async function runPrintMode(params) {
 `);
     console.log("Assistant: ");
   }
-  const { Agent: AgentClass } = await import("./chunks/src-6WPNVGT2.js");
+  const { Agent: AgentClass } = await import("./chunks/src-7UV3KKGU.js");
   let agent;
   const printModeExtensions = await loadPrintModeExtensions({
     cwd: runtime.cwd,
@@ -67704,6 +67725,8 @@ async function runPrintMode(params) {
         console.error(event.failure.kind === "context_overflow" ? "Context overflow detected, compacting..." : "Auto-compacting context before retry...");
       } else if (event.type === "auto_compaction_start") {
         console.error(event.reason === "overflow" ? "Context overflow detected, compacting..." : "Auto-compacting context...");
+      } else if (event.type === "auto_compaction_end" && !event.errorMessage) {
+        runtime.fileObservationState.clear();
       } else if (event.type === "turn_retry_started") {
         console.error(`Retrying request (${event.attempt}/${event.maxRetries})...`);
       } else if (event.type === "turn_retry_succeeded") {
@@ -68120,6 +68143,9 @@ async function runJsonEventsMode(params) {
   }
   function handleControllerEvent(event) {
     trace?.noteRuntimeEvent(event.type, event);
+    if (event.type === "auto_compaction_end" && !event.errorMessage) {
+      params.runtime?.fileObservationState.clear();
+    }
     if (event.type === "turn_settled" && activeTurn) {
       finalizePendingTerminal();
       writeEvent({
@@ -68235,7 +68261,7 @@ async function runJsonEventsMode(params) {
     if (runtime.initialModel.unconfigured) {
       return;
     }
-    const { Agent: AgentClass } = await import("./chunks/src-6WPNVGT2.js");
+    const { Agent: AgentClass } = await import("./chunks/src-7UV3KKGU.js");
     const jsonModeExtensions = await loadJsonModeExtensions({ runtime, getAgent: () => agent });
     const tools = [...runtime.tools, ...jsonModeExtensions.extensionTools];
     recordCliCompositionStep(runtime.compositionTrace, {
@@ -68662,7 +68688,7 @@ async function createCliTestStreamFnFromEnv() {
   if (!process.env.PIE_TEST_MOCK_STREAM_SEQUENCE) {
     return void 0;
   }
-  const { createTestStreamFnFromSequenceEnv } = await import("./chunks/test-stream-ZSKNLUEJ.js");
+  const { createTestStreamFnFromSequenceEnv } = await import("./chunks/test-stream-PP63L7MK.js");
   return createTestStreamFnFromSequenceEnv();
 }
 async function startChat(initialPrompt, testCommand) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cydm/pie",
-	"version": "1.0.18",
+  "version": "1.0.19",
 	"description": "Pie AI Agent CLI",
 	"type": "module",
 	"bin": {