@dexto/tools-filesystem 1.5.0

package/dist/edit-file-tool.js

@@ -0,0 +1,147 @@
+import * as path from "node:path";
+import { z } from "zod";
+import { createPatch } from "diff";
+import { ApprovalType } from "@dexto/core";
+import { ToolError } from "@dexto/core";
+import { ToolErrorCode } from "@dexto/core";
+import { DextoRuntimeError } from "@dexto/core";
+const EditFileInputSchema = z.object({
+  file_path: z.string().describe("Absolute path to the file to edit"),
+  old_string: z.string().describe("Text to replace (must be unique unless replace_all is true)"),
+  new_string: z.string().describe("Replacement text"),
+  replace_all: z.boolean().optional().default(false).describe("Replace all occurrences (default: false, requires unique match)")
+}).strict();
+function generateDiffPreview(filePath, originalContent, newContent) {
+  const unified = createPatch(filePath, originalContent, newContent, "before", "after", {
+    context: 3
+  });
+  const additions = (unified.match(/^\+[^+]/gm) || []).length;
+  const deletions = (unified.match(/^-[^-]/gm) || []).length;
+  return {
+    type: "diff",
+    unified,
+    filename: filePath,
+    additions,
+    deletions
+  };
+}
+function createEditFileTool(options) {
+  const { fileSystemService, directoryApproval } = options;
+  let pendingApprovalParentDir;
+  return {
+    id: "edit_file",
+    description: "Edit a file by replacing text. By default, old_string must be unique in the file (will error if found multiple times). Set replace_all=true to replace all occurrences. Automatically creates backup before editing. Requires approval. Returns success status, path, number of changes made, and backup path.",
+    inputSchema: EditFileInputSchema,
+    /**
+     * Check if this edit operation needs directory access approval.
+     * Returns custom approval request if the file is outside allowed paths.
+     */
+    getApprovalOverride: (args) => {
+      const { file_path } = args;
+      if (!file_path) return null;
+      const isAllowed = fileSystemService.isPathWithinConfigAllowed(file_path);
+      if (isAllowed) {
+        return null;
+      }
+      if (directoryApproval?.isSessionApproved(file_path)) {
+        return null;
+      }
+      const absolutePath = path.resolve(file_path);
+      const parentDir = path.dirname(absolutePath);
+      pendingApprovalParentDir = parentDir;
+      return {
+        type: ApprovalType.DIRECTORY_ACCESS,
+        metadata: {
+          path: absolutePath,
+          parentDir,
+          operation: "edit",
+          toolName: "edit_file"
+        }
+      };
+    },
+    /**
+     * Handle approved directory access - remember the directory for session
+     */
+    onApprovalGranted: (response) => {
+      if (!directoryApproval || !pendingApprovalParentDir) return;
+      const data = response.data;
+      const rememberDirectory = data?.rememberDirectory ?? false;
+      directoryApproval.addApproved(
+        pendingApprovalParentDir,
+        rememberDirectory ? "session" : "once"
+      );
+      pendingApprovalParentDir = void 0;
+    },
+    /**
+     * Generate preview for approval UI - shows diff without modifying file
+     * Throws ToolError.validationFailed() for validation errors (file not found, string not found)
+     */
+    generatePreview: async (input, _context) => {
+      const { file_path, old_string, new_string, replace_all } = input;
+      try {
+        const originalFile = await fileSystemService.readFile(file_path);
+        const originalContent = originalFile.content;
+        if (!replace_all) {
+          const occurrences = originalContent.split(old_string).length - 1;
+          if (occurrences > 1) {
+            throw ToolError.validationFailed(
+              "edit_file",
+              `String found ${occurrences} times in file. Set replace_all=true to replace all, or provide more context to make old_string unique.`,
+              { file_path, occurrences }
+            );
+          }
+        }
+        const newContent = replace_all ? originalContent.split(old_string).join(new_string) : originalContent.replace(old_string, new_string);
+        if (originalContent === newContent) {
+          throw ToolError.validationFailed(
+            "edit_file",
+            `String not found in file: "${old_string.slice(0, 50)}${old_string.length > 50 ? "..." : ""}"`,
+            { file_path, old_string_preview: old_string.slice(0, 100) }
+          );
+        }
+        return generateDiffPreview(file_path, originalContent, newContent);
+      } catch (error) {
+        if (error instanceof DextoRuntimeError && error.code === ToolErrorCode.VALIDATION_FAILED) {
+          throw error;
+        }
+        if (error instanceof DextoRuntimeError) {
+          throw ToolError.validationFailed("edit_file", error.message, {
+            file_path,
+            originalErrorCode: error.code
+          });
+        }
+        return null;
+      }
+    },
+    execute: async (input, _context) => {
+      const { file_path, old_string, new_string, replace_all } = input;
+      const originalFile = await fileSystemService.readFile(file_path);
+      const originalContent = originalFile.content;
+      const result = await fileSystemService.editFile(
+        file_path,
+        {
+          oldString: old_string,
+          newString: new_string,
+          replaceAll: replace_all
+        },
+        {
+          backup: true
+          // Always create backup for internal tools
+        }
+      );
+      const newFile = await fileSystemService.readFile(file_path);
+      const newContent = newFile.content;
+      const _display = generateDiffPreview(file_path, originalContent, newContent);
+      return {
+        success: result.success,
+        path: result.path,
+        changes_count: result.changesCount,
+        ...result.backupPath && { backup_path: result.backupPath },
+        _display
+      };
+    }
+  };
+}
+export {
+  createEditFileTool
+};

package/dist/error-codes.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var error_codes_exports = {};
+__export(error_codes_exports, {
+  FileSystemErrorCode: () => FileSystemErrorCode
+});
+module.exports = __toCommonJS(error_codes_exports);
+var FileSystemErrorCode = /* @__PURE__ */ ((FileSystemErrorCode2) => {
+  FileSystemErrorCode2["FILE_NOT_FOUND"] = "FILESYSTEM_FILE_NOT_FOUND";
+  FileSystemErrorCode2["DIRECTORY_NOT_FOUND"] = "FILESYSTEM_DIRECTORY_NOT_FOUND";
+  FileSystemErrorCode2["PERMISSION_DENIED"] = "FILESYSTEM_PERMISSION_DENIED";
+  FileSystemErrorCode2["PATH_NOT_ALLOWED"] = "FILESYSTEM_PATH_NOT_ALLOWED";
+  FileSystemErrorCode2["PATH_BLOCKED"] = "FILESYSTEM_PATH_BLOCKED";
+  FileSystemErrorCode2["INVALID_PATH"] = "FILESYSTEM_INVALID_PATH";
+  FileSystemErrorCode2["PATH_TRAVERSAL_DETECTED"] = "FILESYSTEM_PATH_TRAVERSAL_DETECTED";
+  FileSystemErrorCode2["INVALID_FILE_EXTENSION"] = "FILESYSTEM_INVALID_FILE_EXTENSION";
+  FileSystemErrorCode2["INVALID_ENCODING"] = "FILESYSTEM_INVALID_ENCODING";
+  FileSystemErrorCode2["FILE_TOO_LARGE"] = "FILESYSTEM_FILE_TOO_LARGE";
+  FileSystemErrorCode2["TOO_MANY_RESULTS"] = "FILESYSTEM_TOO_MANY_RESULTS";
+  FileSystemErrorCode2["READ_FAILED"] = "FILESYSTEM_READ_FAILED";
+  FileSystemErrorCode2["WRITE_FAILED"] = "FILESYSTEM_WRITE_FAILED";
+  FileSystemErrorCode2["BACKUP_FAILED"] = "FILESYSTEM_BACKUP_FAILED";
+  FileSystemErrorCode2["EDIT_FAILED"] = "FILESYSTEM_EDIT_FAILED";
+  FileSystemErrorCode2["STRING_NOT_UNIQUE"] = "FILESYSTEM_STRING_NOT_UNIQUE";
+  FileSystemErrorCode2["STRING_NOT_FOUND"] = "FILESYSTEM_STRING_NOT_FOUND";
+  FileSystemErrorCode2["GLOB_FAILED"] = "FILESYSTEM_GLOB_FAILED";
+  FileSystemErrorCode2["SEARCH_FAILED"] = "FILESYSTEM_SEARCH_FAILED";
+  FileSystemErrorCode2["INVALID_PATTERN"] = "FILESYSTEM_INVALID_PATTERN";
+  FileSystemErrorCode2["REGEX_TIMEOUT"] = "FILESYSTEM_REGEX_TIMEOUT";
+  FileSystemErrorCode2["INVALID_CONFIG"] = "FILESYSTEM_INVALID_CONFIG";
+  FileSystemErrorCode2["SERVICE_NOT_INITIALIZED"] = "FILESYSTEM_SERVICE_NOT_INITIALIZED";
+  return FileSystemErrorCode2;
+})(FileSystemErrorCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FileSystemErrorCode
+});

package/dist/error-codes.d.cts

@@ -0,0 +1,32 @@
+/**
+ * FileSystem Service Error Codes
+ *
+ * Standardized error codes for file system operations
+ */
+declare enum FileSystemErrorCode {
+    FILE_NOT_FOUND = "FILESYSTEM_FILE_NOT_FOUND",
+    DIRECTORY_NOT_FOUND = "FILESYSTEM_DIRECTORY_NOT_FOUND",
+    PERMISSION_DENIED = "FILESYSTEM_PERMISSION_DENIED",
+    PATH_NOT_ALLOWED = "FILESYSTEM_PATH_NOT_ALLOWED",
+    PATH_BLOCKED = "FILESYSTEM_PATH_BLOCKED",
+    INVALID_PATH = "FILESYSTEM_INVALID_PATH",
+    PATH_TRAVERSAL_DETECTED = "FILESYSTEM_PATH_TRAVERSAL_DETECTED",
+    INVALID_FILE_EXTENSION = "FILESYSTEM_INVALID_FILE_EXTENSION",
+    INVALID_ENCODING = "FILESYSTEM_INVALID_ENCODING",
+    FILE_TOO_LARGE = "FILESYSTEM_FILE_TOO_LARGE",
+    TOO_MANY_RESULTS = "FILESYSTEM_TOO_MANY_RESULTS",
+    READ_FAILED = "FILESYSTEM_READ_FAILED",
+    WRITE_FAILED = "FILESYSTEM_WRITE_FAILED",
+    BACKUP_FAILED = "FILESYSTEM_BACKUP_FAILED",
+    EDIT_FAILED = "FILESYSTEM_EDIT_FAILED",
+    STRING_NOT_UNIQUE = "FILESYSTEM_STRING_NOT_UNIQUE",
+    STRING_NOT_FOUND = "FILESYSTEM_STRING_NOT_FOUND",
+    GLOB_FAILED = "FILESYSTEM_GLOB_FAILED",
+    SEARCH_FAILED = "FILESYSTEM_SEARCH_FAILED",
+    INVALID_PATTERN = "FILESYSTEM_INVALID_PATTERN",
+    REGEX_TIMEOUT = "FILESYSTEM_REGEX_TIMEOUT",
+    INVALID_CONFIG = "FILESYSTEM_INVALID_CONFIG",
+    SERVICE_NOT_INITIALIZED = "FILESYSTEM_SERVICE_NOT_INITIALIZED"
+}
+
+export { FileSystemErrorCode };

package/dist/error-codes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * FileSystem Service Error Codes
+ *
+ * Standardized error codes for file system operations
+ */
+declare enum FileSystemErrorCode {
+    FILE_NOT_FOUND = "FILESYSTEM_FILE_NOT_FOUND",
+    DIRECTORY_NOT_FOUND = "FILESYSTEM_DIRECTORY_NOT_FOUND",
+    PERMISSION_DENIED = "FILESYSTEM_PERMISSION_DENIED",
+    PATH_NOT_ALLOWED = "FILESYSTEM_PATH_NOT_ALLOWED",
+    PATH_BLOCKED = "FILESYSTEM_PATH_BLOCKED",
+    INVALID_PATH = "FILESYSTEM_INVALID_PATH",
+    PATH_TRAVERSAL_DETECTED = "FILESYSTEM_PATH_TRAVERSAL_DETECTED",
+    INVALID_FILE_EXTENSION = "FILESYSTEM_INVALID_FILE_EXTENSION",
+    INVALID_ENCODING = "FILESYSTEM_INVALID_ENCODING",
+    FILE_TOO_LARGE = "FILESYSTEM_FILE_TOO_LARGE",
+    TOO_MANY_RESULTS = "FILESYSTEM_TOO_MANY_RESULTS",
+    READ_FAILED = "FILESYSTEM_READ_FAILED",
+    WRITE_FAILED = "FILESYSTEM_WRITE_FAILED",
+    BACKUP_FAILED = "FILESYSTEM_BACKUP_FAILED",
+    EDIT_FAILED = "FILESYSTEM_EDIT_FAILED",
+    STRING_NOT_UNIQUE = "FILESYSTEM_STRING_NOT_UNIQUE",
+    STRING_NOT_FOUND = "FILESYSTEM_STRING_NOT_FOUND",
+    GLOB_FAILED = "FILESYSTEM_GLOB_FAILED",
+    SEARCH_FAILED = "FILESYSTEM_SEARCH_FAILED",
+    INVALID_PATTERN = "FILESYSTEM_INVALID_PATTERN",
+    REGEX_TIMEOUT = "FILESYSTEM_REGEX_TIMEOUT",
+    INVALID_CONFIG = "FILESYSTEM_INVALID_CONFIG",
+    SERVICE_NOT_INITIALIZED = "FILESYSTEM_SERVICE_NOT_INITIALIZED"
+}
+
+export { FileSystemErrorCode };

package/dist/error-codes.js

@@ -0,0 +1,29 @@
+var FileSystemErrorCode = /* @__PURE__ */ ((FileSystemErrorCode2) => {
+  FileSystemErrorCode2["FILE_NOT_FOUND"] = "FILESYSTEM_FILE_NOT_FOUND";
+  FileSystemErrorCode2["DIRECTORY_NOT_FOUND"] = "FILESYSTEM_DIRECTORY_NOT_FOUND";
+  FileSystemErrorCode2["PERMISSION_DENIED"] = "FILESYSTEM_PERMISSION_DENIED";
+  FileSystemErrorCode2["PATH_NOT_ALLOWED"] = "FILESYSTEM_PATH_NOT_ALLOWED";
+  FileSystemErrorCode2["PATH_BLOCKED"] = "FILESYSTEM_PATH_BLOCKED";
+  FileSystemErrorCode2["INVALID_PATH"] = "FILESYSTEM_INVALID_PATH";
+  FileSystemErrorCode2["PATH_TRAVERSAL_DETECTED"] = "FILESYSTEM_PATH_TRAVERSAL_DETECTED";
+  FileSystemErrorCode2["INVALID_FILE_EXTENSION"] = "FILESYSTEM_INVALID_FILE_EXTENSION";
+  FileSystemErrorCode2["INVALID_ENCODING"] = "FILESYSTEM_INVALID_ENCODING";
+  FileSystemErrorCode2["FILE_TOO_LARGE"] = "FILESYSTEM_FILE_TOO_LARGE";
+  FileSystemErrorCode2["TOO_MANY_RESULTS"] = "FILESYSTEM_TOO_MANY_RESULTS";
+  FileSystemErrorCode2["READ_FAILED"] = "FILESYSTEM_READ_FAILED";
+  FileSystemErrorCode2["WRITE_FAILED"] = "FILESYSTEM_WRITE_FAILED";
+  FileSystemErrorCode2["BACKUP_FAILED"] = "FILESYSTEM_BACKUP_FAILED";
+  FileSystemErrorCode2["EDIT_FAILED"] = "FILESYSTEM_EDIT_FAILED";
+  FileSystemErrorCode2["STRING_NOT_UNIQUE"] = "FILESYSTEM_STRING_NOT_UNIQUE";
+  FileSystemErrorCode2["STRING_NOT_FOUND"] = "FILESYSTEM_STRING_NOT_FOUND";
+  FileSystemErrorCode2["GLOB_FAILED"] = "FILESYSTEM_GLOB_FAILED";
+  FileSystemErrorCode2["SEARCH_FAILED"] = "FILESYSTEM_SEARCH_FAILED";
+  FileSystemErrorCode2["INVALID_PATTERN"] = "FILESYSTEM_INVALID_PATTERN";
+  FileSystemErrorCode2["REGEX_TIMEOUT"] = "FILESYSTEM_REGEX_TIMEOUT";
+  FileSystemErrorCode2["INVALID_CONFIG"] = "FILESYSTEM_INVALID_CONFIG";
+  FileSystemErrorCode2["SERVICE_NOT_INITIALIZED"] = "FILESYSTEM_SERVICE_NOT_INITIALIZED";
+  return FileSystemErrorCode2;
+})(FileSystemErrorCode || {});
+export {
+  FileSystemErrorCode
+};

package/dist/errors.cjs

@@ -0,0 +1,302 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  FileSystemError: () => FileSystemError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_core = require("@dexto/core");
+var import_error_codes = require("./error-codes.js");
+class FileSystemError {
+  constructor() {
+  }
+  /**
+   * File not found error
+   */
+  static fileNotFound(path) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.FILE_NOT_FOUND,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.NOT_FOUND,
+      `File not found: ${path}`,
+      { path }
+    );
+  }
+  /**
+   * Directory not found error
+   */
+  static directoryNotFound(path) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.DIRECTORY_NOT_FOUND,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.NOT_FOUND,
+      `Directory not found: ${path}`,
+      { path }
+    );
+  }
+  /**
+   * Permission denied error
+   */
+  static permissionDenied(path, operation) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.PERMISSION_DENIED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.FORBIDDEN,
+      `Permission denied: cannot ${operation} ${path}`,
+      { path, operation }
+    );
+  }
+  /**
+   * Path not allowed error
+   */
+  static pathNotAllowed(path, allowedPaths) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.PATH_NOT_ALLOWED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Path not allowed: ${path}. Must be within allowed paths: ${allowedPaths.join(", ")}`,
+      { path, allowedPaths },
+      "Ensure the path is within the configured allowed paths"
+    );
+  }
+  /**
+   * Path blocked error
+   */
+  static pathBlocked(path, reason) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.PATH_BLOCKED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.FORBIDDEN,
+      `Path is blocked: ${path}. Reason: ${reason}`,
+      { path, reason }
+    );
+  }
+  /**
+   * Invalid path error
+   */
+  static invalidPath(path, reason) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.INVALID_PATH,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Invalid path: ${path}. ${reason}`,
+      { path, reason }
+    );
+  }
+  /**
+   * Path traversal detected
+   */
+  static pathTraversal(path) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.PATH_TRAVERSAL_DETECTED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.FORBIDDEN,
+      `Path traversal detected in: ${path}`,
+      { path }
+    );
+  }
+  /**
+   * Invalid file extension error
+   */
+  static invalidExtension(path, blockedExtensions) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.INVALID_FILE_EXTENSION,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Invalid file extension: ${path}. Blocked extensions: ${blockedExtensions.join(", ")}`,
+      { path, blockedExtensions }
+    );
+  }
+  /**
+   * File too large error
+   */
+  static fileTooLarge(path, size, maxSize) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.FILE_TOO_LARGE,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `File too large: ${path} (${size} bytes). Maximum allowed: ${maxSize} bytes`,
+      { path, size, maxSize }
+    );
+  }
+  /**
+   * Too many results error
+   */
+  static tooManyResults(operation, count, maxResults) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.TOO_MANY_RESULTS,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Too many results from ${operation}: ${count}. Maximum allowed: ${maxResults}`,
+      { operation, count, maxResults },
+      "Narrow your search pattern or increase maxResults limit"
+    );
+  }
+  /**
+   * Read operation failed
+   */
+  static readFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.READ_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Failed to read file: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Write operation failed
+   */
+  static writeFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.WRITE_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Failed to write file: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Backup creation failed
+   */
+  static backupFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.BACKUP_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Failed to create backup for: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Edit operation failed
+   */
+  static editFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.EDIT_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Failed to edit file: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * String not unique error
+   */
+  static stringNotUnique(path, searchString, occurrences) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.STRING_NOT_UNIQUE,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `String is not unique in ${path}: "${searchString}" found ${occurrences} times. Use replaceAll=true or provide a more specific string.`,
+      { path, searchString, occurrences },
+      "Use replaceAll option or provide more context in the search string"
+    );
+  }
+  /**
+   * String not found error
+   */
+  static stringNotFound(path, searchString) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.STRING_NOT_FOUND,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `String not found in ${path}: "${searchString}"`,
+      { path, searchString }
+    );
+  }
+  /**
+   * Glob operation failed
+   */
+  static globFailed(pattern, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.GLOB_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Glob operation failed for pattern: ${pattern}. ${cause}`,
+      { pattern, cause }
+    );
+  }
+  /**
+   * Search operation failed
+   */
+  static searchFailed(pattern, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.SEARCH_FAILED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      `Search operation failed for pattern: ${pattern}. ${cause}`,
+      { pattern, cause }
+    );
+  }
+  /**
+   * Invalid pattern error
+   */
+  static invalidPattern(pattern, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.INVALID_PATTERN,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Invalid pattern: ${pattern}. ${cause}`,
+      { pattern, cause }
+    );
+  }
+  /**
+   * Regex timeout error
+   */
+  static regexTimeout(pattern) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.REGEX_TIMEOUT,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.TIMEOUT,
+      `Regex operation timed out for pattern: ${pattern}`,
+      { pattern },
+      "Simplify your regex pattern or increase timeout"
+    );
+  }
+  /**
+   * Invalid configuration error
+   */
+  static invalidConfig(reason) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.INVALID_CONFIG,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.USER,
+      `Invalid FileSystem configuration: ${reason}`,
+      { reason }
+    );
+  }
+  /**
+   * Service not initialized error
+   */
+  static notInitialized() {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.SERVICE_NOT_INITIALIZED,
+      import_core.ErrorScope.FILESYSTEM,
+      import_core.ErrorType.SYSTEM,
+      "FileSystemService has not been initialized",
+      {},
+      "Initialize the FileSystemService before using it"
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FileSystemError
+});