@dexto/tools-filesystem 1.5.8 → 1.6.1

package/dist/edit-file-tool.test.js

@@ -6,13 +6,26 @@ import { createEditFileTool } from "./edit-file-tool.js";
 import { FileSystemService } from "./filesystem-service.js";
 import { ToolErrorCode } from "@dexto/core";
 import { DextoRuntimeError } from "@dexto/core";
-const createMockLogger = () => ({
-  debug: vi.fn(),
-  info: vi.fn(),
-  warn: vi.fn(),
-  error: vi.fn(),
-  createChild: vi.fn().mockReturnThis()
-});
+const createMockLogger = () => {
+  const logger = {
+    debug: vi.fn(),
+    silly: vi.fn(),
+    info: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    trackException: vi.fn(),
+    createChild: vi.fn(() => logger),
+    createFileOnlyChild: vi.fn(() => logger),
+    setLevel: vi.fn(),
+    getLevel: vi.fn(() => "debug"),
+    getLogFilePath: vi.fn(() => null),
+    destroy: vi.fn(async () => void 0)
+  };
+  return logger;
+};
+function createToolContext(logger, overrides = {}) {
+  return { logger, ...overrides };
+}
 describe("edit_file tool", () => {
   let mockLogger;
   let tempDir;
@@ -43,8 +56,43 @@ describe("edit_file tool", () => {
     }
   });
   describe("File Modification Detection", () => {
+    it("should generate preview for files outside config-allowed roots (preview read only)", async () => {
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
+      const rawExternalDir = await fs.mkdtemp(
+        path.join(os.tmpdir(), "dexto-edit-outside-allowed-")
+      );
+      const externalDir = await fs.realpath(rawExternalDir);
+      const externalFile = path.join(externalDir, "external.txt");
+      try {
+        await fs.writeFile(externalFile, "hello world");
+        const toolCallId = "preview-outside-roots";
+        const parsedInput = tool.inputSchema.parse({
+          file_path: externalFile,
+          old_string: "world",
+          new_string: "universe"
+        });
+        const preview = await previewFn(
+          parsedInput,
+          createToolContext(mockLogger, { toolCallId })
+        );
+        expect(preview).toBeDefined();
+        expect(preview?.type).toBe("diff");
+        if (preview?.type === "diff") {
+          expect(preview.title).toBe("Update file");
+          expect(preview.filename).toBe(externalFile);
+        } else {
+          expect.fail("Expected diff preview");
+        }
+      } finally {
+        await fs.rm(externalDir, { recursive: true, force: true });
+      }
+    });
     it("should succeed when file is not modified between preview and execute", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const toolCallId = "test-call-123";
@@ -53,16 +101,25 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      const preview = await tool.generatePreview(input, { toolCallId });
+      const parsedInput = tool.inputSchema.parse(input);
+      const preview = await previewFn(
+        parsedInput,
+        createToolContext(mockLogger, { toolCallId })
+      );
       expect(preview).toBeDefined();
-      const result = await tool.execute(input, { toolCallId });
+      const result = await tool.execute(
+        parsedInput,
+        createToolContext(mockLogger, { toolCallId })
+      );
       expect(result.success).toBe(true);
       expect(result.path).toBe(testFile);
       const content = await fs.readFile(testFile, "utf-8");
       expect(content).toBe("hello universe");
     });
     it("should fail when file is modified between preview and execute", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const toolCallId = "test-call-456";
@@ -71,11 +128,15 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      const preview = await tool.generatePreview(input, { toolCallId });
+      const parsedInput = tool.inputSchema.parse(input);
+      const preview = await previewFn(
+        parsedInput,
+        createToolContext(mockLogger, { toolCallId })
+      );
       expect(preview).toBeDefined();
       await fs.writeFile(testFile, "hello world - user added this");
       try {
-        await tool.execute(input, { toolCallId });
+        await tool.execute(parsedInput, createToolContext(mockLogger, { toolCallId }));
         expect.fail("Should have thrown an error");
       } catch (error) {
         expect(error).toBeInstanceOf(DextoRuntimeError);
@@ -87,7 +148,9 @@ describe("edit_file tool", () => {
       expect(content).toBe("hello world - user added this");
     });
     it("should detect file modification with correct error code", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const toolCallId = "test-call-789";
@@ -96,10 +159,11 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      await tool.generatePreview(input, { toolCallId });
+      const parsedInput = tool.inputSchema.parse(input);
+      await previewFn(parsedInput, createToolContext(mockLogger, { toolCallId }));
       await fs.writeFile(testFile, "hello world modified");
       try {
-        await tool.execute(input, { toolCallId });
+        await tool.execute(parsedInput, createToolContext(mockLogger, { toolCallId }));
         expect.fail("Should have thrown an error");
       } catch (error) {
         expect(error).toBeInstanceOf(DextoRuntimeError);
@@ -113,7 +177,9 @@ describe("edit_file tool", () => {
       }
     });
     it("should work without toolCallId (no modification check)", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const input = {
@@ -121,10 +187,11 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      await tool.generatePreview(input, {});
+      const parsedInput = tool.inputSchema.parse(input);
+      await previewFn(parsedInput, createToolContext(mockLogger));
       await fs.writeFile(testFile, "hello world changed");
       try {
-        await tool.execute(input, {});
+        await tool.execute(parsedInput, createToolContext(mockLogger));
       } catch (error) {
         expect(error).toBeInstanceOf(DextoRuntimeError);
         expect(error.code).not.toBe(
@@ -133,7 +200,9 @@ describe("edit_file tool", () => {
       }
     });
     it("should clean up hash cache after successful execution", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const toolCallId = "test-call-cleanup";
@@ -142,21 +211,28 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      await tool.generatePreview(input, { toolCallId });
-      await tool.execute(input, { toolCallId });
+      const parsedInput = tool.inputSchema.parse(input);
+      await previewFn(parsedInput, createToolContext(mockLogger, { toolCallId }));
+      await tool.execute(parsedInput, createToolContext(mockLogger, { toolCallId }));
       const input2 = {
         file_path: testFile,
         old_string: "universe",
         new_string: "galaxy"
       };
-      await tool.generatePreview(input2, { toolCallId });
-      const result = await tool.execute(input2, { toolCallId });
+      const parsedInput2 = tool.inputSchema.parse(input2);
+      await previewFn(parsedInput2, createToolContext(mockLogger, { toolCallId }));
+      const result = await tool.execute(
+        parsedInput2,
+        createToolContext(mockLogger, { toolCallId })
+      );
       expect(result.success).toBe(true);
       const content = await fs.readFile(testFile, "utf-8");
       expect(content).toBe("hello galaxy");
     });
     it("should clean up hash cache after failed execution", async () => {
-      const tool = createEditFileTool({ fileSystemService });
+      const tool = createEditFileTool(async () => fileSystemService);
+      const previewFn = tool.presentation?.preview;
+      expect(previewFn).toBeDefined();
       const testFile = path.join(tempDir, "test.txt");
       await fs.writeFile(testFile, "hello world");
       const toolCallId = "test-call-fail-cleanup";
@@ -165,15 +241,19 @@ describe("edit_file tool", () => {
         old_string: "world",
         new_string: "universe"
       };
-      await tool.generatePreview(input, { toolCallId });
+      const parsedInput = tool.inputSchema.parse(input);
+      await previewFn(parsedInput, createToolContext(mockLogger, { toolCallId }));
       await fs.writeFile(testFile, "hello world modified");
       try {
-        await tool.execute(input, { toolCallId });
+        await tool.execute(parsedInput, createToolContext(mockLogger, { toolCallId }));
       } catch {
       }
       await fs.writeFile(testFile, "hello world");
-      await tool.generatePreview(input, { toolCallId });
-      const result = await tool.execute(input, { toolCallId });
+      await previewFn(parsedInput, createToolContext(mockLogger, { toolCallId }));
+      const result = await tool.execute(
+        parsedInput,
+        createToolContext(mockLogger, { toolCallId })
+      );
       expect(result.success).toBe(true);
     });
   });

package/dist/error-codes.cjs

@@ -34,7 +34,11 @@ var FileSystemErrorCode = /* @__PURE__ */ ((FileSystemErrorCode2) => {
   FileSystemErrorCode2["FILE_TOO_LARGE"] = "FILESYSTEM_FILE_TOO_LARGE";
   FileSystemErrorCode2["TOO_MANY_RESULTS"] = "FILESYSTEM_TOO_MANY_RESULTS";
   FileSystemErrorCode2["READ_FAILED"] = "FILESYSTEM_READ_FAILED";
+  FileSystemErrorCode2["LIST_FAILED"] = "FILESYSTEM_LIST_FAILED";
   FileSystemErrorCode2["WRITE_FAILED"] = "FILESYSTEM_WRITE_FAILED";
+  FileSystemErrorCode2["CREATE_DIR_FAILED"] = "FILESYSTEM_CREATE_DIR_FAILED";
+  FileSystemErrorCode2["DELETE_FAILED"] = "FILESYSTEM_DELETE_FAILED";
+  FileSystemErrorCode2["RENAME_FAILED"] = "FILESYSTEM_RENAME_FAILED";
   FileSystemErrorCode2["BACKUP_FAILED"] = "FILESYSTEM_BACKUP_FAILED";
   FileSystemErrorCode2["EDIT_FAILED"] = "FILESYSTEM_EDIT_FAILED";
   FileSystemErrorCode2["STRING_NOT_UNIQUE"] = "FILESYSTEM_STRING_NOT_UNIQUE";

package/dist/error-codes.d.ts

@@ -3,7 +3,7 @@
  *
  * Standardized error codes for file system operations
  */
-declare enum FileSystemErrorCode {
+export declare enum FileSystemErrorCode {
     FILE_NOT_FOUND = "FILESYSTEM_FILE_NOT_FOUND",
     DIRECTORY_NOT_FOUND = "FILESYSTEM_DIRECTORY_NOT_FOUND",
     PERMISSION_DENIED = "FILESYSTEM_PERMISSION_DENIED",
@@ -16,7 +16,11 @@ declare enum FileSystemErrorCode {
     FILE_TOO_LARGE = "FILESYSTEM_FILE_TOO_LARGE",
     TOO_MANY_RESULTS = "FILESYSTEM_TOO_MANY_RESULTS",
     READ_FAILED = "FILESYSTEM_READ_FAILED",
+    LIST_FAILED = "FILESYSTEM_LIST_FAILED",
     WRITE_FAILED = "FILESYSTEM_WRITE_FAILED",
+    CREATE_DIR_FAILED = "FILESYSTEM_CREATE_DIR_FAILED",
+    DELETE_FAILED = "FILESYSTEM_DELETE_FAILED",
+    RENAME_FAILED = "FILESYSTEM_RENAME_FAILED",
     BACKUP_FAILED = "FILESYSTEM_BACKUP_FAILED",
     EDIT_FAILED = "FILESYSTEM_EDIT_FAILED",
     STRING_NOT_UNIQUE = "FILESYSTEM_STRING_NOT_UNIQUE",
@@ -28,5 +32,4 @@ declare enum FileSystemErrorCode {
     INVALID_CONFIG = "FILESYSTEM_INVALID_CONFIG",
     SERVICE_NOT_INITIALIZED = "FILESYSTEM_SERVICE_NOT_INITIALIZED"
 }
-
-export { FileSystemErrorCode };
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../src/error-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAY,mBAAmB;IAE3B,cAAc,8BAA8B;IAC5C,mBAAmB,mCAAmC;IAGtD,iBAAiB,iCAAiC;IAClD,gBAAgB,gCAAgC;IAChD,YAAY,4BAA4B;IAGxC,YAAY,4BAA4B;IACxC,uBAAuB,uCAAuC;IAC9D,sBAAsB,sCAAsC;IAC5D,gBAAgB,gCAAgC;IAGhD,cAAc,8BAA8B;IAC5C,gBAAgB,gCAAgC;IAGhD,WAAW,2BAA2B;IACtC,WAAW,2BAA2B;IACtC,YAAY,4BAA4B;IACxC,iBAAiB,iCAAiC;IAClD,aAAa,6BAA6B;IAC1C,aAAa,6BAA6B;IAC1C,aAAa,6BAA6B;IAC1C,WAAW,2BAA2B;IACtC,iBAAiB,iCAAiC;IAClD,gBAAgB,gCAAgC;IAGhD,WAAW,2BAA2B;IACtC,aAAa,6BAA6B;IAC1C,eAAe,+BAA+B;IAC9C,aAAa,6BAA6B;IAG1C,cAAc,8BAA8B;IAC5C,uBAAuB,uCAAuC;CACjE"}

package/dist/error-codes.js

@@ -11,7 +11,11 @@ var FileSystemErrorCode = /* @__PURE__ */ ((FileSystemErrorCode2) => {
   FileSystemErrorCode2["FILE_TOO_LARGE"] = "FILESYSTEM_FILE_TOO_LARGE";
   FileSystemErrorCode2["TOO_MANY_RESULTS"] = "FILESYSTEM_TOO_MANY_RESULTS";
   FileSystemErrorCode2["READ_FAILED"] = "FILESYSTEM_READ_FAILED";
+  FileSystemErrorCode2["LIST_FAILED"] = "FILESYSTEM_LIST_FAILED";
   FileSystemErrorCode2["WRITE_FAILED"] = "FILESYSTEM_WRITE_FAILED";
+  FileSystemErrorCode2["CREATE_DIR_FAILED"] = "FILESYSTEM_CREATE_DIR_FAILED";
+  FileSystemErrorCode2["DELETE_FAILED"] = "FILESYSTEM_DELETE_FAILED";
+  FileSystemErrorCode2["RENAME_FAILED"] = "FILESYSTEM_RENAME_FAILED";
   FileSystemErrorCode2["BACKUP_FAILED"] = "FILESYSTEM_BACKUP_FAILED";
   FileSystemErrorCode2["EDIT_FAILED"] = "FILESYSTEM_EDIT_FAILED";
   FileSystemErrorCode2["STRING_NOT_UNIQUE"] = "FILESYSTEM_STRING_NOT_UNIQUE";

package/dist/errors.cjs

@@ -161,6 +161,54 @@ class FileSystemError {
       { path, cause }
     );
   }
+  /**
+   * List directory operation failed
+   */
+  static listFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.LIST_FAILED,
+      FILESYSTEM_SCOPE,
+      import_core.ErrorType.SYSTEM,
+      `Failed to list directory: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Create directory operation failed
+   */
+  static createDirFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.CREATE_DIR_FAILED,
+      FILESYSTEM_SCOPE,
+      import_core.ErrorType.SYSTEM,
+      `Failed to create directory: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Delete operation failed
+   */
+  static deleteFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.DELETE_FAILED,
+      FILESYSTEM_SCOPE,
+      import_core.ErrorType.SYSTEM,
+      `Failed to delete path: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Rename operation failed
+   */
+  static renameFailed(path, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.FileSystemErrorCode.RENAME_FAILED,
+      FILESYSTEM_SCOPE,
+      import_core.ErrorType.SYSTEM,
+      `Failed to rename path: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
   /**
    * Write operation failed
    */

package/dist/errors.d.ts

@@ -1,12 +1,10 @@
-import { DextoRuntimeError } from '@dexto/core';
-
 /**
  * FileSystem Service Errors
  *
  * Error classes for file system operations
  */
-
-interface FileSystemErrorContext {
+import { DextoRuntimeError } from '@dexto/core';
+export interface FileSystemErrorContext {
     path?: string;
     pattern?: string;
     size?: number;
@@ -17,7 +15,7 @@ interface FileSystemErrorContext {
 /**
  * Factory class for creating FileSystem-related errors
  */
-declare class FileSystemError {
+export declare class FileSystemError {
     private constructor();
     /**
      * File not found error
@@ -63,6 +61,22 @@ declare class FileSystemError {
      * Read operation failed
      */
     static readFailed(path: string, cause: string): DextoRuntimeError;
+    /**
+     * List directory operation failed
+     */
+    static listFailed(path: string, cause: string): DextoRuntimeError;
+    /**
+     * Create directory operation failed
+     */
+    static createDirFailed(path: string, cause: string): DextoRuntimeError;
+    /**
+     * Delete operation failed
+     */
+    static deleteFailed(path: string, cause: string): DextoRuntimeError;
+    /**
+     * Rename operation failed
+     */
+    static renameFailed(path: string, cause: string): DextoRuntimeError;
     /**
      * Write operation failed
      */
@@ -108,5 +122,4 @@ declare class FileSystemError {
      */
     static notInitialized(): DextoRuntimeError;
 }
-
-export { FileSystemError, type FileSystemErrorContext };
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -138,6 +138,54 @@ class FileSystemError {
       { path, cause }
     );
   }
+  /**
+   * List directory operation failed
+   */
+  static listFailed(path, cause) {
+    return new DextoRuntimeError(
+      FileSystemErrorCode.LIST_FAILED,
+      FILESYSTEM_SCOPE,
+      ErrorType.SYSTEM,
+      `Failed to list directory: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Create directory operation failed
+   */
+  static createDirFailed(path, cause) {
+    return new DextoRuntimeError(
+      FileSystemErrorCode.CREATE_DIR_FAILED,
+      FILESYSTEM_SCOPE,
+      ErrorType.SYSTEM,
+      `Failed to create directory: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Delete operation failed
+   */
+  static deleteFailed(path, cause) {
+    return new DextoRuntimeError(
+      FileSystemErrorCode.DELETE_FAILED,
+      FILESYSTEM_SCOPE,
+      ErrorType.SYSTEM,
+      `Failed to delete path: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
+  /**
+   * Rename operation failed
+   */
+  static renameFailed(path, cause) {
+    return new DextoRuntimeError(
+      FileSystemErrorCode.RENAME_FAILED,
+      FILESYSTEM_SCOPE,
+      ErrorType.SYSTEM,
+      `Failed to rename path: ${path}. ${cause}`,
+      { path, cause }
+    );
+  }
   /**
    * Write operation failed
    */

package/dist/file-tool-types.d.ts

@@ -1,46 +1,14 @@
-import { FileSystemService } from './filesystem-service.js';
-import '@dexto/core';
-import './types.js';
-
 /**
  * File Tool Types
  *
- * Types shared between file tools for directory approval support.
+ * Types shared between file tools and factories.
  */
-
+import type { ToolExecutionContext } from '@dexto/core';
+import type { FileSystemService } from './filesystem-service.js';
 /**
- * Callbacks for directory access approval.
- * Allows file tools to check and request approval for accessing paths
- * outside the configured working directory.
+ * Getter for a lazily-initialized {@link FileSystemService}.
+ * Tool factories construct tools before runtime services are available, so tools
+ * resolve the service on-demand using {@link ToolExecutionContext}.
  */
-interface DirectoryApprovalCallbacks {
-    /**
-     * Check if a path is within any session-approved directory.
-     * Used to determine if directory approval prompt is needed.
-     * @param filePath The file path to check (absolute or relative)
-     * @returns true if path is in a session-approved directory
-     */
-    isSessionApproved: (filePath: string) => boolean;
-    /**
-     * Add a directory to the approved list for this session.
-     * Called after user approves directory access.
-     * @param directory Absolute path to the directory to approve
-     * @param type 'session' (remembered) or 'once' (single use)
-     */
-    addApproved: (directory: string, type: 'session' | 'once') => void;
-}
-/**
- * Options for creating file tools with directory approval support
- */
-interface FileToolOptions {
-    /** FileSystemService instance for file operations */
-    fileSystemService: FileSystemService;
-    /**
-     * Optional callbacks for directory approval.
-     * If provided, file tools can request approval for accessing paths
-     * outside the configured working directory.
-     */
-    directoryApproval?: DirectoryApprovalCallbacks | undefined;
-}
-
-export type { DirectoryApprovalCallbacks, FileToolOptions };
+export type FileSystemServiceGetter = (context: ToolExecutionContext) => Promise<FileSystemService>;
+//# sourceMappingURL=file-tool-types.d.ts.map

package/dist/file-tool-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-types.d.ts","sourceRoot":"","sources":["../src/file-tool-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC"}